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"
}
}
}