Amadeus Hotels Skill 🏨

Search hotel prices, availability, and ratings via the Amadeus Self-Service API. Perfect for vacation planning and deal hunting.

Setup

1. 1. Get API credentials at https://developers.amadeus.com/self-service

- Create account → My Apps → Create new app - Copy API Key and API Secret

1. 2. Set environment variables:

CODEBLOCK0

1. 3. Install dependency:

CODEBLOCK1

Free tier: ~2,000 requests/month in test, pay-per-use after in production.

Quick Reference

Task	Script	Example
Search by city	INLINECODE0	INLINECODE1
Get offers

scripts/offers.py | --hotels HTPAR123,HTPAR456 --adults 2 | | Offer details | scripts/details.py | --offer-id ABC123 | | Track price | scripts/track.py | --add --hotel HTPAR123 --target 150 | | Check tracked | scripts/track.py | --check |

Capabilities

1. Hotel Search

Find hotels by city code (IATA) or coordinates:

CODEBLOCK2

Common city codes: PAR (Paris), NYC (New York), TYO (Tokyo), BCN (Barcelona), LON (London), LAX (Los Angeles), SFO (San Francisco)

2. Get Pricing & Availability

Once you have hotel IDs from search:

CODEBLOCK3

Returns: Room types, prices, cancellation policies, board types.

3. Offer Details

Get full details for a specific offer before booking:

CODEBLOCK4

Returns: Detailed room info, full cancellation policy, payment terms, hotel contact.

4. Hotel Ratings & Sentiment

Get aggregated review sentiment:

CODEBLOCK5

Returns: Overall score (0-100), category scores (Staff, Location, WiFi, Cleanliness, etc.)

5. Price Tracking

Track hotels and get alerts when prices drop:

CODEBLOCK6

Cron Setup for Price Alerts

Add to OpenClaw cron for automatic price monitoring:

CODEBLOCK7

When prices drop below target, the script outputs alert text. Configure your notification channel in the cron task.

Output Formatting

Scripts output JSON by default. Add --format human for readable output:

CODEBLOCK8

Human format example:
CODEBLOCK9

Amenity Codes

Common filters for --amenities:

Code	Meaning
WIFI	Free WiFi
POOL

Swimming pool |
| SPA | Spa/wellness |
| GYM | Fitness center |
| RESTAURANT | On-site restaurant |
| PARKING | Parking available |
| PETS_ALLOWED | Pet-friendly |
| AIR_CONDITIONING | A/C |
| KITCHEN | Kitchen/kitchenette |

Full list in references/amenities.md.

⚠️ Important: Pricing Disclaimer

Amadeus API prices are NOT retail prices. The API returns negotiated, net, or wholesale rates — not the public prices you see on Booking.com, Expedia, or hotel websites.

Key differences:

• - Net vs Retail: API returns "net rates" (raw cost), not marked-up retail prices
• B2B Pricing: Designed for travel agencies/developers to add their own markup
• Negotiated Rates: May include corporate or consortia rates unavailable to consumers
• Tax Breakdown: Prices often show base + taxes separately

Use these prices for comparison and tracking trends, not as exact retail quotes. Actual booking prices on consumer sites will differ.

Limitations & Notes

• - Test environment: Limited/cached data, not real-time. Good for development.
• Production: Real prices but requires "Move to Production" in Amadeus dashboard.
• No direct booking: API returns offer details; actual booking requires payment handling (PCI compliance).
• Rate limits: 10 TPS (test), 40 TPS (production). Scripts include backoff.
• Data freshness: Prices change frequently. Always re-check before booking elsewhere.
• Not retail prices: See pricing disclaimer above.

Error Handling

Error	Meaning	Action
401	Auth failed	Check API key/secret
429

Rate limited | Wait and retry (auto-handled) | | 400 | Bad request | Check parameters (dates, codes) | | No results | No availability | Try different dates or expand search |

References

• - references/amenities.md — Full amenity code list
• https://developers.amadeus.com/self-service/apis-docs — Official API docs