Expedia

GET

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

GET https://api.stayapi.com/v1/expedia/search

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.

Browse documentation