Vrbo

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/vrbo/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 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.

Browse documentation