Skip to main content

Quick start guide

Introduction​

The Hotels Reviews API returns traveller reviews for a specific hotel. Use it to display recent, relevant reviews on your hotel pages.

Sample request​

/reviews​

curl --request POST 'https://partners.api.skyscanner.net/apiservices/v1/hotels/reviews' \
  --header 'x-api-key: your-api-key' \
  --header 'content-type: application/json' \
  --data '{
    "hotelId": "46948122",
    "locale": "en-GB",
    "pagination": { "limit": 5, "offset": 0 },
    "sort": "SORT_ORDER_TYPE_MOST_RECENT",
    "filters": [
      { "guestTypeFilter": { "value": "GUEST_TYPE_COUPLE" } },
      { "travellerRatingFilter": { "value": "TRAVELLER_RATING_GOOD" } }
    ]
  }'

Notes:

  • Use sort to choose the ordering (recommended, rating ascending/descending, or most recent).
  • Combine optional filters to refine the results (guest type, locale, traveller rating, tag).

API documentation​

For a deeper explanation of fields and filters, see the Hotels Reviews overview.