Vrbo API endpoint
Returns public destination suggestions, including region IDs and location types when Vrbo provides them. The verified search term is sent with Vrbo's observed lodging, destination, and entry-page criteria.
/vrbo/locations/searchReturns public location suggestions for text entered in Vrbo's lodging
destination field. The response preserves the live suggestion groups and
returns fields Vrbo provides, including region_id and geo_type. A
free-text search suggestion may not have a region_id and cannot be used as a
selected destination for /api/v1/vrbo/search.
Parameter:
search_term (required): text to look up, for example Miami Beach.Example request:
GET /api/v1/vrbo/locations/search?search_term=Miami%20Beach
The current endpoint does not expose business-line, page-location, or destination-mode overrides.
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| items | 1 | median 9 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| search_term | string | Yes | Destination text to suggest | Miami%20Beach | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/vrbo/locations/search?search_term=Miami%2520Beach" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"search_term": "Miami Beach",
"groups": [
{
"items": [
{
"type": "SearchLocationBasicItem",
"primary_text": "Miami Beach",
"secondary_text": "Florida",
"region_id": "8833",
"geo_type": "CITY",
"location_full_name": "Miami Beach, Florida, United States"
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/vrbo.vrboLocationSuggestionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | vrbo.LocationSuggestionsResponse | No | ||||
| data.groups | array | No | ||||
| data.groups[].items | array | No | ||||
| data.groups[].items[].geo_type | string | No | ||||
| data.groups[].items[].location_full_name | string | No | ||||
| data.groups[].items[].primary_text | string | No | ||||
| data.groups[].items[].region_id | string | No | ||||
| data.groups[].items[].secondary_text | string | No | ||||
| data.groups[].items[].sub_items | array | No | ||||
| data.groups[].items[].type | string | No | ||||
| data.groups[].title | string | No | ||||
| data.search_term | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/vrbo/locations/search?search_term=Miami%2520Beach" \
-H "x-api-key: $CRAWLORA_API_KEY"