# Vrbo Listing API Documentation

<p>Get one Vrbo property by its property_id. The response has the name, address, coordinates, bedrooms, bathrooms, sleeps, rating on the Vrbo scale of 10 with category scores, grouped amenities, the description, host information when Vrbo shows it, house rules, important information, price per unit for the stay dates, all photos and the first 10 guest reviews. Prices include all fees. Vrbo shows no fee line items.</p>

- **Documentation:** [https://scrappa.co/docs/vrbo-api/vrbo_listing](https://scrappa.co/docs/vrbo-api/vrbo_listing)
- **API group:** Vrbo API
- **Endpoint:** `GET https://scrappa.co/api/vrbo/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `property_id` | string | Yes | Numeric property_id from /api/vrbo/search. Example: 124807895. |
| `check_in` | string | No | Check-in date, YYYY-MM-DD. Default: 30 days from today. |
| `check_out` | string | No | Check-out date, YYYY-MM-DD. Default: 3 nights after check-in. |
| `adults` | integer | No | Number of adults, 1-20. Default: 2. |
| `children` | string | No | Comma separated child ages, up to 8. Example: 5,9. |

## Example response

```json
{
    "data": {
        "url": "https://www.vrbo.com/124807895",
        "name": "Corner Penthouse with Sunset Views, Pool & Gym in Miami Downtown",
        "images": [
            {
                "url": "https://media.vrbo.com/lodging/125000000/124810000/124807900/124807895/67691906.jpg",
                "caption": "Pool"
            }
        ],
        "offers": {
            "units": [
                {
                    "unit_id": "124807895",
                    "features": [
                        "Sleeps 6",
                        "Free WiFi"
                    ],
                    "rate_plans": [
                        {
                            "total": 1450.53,
                            "currency": "USD",
                            "total_formatted": "$1,451"
                        }
                    ]
                }
            ],
            "available": true,
            "fees_note": "Prices include all fees. Vrbo does not show fee line items."
        },
        "rating": {
            "label": "Wonderful",
            "scale": 10,
            "score": 9.2,
            "categories": [
                {
                    "label": "Cleanliness",
                    "score": 8.8
                }
            ],
            "review_count": 12
        },
        "sleeps": 6,
        "address": {
            "city": "Miami",
            "region": "FL",
            "country_code_iso3": "USA"
        },
        "reviews": {
            "items": [
                {
                    "date": "Jul 17, 2026",
                    "stay": "Stayed 2 nights in Jul 2026",
                    "text": "Spectacular view and location",
                    "label": "Excellent",
                    "scale": 10,
                    "score": 10,
                    "review_id": "6a5aac16c834c10b8b12610a"
                }
            ],
            "total": 12
        },
        "bedrooms": 2,
        "latitude": 25.780149,
        "bathrooms": 2,
        "longitude": -80.191522,
        "image_count": 99,
        "property_id": "124807895",
        "amenity_groups": [
            {
                "group": "Kitchen",
                "items": [
                    "Refrigerator",
                    "Microwave"
                ]
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "property_detail"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Vrbo has no property for this property_id. This response is not billable. |
| 422 | Validation Error | A parameter is missing or invalid. No upstream request is made. This response is not billable. |
| 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. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
