Hotel Reviews API

// Example request
const response = await fetch("https://api.stayapi.com/v1/booking/hotel/reviews?" +
  new URLSearchParams({
    hotel_id: "1302021",
    page: 1,
    per_page: 10,
    language: "en"
  }), {
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(`Found ${data.data.reviews_returned} reviews`);
console.log(`Has next page: ${data.data.pagination.has_next_page}`);

// Display first few reviews with nested structure
data.data.reviews.slice(0, 3).forEach(review => {
  console.log(`${review.guest.name} (${review.score}/10): ${review.review.title}`);
  console.log(`  Room: ${review.stay_details.room_type}`);
});

import requests

url = "https://api.stayapi.com/v1/booking/hotel/reviews"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

# Example request
params = {
    "hotel_id": "1302021",
    "page": 1,
    "per_page": 10,
    "language": "en"
}

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

if response.status_code == 200:
    print(f"Found {data[\"data\"][\"reviews_returned\"]} reviews on this page")
    print(f"Has next page: {data[\"data\"][\"pagination\"][\"has_next_page\"]}\n")

    for review in data["data"]["reviews"][:3]:
        print(f"{review[\"guest\"][\"name\"]} ({review[\"score\"]}/10):")
        print(f"  Title: {review[\"review\"][\"title\"]}")
        print(f"  Room: {review[\"stay_details\"][\"room_type\"]}\n")

<?php
$url = "https://api.stayapi.com/v1/booking/hotel/reviews";
$params = http_build_query([
    "hotel_id" => "1302021",
    "page" => 1,
    "per_page" => 10,
    "language" => "en"
]);

$headers = [
    "x-api-key: YOUR_API_KEY",
    "Content-Type: application/json"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . "?" . $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

if ($data["success"]) {
    echo "Found " . $data["data"]["reviews_returned"] . " reviews\n";
    echo "Has next page: " . ($data["data"]["pagination"]["has_next_page"] ? "yes" : "no") . "\n\n";

    foreach (array_slice($data["data"]["reviews"], 0, 3) as $review) {
        echo $review["guest"]["name"] . " (" . $review["score"] . "/10): " . $review["review"]["title"] . "\n";
    }
}
?>

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

uri = URI("https://api.stayapi.com/v1/booking/hotel/reviews")
uri.query = URI.encode_www_form({
  hotel_id: "1302021",
  page: 1,
  per_page: 10,
  language: "en"
})

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"
request["Content-Type"] = "application/json"

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

if response.code == "200"
  puts "Found #{data["data"]["reviews_returned"]} reviews"
  puts "Has next page: #{data["data"]["pagination"]["has_next_page"]}\n\n"

  data["data"]["reviews"].first(3).each do |review|
    puts "#{review["guest"]["name"]} (#{review["score"]}/10): #{review["review"]["title"]}"
  end
else
  puts "Error: #{response.code}"
end

{
  "type": "https://api.stayapi.com/errors/invalid-hotel-id",
  "title": "Invalid Hotel ID",
  "status": 400,
  "detail": "Parameter 'hotel_id' must be a numeric string.",
  "instance": "/v1/booking/hotel/reviews",
  "provider": "booking",
  "error_code": "INVALID_HOTEL_ID"
}