Skip to main content
POST /v1/data/booking/reviews/run Pricing: $0.002 per review ($2.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
Booking.com hotel URL to scrape reviews from.Format e.g. https://www.booking.com/hotel/us/the-plaza.en-gb.html.
integer
Number of reviews to return. Use 0 for all.
string
default:"f_relevance"
Sort order for reviews.Allowed values: f_relevance (Most relevant), f_recent_desc (Newest first), f_recent_asc (Oldest first), f_score_desc (Highest scores), f_score_asc (Lowest scores).
date
Stop loading older/newer reviews past this date. Only applies when Sort By = Newest first OR Oldest first.
string[]
Filter to reviews in these score bands. Leave empty for all.Allowed values: review_adj_superb (Superb (9+)), review_adj_good (Good (7-9)), review_adj_average_passable (Passable (5-7)), review_adj_poor (Poor (3-5)).

Example

Response fields

Each row in data is one review, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
To find properties first use booking/listings.