Vrbo
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 | Default: USD. Only USD is accepted, including case/whitespace-normalized USD. |
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 and listing_id. Use internal property_id for reviews; public listing_id belongs in the Vrbo URL and may end in ha. Prices are omitted: to price a listing, pass its property_id to Expedia Hotel Rates with your dates and use the rate plan's total price, which can include rental fees. Discovery does not confirm availability. Continue only with the returned next_offset/next_limit pair; nullable continuation does not claim exhaustive inventory.
Vrbo native property-name lookup is not available. 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.