GET

VRBO Listing Reviews API

Extract comprehensive guest reviews from VRBO listings using the internal property ID returned by the extract-id endpoint or VRBO search.

Copy for your AI agent

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

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	Internal VRBO property ID returned as property_id by /v1/vrbo/listing/extract-id or VRBO search (path parameter). The public listing ID in a VRBO URL may be different.
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?

Pass the listing URL to /v1/vrbo/listing/extract-id, then use the returned property_id with this reviews endpoint. Direct reviews requests require that resolved internal ID; do not pass the public listing ID from the URL.

For example, resolve this public listing URL with the Extract Property ID endpoint:


            https://www.vrbo.com/1319401

The resolver returns property_id: "33486931". Use that value in /v1/vrbo/listing/reviews/33486931. A public listing ID can match an unrelated internal property ID, so resolve the listing URL before fetching reviews.

If you use VRBO Search, pass its property_id directly to this endpoint. Its listing_id is for the public listing URL.

Request

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

const propertyId = "33486931";
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 = "33486931"
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 = "33486931";
$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 = "33486931"
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": "33486931",
  "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
}