Skip to content
Scrappa Get API key
Vrbo API 1 credit/request

Vrbo Search API Documentation

GET https://scrappa.co/api/vrbo/search

Search Vrbo rentals for a stay. Send a destination name, a region_id or a map area, plus dates and guests. Filter by price, bedrooms, bathrooms, beds, property type, amenities, location, house rules and more. Each property has the id, name, link, type, bedrooms, beds, rating on the Vrbo scale of 10, review count, nightly price, stay total, images and area. Prices include all fees. The price is empty when Vrbo shows no price for the dates. Pages are offset based.

Vrbo Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/vrbo/search
Auth header
x-api-key
Cost
1 credit/request
check_in = example check_out = example
Response preview
200 OK
{
    "data": {
        "sort": "price_low_to_high",
        "limit": 1,
        "adults": 2,
        "offset": 0,
        "check_in": "2026-12-12",
        "children": [],
        "has_more": true,
        "check_out": "2026-12-15",
        "properties": [
            {
                "url": "https://www.vrbo.com/5038036",
                "area": "Within Downtown Miami",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

2 required parameters needed before sending a request.

37 optional filters available.

check_in string Required

Check-in date, YYYY-MM-DD. Example: 2026-12-12.

Example value example
check_out string Required

Check-out date, YYYY-MM-DD, at most 28 nights after check-in. Example: 2026-12-15.

Example value example
destination string Optional

Place name. Vrbo picks the best match. Use region_id for an exact place. If you send both, take both from the same /api/vrbo/destinations result. Example: Miami.

Example value example
region_id string Optional

Numeric region_id from /api/vrbo/destinations. Example: 2297.

Example value 1234567890
map_bounds string Optional

Map area as south,west,north,east in decimal degrees. Example: 25.70,-80.30,25.80,-80.10.

Example value example
adults integer Optional

Number of adults, 1-20. Default: 2.

Example value 10
children string Optional

Comma separated child ages, up to 8. Example: 5,9.

Example value example
sort string Optional

recommended, price_low_to_high, price_high_to_low, review or review_count. Default: recommended.

Example value relevance
min_price integer Optional

Lowest price in USD, per night or for the stay (see price_type). Example: 100.

Example value 10
max_price integer Optional

Highest price in USD. Example: 500.

Example value 10
price_type string Optional

nightly or total. Default: nightly.

Example value example
bedrooms integer Optional

Minimum bedrooms, 0-50. Example: 3.

Example value 10
bathrooms integer Optional

Minimum bathrooms, 1-50.

Example value 10
beds integer Optional

Minimum beds, 1-20.

Example value 10
property_type string Optional

Comma separated types such as house, villa, apartment_or_condo, cabin, resort. See /api/vrbo/filters.

Example value example
amenities string Optional

Comma separated amenities such as pool, hot_tub, air_conditioning. See /api/vrbo/filters.

Example value example
location string Optional

Comma separated values. Location type such as oceanfront, waterfront, lake_location, golf_course.

Example value Austin, Texas
house_rules string Optional

Comma separated values. Rules such as pets_allowed, children_allowed, smoking_allowed.

Example value example
guest_rating string Optional

Comma separated values. Guest rating such as 45_stars (9+), 4_stars (8+), 35_stars (7+), loved_by_guests.

Example value example
good_for string Optional

Comma separated values. Properties good for families, location or cleanliness.

Example value example
common_spaces string Optional

Comma separated values. Spaces such as kitchen, dining_room, living_room, outdoor_space.

Example value example
accessibility string Optional

Comma separated values. Accessibility features such as elevator, wheelchair_accessible, entrance_ramp.

Example value example
nearby_activities string Optional

Comma separated values. Activities such as hiking, cycling, theme_parks, wineries_or_breweries.

Example value example
safety string Optional

Comma separated values. Safety features: carbon_monoxide_detector, smoke_detector.

Example value example
booking_options string Optional

Comma separated values. Options such as instant_confirmation, reserve_now_pay_later.

Example value example
discounts string Optional

Comma separated values. Discounts such as weekly_discount, monthly_discount, early_booking, last_minute.

Example value example
free_cancellation string Optional

Comma separated values. Free cancellation options from /api/vrbo/filters.

Example value example
beach_access string Optional

Comma separated values. Beach access options from /api/vrbo/filters.

Example value example
neighborhood string Optional

Comma separated values. Numeric neighborhood ids from /api/vrbo/filters.

Example value example
premier_host boolean Optional

Only Premier Hosts when true.

Example value true
virtual_tour boolean Optional

Only properties with a virtual tour when true.

Example value true
king_beds integer Optional

Minimum number of king beds, 0-20.

Example value 10
queen_beds integer Optional

Minimum number of queen beds, 0-20.

Example value 10
full_beds integer Optional

Minimum number of full beds, 0-20.

Example value 10
twin_beds integer Optional

Minimum number of twin beds, 0-20.

Example value 10
bunk_beds integer Optional

Minimum number of bunk beds, 0-20.

Example value 10
limit integer Optional

Properties per page, 1-50. Default: 20.

Example value 10
offset integer Optional

Start position for the next page. Use next_offset from the last response. Default: 0.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "sort": "price_low_to_high",
        "limit": 1,
        "adults": 2,
        "offset": 0,
        "check_in": "2026-12-12",
        "children": [],
        "has_more": true,
        "check_out": "2026-12-15",
        "properties": [
            {
                "url": "https://www.vrbo.com/5038036",
                "area": "Within Downtown Miami",
                "beds": 3,
                "name": "Corner Penthouse with Sunset Views, Pool & Gym in Miami Downtown",
                "price": {
                    "nights": 3,
                    "nightly": 433,
                    "currency": "USD",
                    "fees_note": "All fees included",
                    "stay_total": 1300,
                    "stay_total_text": "$1,300 for 3 nights",
                    "nightly_original": 471,
                    "nightly_formatted": "$433"
                },
                "rating": 9.2,
                "bedrooms": 2,
                "overview": "Apartment \u00b7 2 bedrooms \u00b7 3 beds",
                "image_urls": [
                    "https://media.vrbo.com/lodging/125000000/124810000/124807900/124807895/67691906.jpg"
                ],
                "listing_id": "5038036",
                "image_count": 1,
                "property_id": "124807895",
                "rating_label": "Wonderful",
                "rating_scale": 10,
                "review_count": 12,
                "property_type": "Apartment"
            }
        ],
        "destination": "Miami",
        "next_offset": 20,
        "total_results": 398,
        "pagination_label": "1 - 50 of 300+"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "rental_search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

404

Not Found

Vrbo has no property for this property_id. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested Vrbo property was not found."
    },
    "success": false
}
422

Validation Error

A parameter is missing or invalid. No upstream request is made. This response is not billable.

{
    "errors": {
        "check_in": [
            "The check in field is required."
        ]
    },
    "message": "The request validation failed"
}
503

Vrbo Temporarily Unavailable

Vrbo did not answer in time or the request was blocked. Retry after a short pause. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Vrbo is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.