Booking.com Reviews API
Every guest review of a property, 25 a page, with the guests' average score per category.
GET /v1/booking/properties/{propertyId}/reviews1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/booking/properties/{propertyId}/reviews lists a property's guest reviews. propertyId is the id from a search result (280149 is The Savoy, London). sort is relevance (the site's own), newest, oldest, score_highest or score_lowest; language keeps reviews written in one language such as en; travellerType keeps families, couples, groups_of_friends, solo_travellers or business_travellers; season keeps stays in mar_may, jun_aug, sep_nov or dec_feb; query keeps reviews that mention a word. limit is 1 to 25.
Each review carries id, score (1 to 10), title, positive and negative text, language, createdAt, the guest (name, country, traveller type, avatar), the stay (room, check-in, check-out, nights), photos, helpfulVotes and the propertyReply. scores gives the guests' average for staff, facilities, cleanliness, comfort, value, location and wifi, and totalCount counts the reviews matching the filters. Pass page.nextCursor back as cursor while page.hasMore is true.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Booking.com Reviews API FAQ
Where do I find a property's id?
Every property in GET /v1/booking/search has an id. Pass it as propertyId. The Savoy in London is 280149.
What if the property has no reviews yet?
lookupStatus is found with totalCount 0 and an empty list. not_found means no property has that id.
Can I change filters halfway through?
No. A cursor belongs to the property, sort and filters it was issued for. Passing it with others is refused with HTTP 400; start again without a cursor.
How many credits does a call cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.