Overview
Introduction
The Hotels Reviews API provides traveller-written reviews for specific hotels. You can use it to enrich hotel detail pages with recent reviews, star ratings, and context such as guest type and tags.
How we use it at Skyscanner
We use the Hotels Reviews API to render paginated traveller reviews on our hotel pages. For example, see the reviews section under the hotel detail page.
Legal disclaimer on content availability
Skyscanner maintains contractual agreements with various supply partners that restrict our ability to distribute certain pricing information and content through our API services. As a result, the content and pricing available through our APIs may differ from what is displayed on skyscanner.net. As a result, certain images and reviews featured on Skyscanner’s website will not be included in results available to our Hotels Reviews API partners.
Endpoint
/reviews
POST https://partners.api.skyscanner.net/apiservices/v1/hotels/reviews
The /reviews endpoint returns a paginated list of reviews for a single hotel, with optional sorting and filtering.
Concepts
- Pagination: Use
pagination.limitandpagination.offsetto page through reviews. - Sorting: Control ordering via
sort(e.g. recommended, most recent, rating). - Filters: Provide an array of filters to refine results (guest type, locale, traveller rating, tag).
Check the API reference for constraints and default values.
Request
/reviews
Required fields
| Field name | Description |
|---|---|
hotelId | Skyscanner hotel ID to retrieve reviews for. Example: 46948122 |
locale | Locale for returned fields (e.g., en-GB). See the Culture API for supported locales. |
Optional fields
| Field name | Description |
|---|---|
pagination | Pagination object: { "limit": number <= 20, "offset": number >= 0 } |
sort | Sorting order for results (see Concepts / API reference). |
filters | Array of filter objects (guest type, locale, traveller rating, tag). See API reference for details. |
Response /reviews
Fields
The response includes the following top-level fields:
| Field | Description |
|---|---|
availableReviewCount | Total number of reviews after filters are applied. |
reviews | Array of review objects for the current page. |
Key attributes within each review include:
| Attribute | Description |
|---|---|
title | Review title. |
content | Review body. |
rating | Traveller rating (0–5). |
reviewDate | Date the review was published. |
checkinDate | Traveller check-in date, where available. |
guestType | Traveller type (e.g., couple, family). |
locale | Locale of the review text. |
countryCode | ISO country code of the reviewer, if available. |
countryName | Country name of the reviewer, if available. |
translationType | Whether the content is original or machine-translated. |
logoUrl | Source logo image URL (e.g., review provider). |
agentUrl | Link to the original review/source, where applicable. |
hotelReply | Hotel’s response to the review, if provided. |
For a hands-on example, check the Quick start guide.
For the complete schema (including nested messages and enums), refer to the corresponding API reference.