# Booking.com Reviews Scraper \[💙$0.5/1k] (`epicscrapers/booking-reviews-scraper`) Actor
\[$0.5/1k] Scrape Booking.com hotel reviews. Extract review text, ratings, reviewer information, travel type, stay date, languages, likes, management responses, and more.
- **URL**: https://apify.com/epicscrapers/booking-reviews-scraper.md
- **Developed by:** [Epic Scrapers](https://apify.com/epicscrapers) (community)
- **Categories:** Travel, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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
## Scrape reviews from booking.com listings.
The scraper is very simple to use.
Copy and paste the url of place you want to scrape. Eg: https://www.booking.com/hotel/de/riu-plaza-berlin.html.
Then, select the number of reviews and language you want. By default we scrape the top 20 in English.
There is also an option to translate.
That's it.
Use it for monitoring, lead generation, automation etc.
You can connect it to n8n, make, use it as an api etc. There are tons of integrations for Apify.
### Related actors that might interest you
You might want to connect this actor to other actors to build a data pipeline.
Here are a few ones:
- [Booking.com Scraper](https://apify.com/epicscrapers/booking-scraper?fpr=epicscrapers) - A comprehensive scraper, that supports search by location/url to find listings and data
- [Booking.com availability scraper](https://apify.com/epicscrapers/booking-availability-scraper?fpr=epicscrapers) - To check if a listing is available. Also supports search by location.
### Example output
```json
{
"recordType": "review",
"hotelId": "1377073",
"hotelUrl": "https://www.booking.com/hotel/de/riu-plaza-berlin.html",
"reviewId": "5315404858",
"reviewHash": "f6dc775e9904a976",
"title": "Riu",
"pros": "It offers good value for money.",
"cons": "The hotel didn't allow most guests to watch the football final in the guest lounge. They severely limited the number of people allowed in, so the organization was poor and the experience was disappointing.",
"score": 3.2,
"date": "2026-07-21 21:08:24",
"language": "en-us",
"countryCode": "ba",
"travelPurpose": "leisure",
"helpfulVotes": 0,
"reviewerName": "Fejzic",
"reviewerType": "solo traveller",
"reviewerAvatar": "https://lh3.googleusercontent.com/a/AGNmyxb9OhgP-617IvldMC7IDHQzoo-mHLTMC5Kvwo40=s96-c64",
"reviewerReviewCount": 0,
"nightsStayed": 4,
"roomId": 137707325,
"roomName": "Family Suite",
"checkin": "2026-07-17",
"checkout": "2026-07-21",
"roomPhotoUrl": "https://cf.bstatic.com/xdata/images/hotel/max500/188927768.jpg?k=11cb554bd16e0bc434e23c785e1338dca9002c92ff1979e919c3f9e601eaf060&o=",
"photos": [],
"tags": [],
"isIncentivised": false,
"hotelierName": "Riu Plaza Berlin",
"hotelierResponse": null,
"hotelierResponseDate": null,
"scrapedAt": "2026-07-21T21:55:19.171Z"
}
````
### Example input
```json
{
"urls": ["https://www.booking.com/hotel/de/riu-plaza-berlin.html"],
"hotelIds": [],
"maxReviews": 100,
"rowsPerPage": 25,
"language": "en-us",
"includeTranslations": false,
"includeTopics": false
}
```
### Desclaimer
This scraper is not affiliated with [booking.com](booking.com).
# Actor input Schema
## `urls` (type: `array`):
Paste Booking.com hotel page URLs. The Actor automatically resolves each URL to the internal Booking.com hotel ID. Example: https://www.booking.com/hotel/de/riu-plaza-berlin.html
## `hotelIds` (type: `array`):
Use this only if you already know the Booking.com hotel IDs. IDs can be used instead of URLs or together with URLs. Example: 1377073
## `maxReviews` (type: `integer`):
Maximum number of newest reviews to save for each hotel. Increase this when you need deeper history; keep it low for quick tests and lower costs.
## `language` (type: `string`):
Language code sent to Booking.com, such as en-us, de, fr, or es. This affects localized labels and returned review text when Booking.com provides it.
## `includeTranslations` (type: `boolean`):
Add a translation object with translated title, pros, and cons for each review. This uses Booking.com's translation endpoint and adds extra requests.
## `translationLanguage` (type: `string`):
Target language for translated review text. Leave empty to use the same value as Review language. Examples: en, de, es.
## `includeTopics` (type: `boolean`):
Save one extra hotelReviewMetadata record per hotel with total review count, popular topics, reviewer types, languages, and time-of-year breakdowns.
## `rowsPerPage` (type: `integer`):
How many reviews to request from Booking.com at once. Higher values reduce the number of requests; lower values avoid fetching unnecessary reviews when Reviews per hotel is small. Maximum is 100.
## `proxyConfiguration` (type: `object`):
Optional proxy settings. For larger runs, Apify Proxy is recommended. The Actor uses a sticky proxy session per hotel with a matching mobile device fingerprint.
## Actor input object example
```json
{
"urls": [
"https://www.booking.com/hotel/de/riu-plaza-berlin.html"
],
"hotelIds": [],
"maxReviews": 20,
"language": "en-us",
"includeTranslations": false,
"includeTopics": false,
"rowsPerPage": 25
}
```
# Actor output Schema
## `results` (type: `string`):
Default dataset containing review records, optional hotel-level metadata records, and error records.
# 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 = {
"urls": [
"https://www.booking.com/hotel/de/riu-plaza-berlin.html"
],
"hotelIds": []
};
// Run the Actor and wait for it to finish
const run = await client.actor("epicscrapers/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 = {
"urls": ["https://www.booking.com/hotel/de/riu-plaza-berlin.html"],
"hotelIds": [],
}
# Run the Actor and wait for it to finish
run = client.actor("epicscrapers/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 '{
"urls": [
"https://www.booking.com/hotel/de/riu-plaza-berlin.html"
],
"hotelIds": []
}' |
apify call epicscrapers/booking-reviews-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=epicscrapers/booking-reviews-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Booking.com Reviews Scraper [💙$0.5/1k]",
"description": "[$0.5/1k] Scrape Booking.com hotel reviews. Extract review text, ratings, reviewer information, travel type, stay date, languages, likes, management responses, and more.",
"version": "0.1",
"x-build-id": "ptDgncVY8GQ8PVwzf"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/epicscrapers~booking-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-epicscrapers-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/epicscrapers~booking-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-epicscrapers-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/epicscrapers~booking-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-epicscrapers-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",
"properties": {
"urls": {
"title": "Hotel URLs",
"uniqueItems": true,
"type": "array",
"description": "Paste Booking.com hotel page URLs. The Actor automatically resolves each URL to the internal Booking.com hotel ID. Example: https://www.booking.com/hotel/de/riu-plaza-berlin.html",
"items": {
"type": "string",
"pattern": "^https?:\\/\\/(www\\.)?booking\\.com\\/hotel\\/.+"
}
},
"hotelIds": {
"title": "Hotel IDs",
"uniqueItems": true,
"type": "array",
"description": "Use this only if you already know the Booking.com hotel IDs. IDs can be used instead of URLs or together with URLs. Example: 1377073",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"maxReviews": {
"title": "Reviews per hotel",
"minimum": 1,
"type": "integer",
"description": "Maximum number of newest reviews to save for each hotel. Increase this when you need deeper history; keep it low for quick tests and lower costs.",
"default": 20
},
"language": {
"title": "Review language",
"type": "string",
"description": "Language code sent to Booking.com, such as en-us, de, fr, or es. This affects localized labels and returned review text when Booking.com provides it.",
"default": "en-us"
},
"includeTranslations": {
"title": "Translate reviews",
"type": "boolean",
"description": "Add a translation object with translated title, pros, and cons for each review. This uses Booking.com's translation endpoint and adds extra requests.",
"default": false
},
"translationLanguage": {
"title": "Translation language",
"type": "string",
"description": "Target language for translated review text. Leave empty to use the same value as Review language. Examples: en, de, es."
},
"includeTopics": {
"title": "Add hotel review metadata",
"type": "boolean",
"description": "Save one extra hotelReviewMetadata record per hotel with total review count, popular topics, reviewer types, languages, and time-of-year breakdowns.",
"default": false
},
"rowsPerPage": {
"title": "Reviews per request",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "How many reviews to request from Booking.com at once. Higher values reduce the number of requests; lower values avoid fetching unnecessary reviews when Reviews per hotel is small. Maximum is 100.",
"default": 25
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional proxy settings. For larger runs, Apify Proxy is recommended. The Actor uses a sticky proxy session per hotel with a matching mobile device fingerprint."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```