GET
# VRBO Extract Property ID API

Resolve VRBO listing URLs to the internal property IDs required by the reviews endpoint.

## Overview

#### Resolve Before Fetching Reviews

The public listing ID in a VRBO URL may differ from the internal property ID. Use the property\_id returned by this endpoint when requesting reviews.

This endpoint resolves a VRBO listing URL to the internal `property_id` accepted by the [Listing Reviews endpoint](/docs/endpoints/vrbo/listing-reviews). For example, `https://www.vrbo.com/1319401` resolves to `33486931`. Use the returned value instead of copying the URL path or removing an alphanumeric suffix. The same `property_id` prices the listing through the [Expedia Hotel Rates endpoint](/docs/endpoints/expedia/hotel-rates).

### Endpoint URL

GET https://api.stayapi.com/v1/vrbo/listing/extract-id 

## Query Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| url | string | Required | VRBO listing URL to resolve, including URLs with query parameters |

## Response Structure

### Response Fields

- `success` - Boolean indicating successful extraction
- `property_id` - Resolved internal property ID to pass to the reviews endpoint (e.g., "33486931")
- `url` - Normalized listing URL used for resolution

## Supported URL Formats

### Example VRBO Listing URLs

`https://www.vrbo.com/1319401`-\> Internal property\_id: 33486931

`https://www.vrbo.com/3530707ha`-\> Resolve to obtain the internal property\_id

`https://www.vrbo.com/1319401?arrival=2025-01-01&departure=2025-01-05`-\> Internal property\_id: 33486931

## Common Use Cases

### Browser Extensions

Resolve the current tab URL, then use the returned internal property\_id to fetch reviews.

### Bulk Processing

Process lists of VRBO URLs from spreadsheets or databases.

### URL Validation

Validate user input to ensure proper VRBO listing URLs.

### API Integration

Convert between URL formats and API identifiers for custom integrations.

## Error Handling

#### Invalid URLs

Invalid URLs return 400. A listing whose internal property ID cannot be resolved returns 404. An upstream resolution failure returns 502. Do not fall back to the public URL ID when resolution fails.

### Common Error Scenarios

- Non-VRBO URLs (returns 400)
- Listings that no longer resolve to a property (404)
- Malformed or incomplete URLs

Request

```curl
curl -X GET "https://api.stayapi.com/v1/vrbo/listing/extract-id?url=https://www.vrbo.com/1319401" \
  -H "x-api-key: YOUR_API_KEY"
```

Response

```json
{
  "success": true,
  "property_id": "33486931",
  "url": "https://www.vrbo.com/1319401?arrival=2025-01-01"
}
```

```json
{
  "detail": "Could not extract property ID from URL. Make sure it's a valid VRBO URL."
}
```