Retrieve reviews

You can retrieve multiple reviews by property ID, or a single review by review ID. Read on for examples.

Find reviews on http://admin.booking.com by logging in and selecting Guest reviews > Guest reviews.


Retrieve reviews by property ID

By default, this request returns ten reviews. Use the parameter limit to change this. The response next_page links to retrieve subsequent groups of ten. When a request given by next_page returns empty results, try it again later to get new reviews.
In order to get the most recent reviews, keep fetching reviews until you find an empty page, and keep polling with the last pagination cursor to show latest modified set of reviews first.

HTTP request

GET https://supply-xml.booking.com/review-api/properties/1234567890/reviews?from_date=2018-05-01&limit=10

Request headers

Header Description Type Required Notes
Authorization Machine account username and password string Required Example: Authorization: Basic {username:password}

Request body

This request has no body. All parameters are specified in the path.

Response body

Here is an example of requesting all reviews since May 1 2018, and receiving two.

  • The first review has detailed feedback: it contains complete score data, except the guest did not give a "value for money" score. There is also a reply from the property owner.
  • The second review is minimal: it only has a "cleanliness" score, and the guest chose to stay anonymous. There is no reply from the property owner.
{
  "errors": [],
  "warnings": [],
  "meta": {
    "ruid": "UmFuZG9tSVYkc2RlIyh9YeeGkimvWCtCu/tU6M103G0tHFqLNf6R3BXVTtjr4+gVEDZWpzExk4kHrpPZkDl0rfe92nzGC3EyUpoiKcxBLrc=",
    "next_page": "https://supply-xml.booking.com/reviews/properties/1234567890/reviews?from_date=2018-05-01&cursor=HFqLNf6R3BXVTtjr4-gVEDZWpzExk4kHrpPZk4kHrpPZkDl0rfe92nzGC3"
  },
  "data":{
    "reviews":[
      {
        "review_id":"Qr-j8xe_5As",
        "created_timestamp":"2018-05-13 12:16:33",
        "last_change_timestamp":"2018-05-13 12:16:33",
        "content":{
          "language_code":"en",
          "headline":"A room on the canal...",
          "positive":"It was great that ...",
          "negative":"What I really didn't like was that, ..."
        },
        "reservation_id":87654321,
        "scoring":{
          "review_score":9.5,
          "clean":10,
          "facilities":10,
          "location":10,
          "services":10,
          "staff":7.5,
          "value":null
        },
        "reviewer":{
          "country_code":"fr",
          "name":"John",
          "is_genius":false
        },
        "reply":{
          "text":"Thank you for your review!",
          "last_change_timestamp":"2018-05-15 10:23:57"
        }
      },
      {
        "review_id":"9dC4PAoRI_w",
        "reservation_id":12345678,
        "created_timestamp":"2018-06-13 12:16:33",
        "last_change_timestamp":"2018-06-13 12:16:33",
        "content":null,
        "scoring":{
          "review_score":10,
          "clean":10,
          "facilities":null,
          "location":null,
          "services":null,
          "staff":null,
          "value" :null
        },
        "reviewer":null,
      }
    ]
  }
}

Retrieve a review by ID

You can retrieve a single review by ID with a GET request.

HTTP request

GET https://supply-xml.booking.com/review-api/properties/1234567890/reviews/phnszuv23KI

Request headers

Header Description Type Required Notes
Authorization Machine account username and password string Required Example: Authorization: Basic {username:password}

Request body

This request has no body. All parameters are specified in the path.

Response body

{
  "errors": [],
  "warnings": [],
  "meta": {
    "ruid": "UmFuZG9tSVYkc2RlIyh9YeeGkimvWCtCu/tU6M103G0tHFqLNf6R3BXVTtjr4+gVEDZWpzExk4kHrpPZkDl0rfe92nzGC3EyUpoiKcxBLrc="
  },
  "data":{
    "review_id":"phnszuv23KI",
    "created_timestamp":"2018-06-12 16:23:57",
    "last_change_timestamp":"2018-06-15 09:42:19",
    "content":{
      "language_code":"en",
      "headline":"A room on the canal...",
      "positive":"It was great that ...",
      "negative":"What I really didn't like was that, ..."
    },
    "reservation_id":87654321,
    "scoring":{
      "review_score":7.5,
      "clean":7,
      "facilities":8,
      "location":7,
      "services":6,
      "staff":9,
      "value":8
    },
    "reviewer":null,
    "response":{
      "text":"Thank you for your review!",
      "last_change_timestamp":"2018-06-15 11:52:37"
    }
  }
}