Expedia

Destination Lookup API

GET https://api.stayapi.com/v1/expedia/destinations/lookup

Parameters

Required query, trimmed 1–200 characters.

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

Response scope

Returns query, count, destinations. Destination records contain region_id, entity_type, name, location, latitude, longitude; coordinates may be null. Preserve long region IDs as strings.

Use returned region_id with Expedia search or property-name lookup, then pass the selected property_id to 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/destinations/lookup?query=Rovaniemi' -H 'X-API-Key: YOUR_API_KEY'

{
  "query": "Rovaniemi",
  "count": 1,
  "destinations": [
    {
      "region_id": "3059",
      "entity_type": "CITY",
      "name": "Rovaniemi",
      "location": "Finland",
      "latitude": null,
      "longitude": null
    }
  ]
}