Expedia

Destination Search API

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

Parameters

Required region_id (numeric string, up to 30 digits), check_in and check_out (strict YYYY-MM-DD, checkout after check-in). Optional adults=2 (1–8), offset=0 (0–1000), limit=10 (1–10), currency=USD. Only USD is accepted, including case/whitespace-normalized USD.

Authenticate with X-API-Key. One successful call consumes one credit.

Response scope

Returns region_id, region_name, check_in, check_out, adults, currency, offset, limit, count, properties, next_offset, next_limit and availability_verified: false. Each primary card has property_id, name, canonical_url. Prices are omitted. Discovery does not confirm availability. Continue only with the returned next_offset/next_limit pair; nullable continuation does not claim exhaustive inventory.

Use returned property IDs with Expedia reviews or rates. REST only; no MCP tool.

Errors

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.

Example

curl 'https://api.stayapi.com/v1/expedia/search?region_id=3059&check_in=2027-02-10&check_out=2027-02-12' -H 'X-API-Key: YOUR_API_KEY'

{
  "region_id": "3059",
  "region_name": "Rovaniemi",
  "check_in": "2027-02-10",
  "check_out": "2027-02-12",
  "adults": 2,
  "currency": "USD",
  "offset": 0,
  "limit": 10,
  "count": 1,
  "availability_verified": false,
  "properties": [
    {
      "property_id": "525650",
      "name": "Scandic Rovaniemi City",
      "canonical_url": "https://www.expedia.com/Rovaniemi-Hotels-Scandic-Rovaniemi-City.h525650.Hotel-Information"
    }
  ],
  "next_offset": null,
  "next_limit": null
}