---
title: "Scrape Booking.com hotel reviews"
method: POST
path: "/travel/booking-reviews"
tags: ["Plugins"]
---

# Scrape Booking.com hotel reviews

`POST /travel/booking-reviews`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/travel/booking-reviews`
- Auth: API key in header `x-scrapeunblocker-key`

Given a Booking.com `hotel` (page URL or `<cc>/<slug>`), returns its newest guest `reviews`: `id`, `reviewDate`, `rating`, `ratingText`, `title`, `ratingBand`, `positiveText`, `negativeText`, `reviewer` (`name`, `country`, `countryCode`), `tripType`, `travelerType`, `nights`, `stayMonth`, `helpfulVotes`, `submittedFromMobile`, `language` and the raw `tags`. Booking serves the newest 15 reviews written in each language: pick the languages with `languages` (or `all`), cap the total with `max_results` and drop older reviews with `since`. Billed one unit per language page fetched (`pagesFetched`).

## Query parameters

- `hotel` string, required: Booking.com hotel page URL, e.g. https://www.booking.com/hotel/fr/le-meurice.html (a locale suffix such as .en-gb.html and query parameters are fine), or `<cc>/<slug>` such as fr/le-meurice.
- `languages` string, nullable: Review languages to read, comma-separated, or `all`: en, de, fr, es, it, nl, pt, pl, ru, ja, zh, ko, sv, da, no, fi, cs, tr. Default en. Booking serves the newest 15 reviews written in each language; each language is one page and one billed unit, fetched in the order given until max_results is reached.
- `max_results` integer: How many reviews to return across languages (1-270, at most 15 per language).
- `since` string, nullable: Only reviews written on or after this date (YYYY-MM-DD).
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').

## Response `200`

JSON with `hotel`, a `reviews` array and per-language results.

- unknown

## Other responses

- `400`: Invalid parameters / not a Booking.com hotel URL.
- `404`: Booking has no hotel at that URL.
- `422`: Validation Error
- `502`: Blocked by Booking, no review list returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)