GET

Expedia Hotel Reviews API

Extract guest reviews from Expedia hotels using the property ID.

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, and reviewer information with real-time data updates.

The Expedia Hotel Reviews endpoint returns up to 5 guest reviews per request for a hotel. Each review includes the rating, review text, reviewer name, and review date. Use pagination to fetch more reviews.

Endpoint URL

GET https://api.stayapi.com/v1/expedia/hotel/reviews

Management replies

reviews[].owner_response is null when no reply is available, or an object with nullable string fields text, published_date, and author. Only the first management reply is returned. Reply dates preserve source formatting; ISO format and timezone are not guaranteed. Date and author may be null even when text is present.

{"text":"Thank you for your feedback.","published_date":null,"author":"Hotel management"}

Parameters

Parameter	Type	Required	Description
property_id	string	Required	Expedia property ID (numeric string, e.g., "1582716")
page	integer	Optional	Page index, 0-indexed (default: 0)
per_page	integer	Optional	Reviews per page, 1-5 (default: 5, max: 5)
sort	string	Optional	Review ordering. Omit (or `recommended`) for Expedia's default order. Use `recent_desc` for newest-first (best for date-range backfill). Also accepts `score_desc`, `score_asc`, `most_relevant`.

Sorting for date ranges

Pass sort=recent_desc to return reviews newest-first, then paginate until review_date passes your cutoff. This is the reliable way to pull a specific date range, such as a single month of reviews.

Response Structure

Review Information

id - Unique review identifier
rating - Rating as raw string (e.g., "10/10 Excellent")
text - Full review text
reviewer_name - Name of the reviewer
review_date - Date of the review

Pagination Data

total_count - Number of reviews returned
has_more - Whether more reviews exist

Finding the Property ID

The property ID can be found in Expedia hotel URLs after the "h" prefix.

The property ID appears in Expedia URLs. For example:


            https://www.expedia.com/h1582716.Hotel-Information

The property ID is 1582716 (the number after "h").

Request

curl -X GET "https://api.stayapi.com/v1/expedia/hotel/reviews?property_id=1582716" \
  -H "x-api-key: YOUR_API_KEY"

const propertyId = "1582716";
const params = new URLSearchParams({
  property_id: propertyId
});

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

const data = await response.json();

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

import requests

property_id = "1582716"
url = "https://api.stayapi.com/v1/expedia/hotel/reviews"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {"property_id": property_id}

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

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

# Display individual reviews
for review in data["reviews"]:
    print(f"{review['rating']} - {review['reviewer_name']}")
    print(f"Date: {review['review_date']}")
    print(f"Review: {review['text'][:200]}...")
    print("-" * 50)

<?php
$propertyId = "1582716";
$url = "https://api.stayapi.com/v1/expedia/hotel/reviews";
$params = http_build_query([
    "property_id" => $propertyId
]);

$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"] . " - " . $review["reviewer_name"] . "\n";
    echo "Review: " . $review["text"] . "\n";
    echo "---\n";
}
?>

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

property_id = "1582716"
uri = URI("https://api.stayapi.com/v1/expedia/hotel/reviews")
uri.query = URI.encode_www_form({
  property_id: property_id
})

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_count']}"
data["reviews"].each do |review|
  puts "\#{review['rating']} - \#{review['reviewer_name']}"
  puts "Review: \#{review['text'][0..200]}..."
  puts "-" * 50
end

Response

{
  "property_id": "1582716",
  "reviews": [
    {
      "id": "review_123456",
      "rating": "10/10 Excellent",
      "text": "The room was clean and nice. The staff was very friendly and helpful. Great location near the city center.",
      "reviewer_name": "Andrew",
      "review_date": "Nov 2024",
      "owner_response": {
        "text": "Dear Andrew, thank you for your wonderful review! We're so glad you enjoyed our location and service. Best regards, Hotel Management",
        "published_date": "Nov 2024",
        "author": "The Hotel"
      }
    },
    {
      "id": "review_123457",
      "rating": "8/10 Good",
      "text": "Good place for a short rest. Clean room and comfortable bed.",
      "reviewer_name": "Marek",
      "review_date": "Oct 2024",
      "owner_response": null
    }
  ],
  "total_count": 5,
  "page": 0,
  "per_page": 5,
  "has_more": true
}

{
  "type": "https://api.stayapi.com/errors/invalid-property-id",
  "title": "Invalid Property ID",
  "status": 400,
  "detail": "Property ID must be numeric",
  "error_code": "INVALID_PROPERTY_ID"
}