Booking.com

List Booking.com property reviews

List the guest reviews of a Booking.com property, with scores, stay details and category averages.

GET/v1/booking/properties/{propertyId}/reviews
x-api-keystringheader

API key (`sfk_...`)

Parameters
8
propertyIdintegerrequiredpath

Booking.com property id, e.g. `280149` (The Savoy, London): `id` from the property search endpoint.

≥ 1 · ≤ 2147483647

sortstringoptionalquery

Order: `relevance` (the site's own), `newest`, `oldest`, `score_highest` or `score_lowest`. Default `relevance`.

one of: relevance, newest, oldest, score_highest, score_lowest

languagestringoptionalquery

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})?$

travellerTypestringoptionalquery

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

seasonstringoptionalquery

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

querystringoptionalquery

Only reviews that mention this text, e.g. `breakfast`, up to 100 characters.

min 1 chars · max 100 chars

limitintegeroptionalquery

Rows per page, 1 to 25. Default 25.

≥ 1 · ≤ 25

cursorstringoptionalquery

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_-]+$

Response fields
44

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no property has this id.

one of: found, not_found

datapropertyId
integer

The property id asked for.

datatotalCount
integernullable

Reviews matching the filters.

Guests' average score per category, over every review.

datascores[]category
string

Category key: `staff`, `facilities`, `cleanliness`, `comfort`, `value`, `location`, `wifi`.

datascores[]label
stringnullable

Category name as the site shows it, e.g. `Cleanliness`.

datascores[]score
numbernullable

Average score, 1 to 10.

datascores[]count
integernullable

Reviews that scored this category.

Reviews on this page.

datareviews[]id
string

Review id.

datareviews[]score
numbernullable

The guest's score, 1 to 10.

datareviews[]title
stringnullable

Review title.

datareviews[]positive
stringnullable

What the guest liked.

datareviews[]negative
stringnullable

What the guest disliked.

datareviews[]language
stringnullable

Language the review is written in, e.g. `en`.

datareviews[]createdAt
stringnullable

When it was posted, ISO 8601.

Who wrote it.

datareviews[]guestname
stringnullable

First name or nickname the guest shows; null when anonymous.

datareviews[]guestanonymous
booleannullable

Whether posted anonymously.

datareviews[]guestcountryCode
stringnullable

Guest's country, two-letter code, lower case.

datareviews[]guestcountry
stringnullable

Guest's country name.

datareviews[]guesttravellerType
stringnullable

Kind of trip: `families`, `couples`, `groups_of_friends`, `solo_travellers`, `business_travellers`.

datareviews[]guestavatar
stringnullable

Avatar image URL. Link only; not hosted by Social Fetch.

The stay reviewed.

datareviews[]stayroomName
stringnullable

Room the guest stayed in.

datareviews[]stayroomId
integernullable

Room id.

datareviews[]staycheckIn
stringnullable

Check-in date, `YYYY-MM-DD`.

datareviews[]staycheckOut
stringnullable

Check-out date, `YYYY-MM-DD`.

datareviews[]staynights
integernullable

Nights stayed.

Photo URLs the guest added. Links only; not hosted by Social Fetch.

datareviews[]photos[]
stringoptional
datareviews[]helpfulVotes
integernullable

Readers who found it helpful.

datareviews[]propertyReply
stringnullable

The property's public reply, when there is one.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Pass as `cursor` to get the next page; null on the last page.

datapageoffset
integer

Position of this page's first row in the full list.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.