GET

VRBO Extract Property ID API

Parse VRBO listing URLs to extract property IDs required for API calls.

Overview

URL Parsing Utility

Extract property IDs from any VRBO URL format for use with other API endpoints.

This utility endpoint parses VRBO URLs to extract the property ID that can be used with other API endpoints like the reviews endpoint.

Endpoint URL

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

Query Parameters

Parameter	Type	Required	Description
url	string	Required	Any valid VRBO listing URL to parse

Response Structure

Response Fields

success - Boolean indicating successful extraction
property_id - Extracted property ID (e.g., "19006312")
url - Original URL provided for verification

Supported URL Formats

All VRBO URL Patterns

https://www.vrbo.com/19006312 -> ID: 19006312

https://www.vrbo.com/12345ha -> ID: 12345ha

https://www.vrbo.com/19006312?arrival=2025-01-01&departure=2025-01-05 -> ID: 19006312

Common Use Cases

Browser Extensions

Extract IDs from the current tab URL to fetch reviews or property data.

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

The endpoint will return a 400 error if the URL is not a valid VRBO listing URL or if no property ID can be extracted.

Common Error Scenarios

Non-VRBO URLs (returns 400)
VRBO URLs without property IDs (e.g., search pages)
Malformed or incomplete URLs

Request

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

const vrboUrl = "https://www.vrbo.com/19006312?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}`);

// Use the extracted ID with other endpoints
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

# Extract ID from any VRBO URL
vrbo_url = "https://www.vrbo.com/19006312"

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']}")

# Use the extracted ID with other endpoints
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/19006312";
$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";

// Use the extracted ID with other endpoints
$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/19006312"
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']}"

# Use the extracted ID with other endpoints
property_id = data["property_id"]
reviews_url = "https://api.stayapi.com/v1/vrbo/listing/reviews/#{property_id}"

Response

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

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