Hotel Reviews API

// Using hotel slug
const response = await fetch("https://api.stayapi.com/v1/booking/hotel/reviews?" +
  new URLSearchParams({
    url: "le-grand-hotel-paris",
    page: 1,
    per_page: 20,
    sort: "newest",
    language: "en"
  }), {
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

// Or using full URL
const responseFullUrl = await fetch("https://api.stayapi.com/v1/booking/hotel/reviews?" +
  new URLSearchParams({
    url: "https://www.booking.com/hotel/fr/le-grand-hotel-paris.html",
    page: 1,
    per_page: 20
  }), {
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(`Found ${data.data.reviews.length} reviews`);
console.log(`Average rating: ${data.data.average_rating}/10`);

// Display first few reviews
data.data.reviews.slice(0, 3).forEach(review => {
  console.log(`${review.author} (${review.rating}/10): ${review.title}`);
});

import requests

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

# Using hotel slug
params = {
    "url": "le-grand-hotel-paris",
    "page": 1,
    "per_page": 20,
    "sort": "newest",
    "language": "en"
}

# Or using full URL
params_full_url = {
    "url": "https://www.booking.com/hotel/fr/le-grand-hotel-paris.html",
    "page": 1,
    "per_page": 20
}

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

if response.status_code == 200:
    print(f"Hotel: {data[\"data\"][\"hotel_name\"]}")
    print(f"Average rating: {data[\"data\"][\"average_rating\"]}/10")
    print(f"Total reviews: {data[\"data\"][\"total_reviews\"]}")
    print(f"Found {len(data[\"data\"][\"reviews\"])} reviews on this page\n")

    for review in data["data"]["reviews"][:3]:
        print(f"{review[\"author\"]} ({review[\"rating\"]}/10):")
        print(f"  {review[\"title\"]}")
        print(f"  Date: {review[\"date\"]}")
        print(f"  Helpful votes: {review[\"helpful_votes\"]}\n")

<?php
$url = "https://api.stayapi.com/v1/booking/hotel/reviews";
$params = http_build_query([
    "url" => "le-grand-hotel-paris",
    "page" => 1,
    "per_page" => 20,
    "sort" => "newest",
    "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["status"] === "success") {
    echo "Hotel: " . $data["data"]["hotel_name"] . "\n";
    echo "Average rating: " . $data["data"]["average_rating"] . "/10\n";
    echo "Found " . count($data["data"]["reviews"]) . " reviews\n\n";

    foreach (array_slice($data["data"]["reviews"], 0, 3) as $review) {
        echo $review["author"] . " (" . $review["rating"] . "/10): " . $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({
  url: "le-grand-hotel-paris",
  page: 1,
  per_page: 20,
  sort: "newest",
  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 "Hotel: #{data["data"]["hotel_name"]}"
  puts "Average rating: #{data["data"]["average_rating"]}/10"
  puts "Found #{data["data"]["reviews"].length} reviews\n\n"

  data["data"]["reviews"].first(3).each do |review|
    puts "#{review["author"]} (#{review["rating"]}/10): #{review["title"]}"
  end
else
  puts "Error: #{response.code}"
  puts data["error"]["message"] if data["error"]
end

{
  "error": {
    "code": "not_found",
    "message": "Hotel not found",
    "details": "No hotel found with the specified URL. Please check the hotel URL parameter."
  }
}