List Booking.com property reviews
List the guest reviews of a Booking.com property, with scores, stay details and category averages.
Headers
Get your API keyAPI key (`sfk_...`)
Booking.com property id, e.g. `280149` (The Savoy, London): `id` from the property search endpoint.
≥ 1 · ≤ 2147483647
Order: `relevance` (the site's own), `newest`, `oldest`, `score_highest` or `score_lowest`. Default `relevance`.
one of: relevance, newest, oldest, score_highest, score_lowest
Only reviews written in this language, as a code such as `en`, `fr`, `de` or `zh`. Omit for every language.
pattern: ^[A-Za-z]{2}(?:-[A-Za-z]{2})?$
Only reviews by this kind of guest: `families`, `couples`, `groups_of_friends`, `solo_travellers` or `business_travellers`. Omit for all.
one of: families, couples, groups_of_friends, solo_travellers, business_travellers
Only stays in these months: `mar_may`, `jun_aug`, `sep_nov` or `dec_feb`. Omit for the whole year.
one of: mar_may, jun_aug, sep_nov, dec_feb
Only reviews that mention this text, e.g. `breakfast`, up to 100 characters.
min 1 chars · max 100 chars
Rows per page, 1 to 25. Default 25.
≥ 1 · ≤ 25
Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page.
min 1 chars · max 1024 chars · pattern: ^[A-Za-z0-9_-]+$
Endpoint-specific response payload.
`not_found` when no property has this id.
one of: found, not_found
The property id asked for.
Reviews matching the filters.
Guests' average score per category, over every review.
Category key: `staff`, `facilities`, `cleanliness`, `comfort`, `value`, `location`, `wifi`.
Category name as the site shows it, e.g. `Cleanliness`.
Average score, 1 to 10.
Reviews that scored this category.
Reviews on this page.
Review id.
The guest's score, 1 to 10.
Review title.
What the guest liked.
What the guest disliked.
Language the review is written in, e.g. `en`.
When it was posted, ISO 8601.
Who wrote it.
First name or nickname the guest shows; null when anonymous.
Whether posted anonymously.
Guest's country, two-letter code, lower case.
Guest's country name.
Kind of trip: `families`, `couples`, `groups_of_friends`, `solo_travellers`, `business_travellers`.
Avatar image URL. Link only; not hosted by Social Fetch.
The stay reviewed.
Room the guest stayed in.
Room id.
Check-in date, `YYYY-MM-DD`.
Check-out date, `YYYY-MM-DD`.
Nights stayed.
Photo URLs the guest added. Links only; not hosted by Social Fetch.
Readers who found it helpful.
The property's public reply, when there is one.
Pagination state for the current page.
Whether another page is available.
Pass as `cursor` to get the next page; null on the last page.
Position of this page's first row in the full list.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/booking/properties/280149/reviews" \
-H "x-api-key: YOUR_API_KEY"Responses
Booking.com property guest reviews.