# Vrbo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse vacation rental listings on Vrbo by location, date range, and guest count. Retrieve detailed information about specific properties including descriptions, amenities, photos, pricing, guest reviews, and availability — everything needed to compare rental options in one place.

**Category:** Travel | **Website:** [vrbo.com/](https://vrbo.com/) | **Docs:** [parse.bot/marketplace/201dc934-8e7d-4987-8593-40db0ce90a48/vrbo-com-api](https://parse.bot/marketplace/201dc934-8e7d-4987-8593-40db0ce90a48/vrbo-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-vrbo-com-api-201dc934/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_property_details

Retrieve details for a specific Vrbo property listing including name, description, location, property specs, amenities, and image. Property IDs are numeric strings found in search_listings results[*].property_id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `property_id` | string | Yes | Vrbo property ID (numeric string from the property URL path, e.g. '4425323' from search_listings results[*].property_id) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vrbo-com-api-201dc934/get_property_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"property_id":"<string>"}'
```

### search_listings

Search for vacation rental listings by location. Returns properties with titles, prices, thumbnails, and listing URLs. Supports optional date filtering and guest count. Results are sorted by Vrbo's recommended algorithm. Each page returns up to ~50 listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adult guests |
| `checkin` | string | No | Check-in date in YYYY-MM-DD format |
| `checkout` | string | No | Check-out date in YYYY-MM-DD format |
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Location to search for (e.g., 'Miami', 'New York', 'Los Angeles') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vrbo-com-api-201dc934/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","checkin":"<string>","checkout":"<string>","page":"<integer>","query":"<string>"}'
```