GET

VRBO Listing Reviews API

Extract comprehensive guest reviews from VRBO listings using the property ID.

Overview

Real-time Review Data

Get complete review content, ratings, sentiments, and host responses with real-time data updates.

The VRBO Listing Reviews endpoint provides access to detailed review data including guest feedback, ratings, sentiment tags, and host responses. Perfect for analyzing guest feedback and property reputation.

Endpoint URL

GET https://api.stayapi.com/v1/vrbo/listing/reviews/{property_id}

Parameters

Parameter	Type	Required	Description
property_id	string	Required	VRBO property ID (path parameter)
page	integer	Optional	Page number (1-indexed, default: 1)
page_size	integer	Optional	Reviews per page (1-20, default: 10)
sort_by	string	Optional	Sort order: recommended, newest, highest, lowest (default: recommended)

Response Structure

Review Information

id - Unique review identifier
rating - Overall rating (1-10 scale)
rating_text - Rating description (Excellent, Good, etc.)
title - Review title (if available)
text - Full review text

Reviewer Details

reviewer_name - Guest display name
verified - Verified stay indicator (always true)

Additional Data

sentiments - Array of sentiment tags (e.g., "Great location", "Clean")
host_response - Host reply text (if available)
has_more - Boolean indicating more pages available
total_reviews - Total count of reviews returned

Finding the Property ID

Need the Property ID?

Use the /listing/extract-id endpoint to extract the property ID from any VRBO URL.

The property ID can be found in VRBO URLs. For example:


            https://www.vrbo.com/19006312

The property ID is 19006312 (the number in the URL path).

Request

curl -X GET "https://api.stayapi.com/v1/vrbo/listing/reviews/19006312?page=1&page_size=10" \
  -H "x-api-key: YOUR_API_KEY"

const propertyId = "19006312";
const params = new URLSearchParams({
  page: "1",
  page_size: "10",
  sort_by: "newest"
});

const response = await fetch(
  `https://api.stayapi.com/v1/vrbo/listing/reviews/${propertyId}?${params}`,
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();

// Display reviews
data.reviews.forEach(review => {
  console.log(`${review.rating}/10 - ${review.reviewer_name}`);
  console.log(`Review: ${review.text}`);
  if (review.host_response) {
    console.log(`Host response: ${review.host_response}`);
  }
  console.log("---");
});

import requests

property_id = "19006312"
url = f"https://api.stayapi.com/v1/vrbo/listing/reviews/{property_id}"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {
    "page": 1,
    "page_size": 10,
    "sort_by": "newest"
}

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

# Display review summary
print(f"Total reviews: {data['total_reviews']}")
print(f"Has more: {data['has_more']}\n")

# Display individual reviews
for review in data["reviews"]:
    print(f"{review['rating']}/10 - {review['reviewer_name']}")
    print(f"Sentiments: {review['sentiments']}")
    print(f"Review: {review['text'][:200]}...")
    if review.get("host_response"):
        print(f"Host response: {review['host_response'][:100]}...")
    print("-" * 50)

<?php
$propertyId = "19006312";
$url = "https://api.stayapi.com/v1/vrbo/listing/reviews/" . $propertyId;
$params = http_build_query([
    "page" => 1,
    "page_size" => 10,
    "sort_by" => "newest"
]);

$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);

// Display reviews
foreach ($data["reviews"] as $review) {
    echo $review["rating"] . "/10 - " . $review["reviewer_name"] . "\n";
    echo "Review: " . $review["text"] . "\n";
    echo "---\n";
}
?>

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

property_id = "19006312"
uri = URI("https://api.stayapi.com/v1/vrbo/listing/reviews/#{property_id}")
uri.query = URI.encode_www_form({
  page: 1,
  page_size: 10,
  sort_by: "newest"
})

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)

# Display reviews
puts "Total reviews: #{data['total_reviews']}"
data["reviews"].each do |review|
  puts "#{review['rating']}/10 - #{review['reviewer_name']}"
  puts "Review: #{review['text'][0..200]}..."
  puts "-" * 50
end

Response

{
  "property_id": "19006312",
  "total_reviews": 15,
  "page": 1,
  "page_size": 10,
  "has_more": true,
  "sort_by": "newest",
  "reviews": [
    {
      "id": "review_123456",
      "rating": 10,
      "rating_text": "Excellent",
      "title": "Perfect beach getaway!",
      "text": "This property exceeded all our expectations. The views were absolutely stunning and the host was incredibly helpful throughout our stay. Everything was spotlessly clean.",
      "reviewer_name": "Sarah J.",
      "verified": true,
      "sentiments": ["Great location", "Clean", "Responsive host"],
      "host_response": "Thank you so much for your wonderful review! We're thrilled you enjoyed your stay."
    },
    {
      "id": "review_123457",
      "rating": 8,
      "rating_text": "Good",
      "title": null,
      "text": "Great location and comfortable apartment. Check-in was smooth and the host provided lots of local recommendations.",
      "reviewer_name": "Michael C.",
      "verified": true,
      "sentiments": ["Great location"],
      "host_response": null
    }
  ]
}

{
  "error": "Property not found",
  "detail": "No property found with ID: 999999999",
  "status_code": 404
}