# Vrbo search: `POST /v1/ota/vrbo/search`

Cost: 2 credits (2 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/vrbo-search

Search Vrbo by destination and dates.

Returns Vrbo's recommended listings with the numeric `property_id` that
`POST /v1/ota/vrbo` quotes, the listing id and URL, and Vrbo's own nightly
and stay prices. Page past the first 50 with `offset` (`limit=50,
offset=50` is page two).

Request body (JSON):

- `destination` (string; required; min length 2): Place as a guest would type it, e.g. `South Lake Tahoe, California`. Vrbo resolves it to a region.
- `check_in` (string (date); required): First night of the stay, `YYYY-MM-DD`. Also accepted as `check_in_date`.
- `check_out` (string (date) | null; optional): Departure date. An alternative to `nights` — if both are given, this wins. Also accepted as `check_out_date`.
- `nights` (integer; optional; default 1; min 1, max 28): Length of stay. Ignored when `check_out` is supplied.
- `adults` (integer; optional; default 2; min 1, max 16): Guests (adults).
- `limit` (integer; optional; default 20; min 1, max 50): Maximum listings to return, in Vrbo's recommended order.
- `offset` (integer; optional; default 0; min 0, max 1000): Listings to skip, for paging past the first 50: `limit=50, offset=50` is the second page. Each page is its own request.
- `market` (string; optional; default US; one of US): Vrbo point-of-sale. Only `US` (www.vrbo.com, USD) is verified.

Response fields:

- `search_parameters` (object; required)
  - `search_parameters.engine` (string; required; one of vrbo_search)
  - `search_parameters.destination` (string; required)
  - `search_parameters.check_in_date` (string (date); required)
  - `search_parameters.check_out_date` (string (date); required)
  - `search_parameters.adults` (integer; required)
  - `search_parameters.market` (string; required): `US`.
  - `search_parameters.currency` (string; required): The market's currency (`USD`).
  - `search_parameters.limit` (integer; required)
- `summary` (object; required)
  - `summary.matched_properties` (integer | null; required): Total listings Vrbo matched for the destination and dates.
  - `summary.results_heading` (string | null; required): Vrbo's heading, e.g. `Search results showing 359 properties in ...`.
- `listings` (array of object; required): At most `limit` listings, in Vrbo's recommended order; sponsored placements are skipped.
  - `listings[].property_id` (string; required): Numeric Vrbo property id; pass as `property_id` to `POST /v1/ota/vrbo`.
  - `listings[].listing_id` (string; required): Id in the listing's Vrbo URL, e.g. `20218736ha`; empty when the card carried no listing link.
  - `listings[].name` (string; required)
  - `listings[].summary` (string; required): Card details joined with ` · `, e.g. `House · 4 bedrooms · 4 Queen Beds`.
  - `listings[].url` (string; required): `https://www.vrbo.com/<listing_id>`; empty when `listing_id` is empty.
  - `listings[].nightly` (number | null; required): Vrbo's nightly price, to the cent. Null when the card's price carried no recognised label.
  - `listings[].total` (number | null; required): Stay total for all nights; null when the card did not state one.
  - `listings[].currency` (string; required)
  - `listings[].nightly_text` (string; required): As displayed, e.g. `$462`.
  - `listings[].total_text` (string; required): As displayed, e.g. `$1,386 for 3 nights`.
  - `listings[].fees_included` (boolean | null; required): True when Vrbo labels the price "All fees included"; null when no such label was shown.
  - `listings[].taxes_and_fees_included` (boolean | null; required): True when labelled as including taxes and fees; null when no such label was shown.
  - `listings[].rank` (integer; required): 0-based position in Vrbo's recommended order.
  - `listings[].provenance` (object; required): Where, when and how one normalized price was observed.
- `meta` (object; required)
  - `meta.source` (string; required; one of vrbo)
  - `meta.listings` (integer; required)
  - `meta.collection_id` (string; required)
  - `meta.observed_at` (string; required)
  - `meta.elapsed_s` (number; required)

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
