Fetch Reviews

The Reviews endpoint retrieves reviews for a specific hotel.

GET https://api.rateparity.com/v1/reviews/{code}

Query Parameters

Filtering is supported to refine the results based on the below criteria.

Name	Type	Description
category	Category Type	Filters reviews based on the review category
score	Score Type	Filters reviews by review score: SUPERB (9-10), GOOD (7-8), PASSABLE (5-6), POOR (3-4), and VERYPOOR (1-2).
country	string	Filters reviews based on the reviewer's country.
season	Season Type	Filters reviews according to the season or time of year.
verbose	boolean	To include additional information when set to true (default: false).

Pagination

See Pagination for more details. Sorting options are dateReviewed, mostRelevant and score.

Model Description

See Model Description for the base structure of responses.

Data Object Fields

The data object contains the primary response information returned by the API:

Name	Type	Description
airbnb	ReviewScore object	Review scores and details from Airbnb.
booking	ReviewScore object	Review scores and details from Booking.com.
expedia	ReviewScore object	Review scores and details from Expedia.
google	ReviewScore object	Review scores and details from Google.
holidayCheck	ReviewScore object	Review scores and details from HolidayCheck.
hotels	ReviewScore object	Review scores and details from Hotels.com.
tripadvisor	ReviewScore object	Review scores and details from Tripadvisor.
score	double	The overall average score calculated from all available sources.
reviews	integer	Total number of reviews aggregated across all sources.
timeUpdated	Instant	The timestamp of the last update.
userReviews	List	A list of individual user reviews with details such as reviewer name, score, title, description, and review date.
facilities	List	A list of facilities mentioned in reviews. If null, no facilities data is available.

ReviewScore Object Fields

The ReviewScore object represents the scoring details for each review source:

Name	Type	Description
score	double	The average review score from the source.
outOfScore	integer	The maximum possible score for the source (e.g., 10 or 6).
total	integer	The total number of reviews counted for this source.

ReviewDetails Object Fields

Name	Type	Description
name	string	Name of the reviewer.
category	string	Category of the reviewer (e.g., Solo traveller, Family, etc.).
dateReviewed	Date	The date the review was submitted.
score	double	The review score provided by the user.
title	string	Title of the review.
description	string	Detailed text of the review.
country	string	Country of the reviewer.
photoUrl	string	URL to the reviewer's photo, if available.
channel	string	The source channel of the review (e.g. Booking.com, Tripadvisor.com).
hidden	boolean	Indicates if the review is hidden (true) or visible (false).

ReviewFacility Object Fields

Name	Type	Description
channel	string	The source channel of the review (e.g., Booking.com, Tripadvisor.com).
facility	string	The name of the facility mentioned in the review.
score	double	The review score related to the facility.
timestamp	Date	The date and time when the facility was reviewed.

MetaData Object Fields

Name	Type	Description
countries	Map<String, String>	The countries available for filtering.
filterTotals	FilterTotals object	The filtering options totals.
sortingOptions	List	Available options for sorting.

FilterTotals Object Fields

Name	Type	Description
categories	Map<Category, Integer>	The Category Type totals.
scores	Map<Score, Integer>	The Score Type totals.
seasons	Map<Season, Integer>	The Season Type totals.

Request Example

curl --location 'https://api.rateparity.com/v1/review/{code}}?limit=3&page=1&sort=dateReviewed&asc=false&Country=Italy' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {JWT_TOKEN}'

200 OK - Success

{
  "data": {
    "airbnb": {
      "score": 8.9,
      "outOfScore": 10,
      "total": 507
    },
    "booking": {
      "score": 8.7,
      "outOfScore": 10,
      "total": 430
    },
    "expedia": {
      "score": 9.1,
      "outOfScore": 10,
      "total": 350
    },
    "google": {
      "score": 8.9,
      "outOfScore": 10,
      "total": 488
    },
    "holidayCheck": {
      "score": 9.0,
      "outOfScore": 6,
      "total": 380
    },
    "hotels": {
      "score": 9.2,
      "outOfScore": 10,
      "total": 514
    },
    "tripadvisor": {
      "score": 9.0,
      "outOfScore": 10,
      "total": 3029
    },
    "score": 8.85,
    "reviews": 3459,
    "timeUpdated": "2025-01-24T00:00:00.000+00:00",
    "userReviews": [
      {
        "id": 370976,
        "name": "Ivan",
        "category": "Solo traveller",
        "dateReviewed": "2025-01-24T00:00:00.000+00:00",
        "score": 9.0,
        "title": "Ottima rapporto qualità prezzo",
        "description": "Ottima posizione, ottimo staff",
        "country": "Italy",
        "photoUrl": "",
        "channel": "Booking.com",
        "hidden": false
      },
      {
        "id": 370985,
        "name": "Salvatore",
        "category": "Solo traveller",
        "dateReviewed": "2025-01-01T00:00:00.000+00:00",
        "score": 9.0,
        "title": "Superb",
        "description": "Splendida posizione. Colazione soddisfacente. Eccellente rapporto qualità prezzo.",
        "country": "Italy",
        "photoUrl": "",
        "channel": "Booking.com",
        "hidden": false
      }
    ],
    "facilities": null
  }
}

400 Bad Request

401 Unauthorized

{
  "metadata": {
    "timestamp": "2025-02-27T10:54:03.474744"
  },
  "error": {
    "message": "Unauthorized user"
  }
}