---
title: "Search Vrbo vacation rentals"
method: POST
path: "/vrbo/search"
tags: ["Vrbo"]
---

# Search Vrbo vacation rentals

`POST /vrbo/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/vrbo/search`
- Auth: API key in header `x-api-key`

Searches public Vrbo rental listings for a selected destination and dates. Obtain destination, region_id, and lat_long from Vrbo's destination suggestion UI. Supports date flexibility, per-room adult and child-age inputs, current filter selections and ranges, and observed sort values. Copy filter IDs and option values from the returned filters.

## Headers

- `x-api-key` string, required

## Request body

- VrboSearchOption
  - `adults` integer
  - `check_in` string, required
  - `check_out` string, required
  - `child_ages` integer[]: ChildAges contains ages 2–17 for children in the default single room.
  - `destination` string, required
  - `filter_ranges` VrboSearchFilterRangeSelection[]: Ranges applies numeric ranges by their live nested facet ID.
    - `id` string
    - `max` number
    - `min` number
  - `filters` VrboSearchFilterSelection[]: Filters are selections copied from the live facet metadata in a search response.
    - `id` string
    - `values` string[]
  - `flexibility` string
  - `lat_long` string, required
  - `limit` integer
  - `region_id` string, required
  - `rooms` VrboSearchRoom[]: Rooms overrides Adults and ChildAges and supports multi-room searches.
    - `adults` integer
    - `child_ages` integer[]
  - `sort` 'RECOMMENDED' | 'PRICE_LOW_TO_HIGH' | 'PRICE_HIGH_TO_LOW' | 'REVIEW' | 'REVIEW_COUNT'

## Response `200`

OK

- VrboVrboSearchResponseDoc
  - `code` integer
  - `data` VrboSearchResponse
    - `check_in` string
    - `check_out` string
    - `destination` string
    - `filters` VrboSearchFilterGroup[]
      - `control_type` string
      - `id` string
      - `label` string
      - `options` VrboSearchFilterOption[]
        - `disabled` boolean
        - `id` string
        - `label` string
        - `result_count` integer
        - `selected` boolean
        - `value` string
      - `range` VrboSearchFilterRange
        - `id` string
        - `max` number
        - `max_label` string
        - `min` number
        - `min_label` string
        - `number_format` string
        - `selected_max` number
        - `selected_min` number
        - `step` number
      - `ranges` VrboSearchFilterRange[]: Ranges lists every range option nested under a range control. Range remains the first option for compatibility with the original response.
        - `id` string
        - `max` number
        - `max_label` string
        - `min` number
        - `min_label` string
        - `number_format` string
        - `selected_max` number
        - `selected_min` number
        - `step` number
      - `section` string
      - `step_input` VrboSearchFilterStep
        - `current` integer
        - `default` integer
        - `label` string
        - `max` integer
        - `min` integer
        - `step` integer
    - `region_id` string
    - `results` VrboListing[]
      - `bedrooms` integer
      - `currency` string
      - `description` string
      - `id` string
      - `image_url` string
      - `name` string
      - `price` number
      - `property_type` string
      - `rating` number
      - `review_count` integer
      - `url` string
    - `rooms` VrboSearchRoom[]
      - `adults` integer
      - `child_ages` integer[]
    - `sort_options` VrboSearchSortOption[]
      - `default` boolean
      - `id` string
      - `label` string
      - `selected` boolean
      - `value` string
    - `total_results` integer

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)