GET

Accor Reviews API

Retrieve individual guest reviews and hotel responses for one Accor property.

Overview

Returns the property's aggregate score and review count plus Accor's current review set. Reviews include author, rating, title, text, date, review kind, trip type, avatar, and zero or more hotel responses.

Endpoint URL

GET https://api.stayapi.com/v1/accor/hotel/reviews

Parameters

Parameter	Type	Required	Description
hotel_id	string	Required	Accor hotel id from Search or URL to Hotel ID.
limit	integer	Optional	Maximum reviews to return, 1-20. Default: 20.

Current upstream window

Accor exposes at most 20 reviews on this surface. There is no cursor or page parameter, so this endpoint is not a full historical backfill feed.

Response fields

score, review_count, and rating_origin: Aggregate property reputation
reviews: Returned review records
total: Number of reviews in this response, not the property's lifetime review count
responses: Hotel responses with response text and creation date

Errors

Unknown hotel ids return RFC 7807 404 responses with product: "reviews". A limit outside 1-20 returns 422 validation details; upstream failures return 502.

Related endpoints

Hotel Details

Get the aggregate rating and review preview alongside property content.

View Documentation →

URL to Hotel ID

Resolve an all.accor.com hotel URL before fetching reviews.

View Documentation →

Request

curl -X GET "https://api.stayapi.com/v1/accor/hotel/reviews?hotel_id=2179&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "success": true,
  "hotel_id": "2179",
  "score": 4.2,
  "review_count": 692,
  "rating_origin": "ALL",
  "reviews": [
    {
      "author": "Anonymous",
      "rating": 5,
      "title": "Very good stay",
      "text": "Friendly team and a comfortable room.",
      "date": "2026-07-10",
      "trip_type": "Couple",
      "responses": []
    }
  ],
  "total": 1
}