Expedia
Destination Search API
Copy for your AI agent
Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.
Overview
Authenticate with X-API-Key. One successful call consumes one credit.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| region_id | string | Required | Numeric string, up to 30 digits. |
| check_in | date | Required | Strict YYYY-MM-DD. |
| check_out | date | Required | Strict YYYY-MM-DD, checkout after check-in. |
| adults | integer | Optional | 1–8. Default: 2. |
| offset | integer | Optional | 0–1000. Default: 0. |
| limit | integer | Optional | 1–10. Default: 10. |
| currency | string | Optional | Supported currencies: USD, EUR, GBP, AUD, CAD, JPY, THB, SGD, HKD, INR, NZD, BRL, MXN, CHF, DKK, NOK, SEK, KRW, MYR, IDR, PHP, SAR, TWD, VND, AED, PEN, CLP, COP, EGP, ARS, CNY, ISK and ZAR. Default: USD. Whitespace is trimmed and letters are uppercased. |
| stars | string | Optional | Comma-separated star ratings 1–5, e.g. 4,5. Each level includes its half-star (4 includes 4.5). |
| min_guest_rating | integer | Optional | 7, 8 or 9 on a 10-point scale. Properties rated at least this. |
| sort | string | Optional | recommended (default), price_low_to_high, price_high_to_low, star_rating or guest_rating (highest first). |
| free_cancellation | boolean | Optional | Default: false. Only properties with a free-cancellation price. |
| amenities | string | Optional | Comma-separated pool, free_parking, free_breakfast, pets. Properties must offer every listed amenity. |
Other filter values return 400. Resend the same filters with next_offset; if a requested filter cannot be confirmed as applied, the search returns 502 rather than unfiltered results.
Response scope
Returns region_id, region_name, check_in, check_out, adults, currency, offset, limit, sort, stars, min_guest_rating, free_cancellation, amenities, count, properties, next_offset, next_limit and availability_verified: false. Each primary card has property_id, name, canonical_url and a nullable price. Prices are native regional quotes and can vary by market, not a fixed exchange-rate conversion. Property and room text may be localized for that market. Canonical URLs use the corresponding regional Expedia site. Discovery does not confirm availability. Continue only with the returned next_offset/next_limit pair; nullable continuation does not claim exhaustive inventory.
price contains the search result prices for your dates and adults: total is the whole stay in the requested currency and includes taxes and fees; currency identifies that currency; per_night is the displayed nightly price; its tax basis depends on the market; total_before_discount is the struck-through whole-stay price when available; a nightly-only discount does not populate this field. per_night and total_before_discount are null when not shown, and price is null when no price in the requested currency is available (for example, sold out). Displayed nightly amounts can be rounded. Compare stays with total; do not multiply per_night by nights. It is a search-result price, not a bookable offer: use Expedia Hotel Rates for bookable room offers. With free_cancellation or amenities, price reflects the matching rate, such as the refundable or breakfast-included price. Unpriced properties (price: null), including sold-out stays, can follow the available results and are not guaranteed to match every filter.
The filter fields echo what was applied: sort, stars (sorted, [] when unset), min_guest_rating (null when unset), free_cancellation and amenities ([] when unset).
Use returned property IDs with Expedia reviews or rates. REST only; no MCP tool.
Errors
Unsupported currency codes return 400 Problem Details. Other invalid requests return 400 or 422 Problem Details. Upstream failures return 502, 503, or 504. Respect Retry-After when supplied; do not treat an error as empty results.