# Booking.com Reviews Scraper (`agilevendor/booking-reviews-scraper`) Actor
Scrape guest reviews from any Booking.com hotel — liked/disliked text, score, date, room type, length of stay, and the hotel's management responses, which most alternatives skip. Working date filter and full review-feed capture (not just the first ~30). Runs on Apify residential proxies.
- **URL**: https://apify.com/agilevendor/booking-reviews-scraper.md
- **Developed by:** [Agilevendor](https://apify.com/agilevendor) (community)
- **Categories:** Travel, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
$0.80 / 1,000 review scrapeds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Booking.com Reviews Scraper
Scrape all guest reviews from any Booking.com hotel page — liked/disliked text, score, date, room type, length of stay — **plus the hotel's management responses**, which most alternatives don't return.
**Why this scraper**
- ✅ **Every review, not just the first ~30** — pagination runs to the end of the feed.
- ✅ **A date filter that actually works** — collect only reviews after (or before) a date, accurately.
- ✅ **Management responses included** — the hotel's official replies, which most scrapers drop.
- ✅ **No blocking to deal with** — residential proxies and anti-bot handling are built in and on by default.
- ✅ **Lower price** — $0.80 per 1,000 reviews.
### What it does
- **Full set of reviews.** Pagination runs to the end of Booking's review feed, not just the first ~30 reviews. The Actor reads the hotel's total review count up front and collects every available review.
- **Working date filter (`cutoffDate`).** Collect only reviews newer (or older) than a given date — accurately, without over-fetching. Works with date sorting.
- **Management responses (`ownerResponse`).** The hotel's official reply to a review, whenever one exists.
- **Flexible sorting and score filter.** Sort by newest, oldest, score, or relevance; keep only the score bands you care about (e.g. superb only, poor only).
- **Reliable by design.** Runs through a real browser with Apify residential proxies and session rotation, so Booking's anti-bot blocks are handled automatically.
### How to use
1. Open a hotel on Booking.com and copy its page URL from the browser address bar.
2. Paste one or more such URLs into **Booking.com hotel URLs**.
3. Optionally set how many reviews to collect, the sort order, a cutoff date, or a score filter.
4. Click **Start** and wait for the run to finish.
5. Download the results from the **Output** tab in JSON, CSV, Excel, XML, or HTML.
### Input
| Field | Type | Description |
|---|---|---|
| `startUrls` | array | Booking.com hotel page URLs (required). |
| `maxReviewsPerHotel` | integer | Max reviews per hotel. `0` — all available (default). Set a number to cap how many you collect (and how much you pay). |
| `sortReviewsBy` | enum | `newest` / `oldest` / `highest_score` / `lowest_score` / `relevance`. Default `newest`. |
| `cutoffDate` | string | Date boundary. With `newest` keeps reviews newer than the date; with `oldest`, older than it. Ignored for other sort orders. |
| `reviewScores` | array | Score bands to keep: `ALL`, `REVIEW_ADJ_SUPERB` (9+), `REVIEW_ADJ_GOOD` (7–8.9), `REVIEW_ADJ_AVERAGE_PASSABLE` (5–6.9), `REVIEW_ADJ_POOR` (3–4.9), `REVIEW_ADJ_VERY_POOR` (below 3). Empty or `ALL` — all scores. |
| `proxyConfiguration` | object | Proxy. Defaults to Apify Residential. |
| `customData` | object | Arbitrary JSON attached to every output record. |
Example input:
```json
{
"startUrls": [
{ "url": "PASTE_BOOKING_HOTEL_URL_HERE" }
],
"maxReviewsPerHotel": 0,
"sortReviewsBy": "newest",
"reviewScores": ["ALL"]
}
````
### Output (per review)
Each collected review is one record in the dataset, including the management response (`ownerResponse`) when the hotel has replied.
Example records (from The Ritz London):
```json
[
{
"id": "21d1476578ab253e",
"hotelId": "gb/the-ritz-london",
"hotelIdNumeric": "280539",
"reviewPage": 1,
"userName": "James",
"userLocation": "United States",
"roomInfo": "Deluxe Room",
"stayDate": {
"checkin": "2026-06-04",
"checkout": "2026-06-10"
},
"nights": 6,
"reviewDate": 1781167842,
"reviewDateIso": "2026-06-11T08:50:42.000Z",
"reviewTitle": "Wonderful but a bit pricey",
"rating": 10,
"reviewTextParts": {
"Liked": "Immaculate room, attentive staff",
"Disliked": "Nothing"
},
"customData": {},
"ownerResponse": "Dear James,\n\nThank you for your kind review. We are delighted to read that you enjoyed your stay with us. We hope to welcome you back to The Ritz soon.\n\nBest regards,\nDuty Managers, The Ritz London",
"helpfulVotesCount": 0,
"isApproved": true,
"reviewLanguage": "xu",
"guestType": "Solo traveler",
"countryCode": "us"
},
{
"id": "e1c2562a4024fc70",
"hotelId": "gb/the-ritz-london",
"hotelIdNumeric": "280539",
"reviewPage": 1,
"userName": "Hakan",
"userLocation": "Turkey",
"roomInfo": "Junior Suite",
"stayDate": {
"checkin": "2026-04-23",
"checkout": "2026-04-26"
},
"nights": 3,
"reviewDate": 1777709921,
"reviewDateIso": "2026-05-02T08:18:41.000Z",
"reviewTitle": "Wonderful Stay",
"rating": 10,
"reviewTextParts": {
"Liked": "Wonderful stay as always. Very best hotel, at the very best location, with the very best and smiling staff.",
"Disliked": "Nothing."
},
"customData": {},
"ownerResponse": "Dear Hakan,\nThank you for your feedback regarding your recent stay with us.\nWe hope to welcome you back in the near future.\nBest regards,\nDuty Managers, The Ritz London",
"helpfulVotesCount": 0,
"isApproved": true,
"reviewLanguage": "xu",
"guestType": "Family",
"countryCode": "tr"
}
]
```
### Proxy and cost
The Actor is billed pay-per-event: **$0.80 per 1,000 reviews** collected, and nothing else — no charge for run time or platform usage.
Booking.com blocks datacenter IPs, so the Actor uses **residential proxies** (Apify Residential by default). Proxy traffic is billed to the account that runs the Actor.
### Is it legal to scrape Booking.com reviews?
The Actor only reads information that guests have already chosen to publish on Booking.com — review text, score, room type, stay dates, the reviewer's display name, and the management reply. It does not log in, bypass any access restriction, or collect hidden or private data such as email addresses or profile photos. In the United States, courts have held that scraping publicly accessible pages without logging in generally does not break computer-access law (the CFAA), but that is not the whole picture: a site's Terms of Service may still restrict scraping as a matter of contract, copyright can apply to the text of individual reviews, and the rules differ by jurisdiction and by what you do with the results.
A review and its display name can also count as personal data under laws such as the GDPR, even when published publicly. You are responsible for having a lawful basis to collect and use it. The Actor keeps the output to publicly shown, non-identifying fields and does not collect contact details, exact addresses, or profile photos.
This is general information, not legal advice. If you are unsure whether your use case is allowed, check with a lawyer.
### Your feedback
This Actor is actively maintained. If you hit a bug, notice a change on Booking.com that breaks the output, or want a new field or option, open an issue on the Issues tab of this Actor — it goes straight to the developer.
# Actor input Schema
## `startUrls` (type: `array`):
List of Booking.com hotel page URLs to scrape reviews from.
## `maxReviewsPerHotel` (type: `integer`):
How many reviews to collect per hotel. 0 (default) — all available through Booking's review feed. Set a number to cap how many you collect and how much you pay.
## `sortReviewsBy` (type: `string`):
Review order. The date filter (cutoffDate) works only with date sorting (newest/oldest first).
## `cutoffDate` (type: `string`):
Collect reviews relative to this date. Works only with date sorting: "Newest first" — reviews newer than the date; "Oldest first" — older than the date. Ignored for other sort orders.
## `reviewScores` (type: `array`):
Which review scores to include. Empty or All — all scores.
## `proxyConfiguration` (type: `object`):
Booking.com blocks datacenter IPs, so residential proxies are required. Proxy traffic is billed to the account that runs the Actor.
## `customData` (type: `object`):
Any JSON object that will be attached to every review record under the customData field.
## Actor input object example
```json
{
"startUrls": [
{
"url": "https://www.booking.com/hotel/gb/the-ritz-london.html"
}
],
"maxReviewsPerHotel": 50,
"sortReviewsBy": "highest_score",
"reviewScores": [],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
},
"customData": {}
}
```
# Actor output Schema
## `reviews` (type: `string`):
Collected hotel reviews in the default dataset.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrls": [
{
"url": "https://www.booking.com/hotel/gb/the-ritz-london.html"
}
],
"maxReviewsPerHotel": 50,
"sortReviewsBy": "highest_score"
};
// Run the Actor and wait for it to finish
const run = await client.actor("agilevendor/booking-reviews-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"startUrls": [{ "url": "https://www.booking.com/hotel/gb/the-ritz-london.html" }],
"maxReviewsPerHotel": 50,
"sortReviewsBy": "highest_score",
}
# Run the Actor and wait for it to finish
run = client.actor("agilevendor/booking-reviews-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"startUrls": [
{
"url": "https://www.booking.com/hotel/gb/the-ritz-london.html"
}
],
"maxReviewsPerHotel": 50,
"sortReviewsBy": "highest_score"
}' |
apify call agilevendor/booking-reviews-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=agilevendor/booking-reviews-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Booking.com Reviews Scraper",
"description": "Scrape guest reviews from any Booking.com hotel — liked/disliked text, score, date, room type, length of stay, and the hotel's management responses, which most alternatives skip. Working date filter and full review-feed capture (not just the first ~30). Runs on Apify residential proxies.",
"version": "0.1",
"x-build-id": "q14ypVMKCzGtm68Yo"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/agilevendor~booking-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-agilevendor-booking-reviews-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/agilevendor~booking-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-agilevendor-booking-reviews-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/agilevendor~booking-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-agilevendor-booking-reviews-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"startUrls"
],
"properties": {
"startUrls": {
"title": "Booking.com hotel URLs",
"type": "array",
"description": "List of Booking.com hotel page URLs to scrape reviews from.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxReviewsPerHotel": {
"title": "Max reviews per hotel",
"minimum": 0,
"type": "integer",
"description": "How many reviews to collect per hotel. 0 (default) — all available through Booking's review feed. Set a number to cap how many you collect and how much you pay.",
"default": 0
},
"sortReviewsBy": {
"title": "Sort reviews by",
"enum": [
"newest",
"oldest",
"highest_score",
"lowest_score",
"relevance"
],
"type": "string",
"description": "Review order. The date filter (cutoffDate) works only with date sorting (newest/oldest first).",
"default": "newest"
},
"cutoffDate": {
"title": "Cutoff date",
"type": "string",
"description": "Collect reviews relative to this date. Works only with date sorting: \"Newest first\" — reviews newer than the date; \"Oldest first\" — older than the date. Ignored for other sort orders."
},
"reviewScores": {
"title": "Review score filter",
"type": "array",
"description": "Which review scores to include. Empty or All — all scores.",
"items": {
"type": "string",
"enum": [
"ALL",
"REVIEW_ADJ_SUPERB",
"REVIEW_ADJ_GOOD",
"REVIEW_ADJ_AVERAGE_PASSABLE",
"REVIEW_ADJ_POOR",
"REVIEW_ADJ_VERY_POOR"
],
"enumTitles": [
"All",
"Superb (9+)",
"Good (7-9)",
"Passable (5-7)",
"Poor (3-5)",
"Very poor (1-3)"
]
},
"default": []
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Booking.com blocks datacenter IPs, so residential proxies are required. Proxy traffic is billed to the account that runs the Actor.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
},
"customData": {
"title": "Custom data",
"type": "object",
"description": "Any JSON object that will be attached to every review record under the customData field.",
"default": {}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```