Expedia

GET

Property Name Lookup 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/hotel/lookup

Parameters

Parameter Type Required Description
query string Required Trimmed 1–200 characters.
region_id string Required A numeric string up to 30 digits from destination lookup.

Response scope

Returns query, region_id, count, availability_verified: false, properties. Each suggestion contains property_id, name, location, latitude, longitude; coordinates may be null. These are dateless native property-name suggestions using region context, not verified geographic containment, exact matches or bookable availability.

When no suggestions match, HTTP 200 returns count: 0 and properties: [], with the requested query and region_id and availability_verified: false. An empty result is a successful lookup.

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.

Browse documentation