GET

VRBO Extract Property ID API

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

Copy for your AI agent

Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.

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. 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.

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 -X GET "https://api.stayapi.com/v1/vrbo/listing/extract-id?url=https://www.vrbo.com/1319401" \
  -H "x-api-key: YOUR_API_KEY"

const vrboUrl = "https://www.vrbo.com/1319401?arrival=2025-01-01";

const response = await fetch(
  `https://api.stayapi.com/v1/vrbo/listing/extract-id?url=${encodeURIComponent(vrboUrl)}`,
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(`Property ID: ${data.property_id}`);

// Pass the resolved internal property_id to the reviews endpoint
const reviewsUrl = `https://api.stayapi.com/v1/vrbo/listing/reviews/${data.property_id}`;
const reviewsResponse = await fetch(reviewsUrl, {
  headers: { "x-api-key": "YOUR_API_KEY" }
});

import requests

# Resolve the public listing URL to an internal property ID
vrbo_url = "https://www.vrbo.com/1319401"

url = "https://api.stayapi.com/v1/vrbo/listing/extract-id"
params = {"url": vrbo_url}
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers)
data = response.json()

print(f"Property ID: {data['property_id']}")

# Pass the resolved internal property_id to the reviews endpoint
property_id = data["property_id"]
reviews_url = f"https://api.stayapi.com/v1/vrbo/listing/reviews/{property_id}"
reviews = requests.get(reviews_url, headers=headers)

<?php
$vrboUrl = "https://www.vrbo.com/1319401";
$url = "https://api.stayapi.com/v1/vrbo/listing/extract-id";
$params = http_build_query(["url" => $vrboUrl]);

$ch = curl_init($url . "?" . $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

echo "Property ID: " . $data["property_id"] . "\n";

// Pass the resolved internal property_id to the reviews endpoint
$propertyId = $data["property_id"];
$reviewsUrl = "https://api.stayapi.com/v1/vrbo/listing/reviews/" . $propertyId;
?>

require "net/http"
require "json"
require "uri"

vrbo_url = "https://www.vrbo.com/1319401"
uri = URI("https://api.stayapi.com/v1/vrbo/listing/extract-id")
uri.query = URI.encode_www_form({ url: vrbo_url })

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "YOUR_API_KEY"

response = http.request(request)
data = JSON.parse(response.body)

puts "Property ID: #{data['property_id']}"

# Pass the resolved internal property_id to the reviews endpoint
property_id = data["property_id"]
reviews_url = "https://api.stayapi.com/v1/vrbo/listing/reviews/#{property_id}"

Response

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

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