v1

latestOpenAPI 3.0.02026-07-247251950.2 KB

Hotels

Get the reviews of a hotel

Overview

Retrieve guest reviews and ratings for a specific hotel. Display authentic feedback from previous guests to help users make informed booking decisions.

When to Use

Review display - Show guest reviews on hotel detail pages
Rating aggregation - Display average ratings and review counts
Trust building - Show authentic guest feedback
Decision support - Help users evaluate hotels before booking

What You Get

Guest reviews - Individual review text and ratings
Review dates - When each review was written
Ratings - Numerical and textual ratings
Guest feedback - Detailed comments from previous guests

Quick Start

Provide the hotelId as a query parameter. Returns all reviews for that hotel with ratings and comments.

get/data/reviews

Query parameters

hotelIdstring required

Unique ID of a hotel

limitinteger

Specifies the maximum number of results to return. By default, this is set to 200, even if not explicitly defined. If a higher limit is specified, the maximum allowed is 5000 results

offsetinteger

Specifies the number of reviews to skip, defaults to 0

timeoutnumber float

request timeout in seconds

getSentimentboolean

If set to true, an AI sentiment analysis of the last 1000 reviews will be returned

languagestring

ISO 639-1 language code (e.g., 'fr', 'es', 'de') to translate reviews using AI. If not provided, the reviews will be returned in the default language (en). When this parameter is provided, the maximum number of reviews returned is 10.

Response

A list of hotel reviews

totalinteger

Example response

{
  "data": [
    {
      "averageScore": 10,
      "country": "ma",
      "type": "review category business travellers",
      "name": "Himri",
      "date": "2026-07-10 15:26:15",
      "headline": "Exceptional",
      "language": "en",
      "pros": "Exceptional as always",
      "source": "Tripadvisor"
    }
  ]
}