# Booking Reviews Scraper (`web_wanderer/booking-reviews-scraper`) Actor Pull reviews from any Booking.com hotel or attraction. Get ratings, full review text, trip details, and replies from the property. Filter by language, score, or traveler type and get it all back as clean data. - **URL**: https://apify.com/web\_wanderer/booking-reviews-scraper.md - **Developed by:** [Billy](https://apify.com/web_wanderer) (community) - **Categories:** Travel, Integrations, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 reviews 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 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 Pull thousands of public Booking.com reviews from any hotel or attraction page in one run. Just paste the URLs, set your filters, and the actor returns clean, structured review data. ### What it does - Reads any Booking.com hotel or attraction URL. - Fetches public review data and returns a structured dataset ready to export as JSON, CSV or Excel. ### Why people use it - Track brand sentiment and reputation across thousands of properties. - Build review-aggregator features into a travel app. - Run academic studies on tourism and guest experience. - Spot recurring complaints in your own portfolio of hotels. ### Features - Two verticals supported: stays (hotels) and attractions. - Mix any number of URLs in a single run, both verticals together. - Filter by sort order, language, score band, customer type, time of year, free-text search. - Per-property review limits to control your run. - Privacy-aware output: a single toggle hides reviewer name, country, avatar. - Reviews come with rating (normalised to a 0-10 scale), structured sentiment (positive/negative text), photos, partner reply, helpful votes and more. ### Example input ```json { "property_urls": [ "https://www.booking.com/hotel/fr/select-paris.en-gb.html", "https://www.booking.com/attractions/fr/prjyfitkuhfz-1-day-disneyland-paris-ticket.en-gb.html" ], "reviews_limit": 50, "reviews_sort": "NEWEST_FIRST", "reviews_language": ["en"], "reviews_score":"", "include_personal_data": false } ```` ### Example output Reviewer fields are nullified by default. Switch on **Include personal information** to receive them. ```json { "review_id": "0c31605c15f5df2d", "vertical": "stays", "property_id": "180337", "property_url": "https://www.booking.com/hotel/fr/select-paris.en-gb.html", "rating": 9.0, "rating_raw": 9.0, "rating_scale_max": 10, "title": null, "positive_text": "Personnel adorable, emplacement parfait, calme, très confortable", "negative_text": null, "text": null, "language": "fr", "created_at": "2026-05-15T05:42:40+00:00", "posted_on_label": null, "helpful_votes": 0, "is_approved": true, "is_translatable": true, "has_photos": false, "photo_urls": [], "partner_reply": null, "trip_customer_type": "COUPLES", "trip_room_name": "Small Double Room with Winter Garden View", "trip_checkin_date": "2026-05-09", "trip_checkout_date": "2026-05-14", "trip_num_nights": 5, "trip_partner_types": [], "reviewer_name": null, "reviewer_country_code": null, "reviewer_country_name": null, "reviewer_avatar_url": null, "reviewer_guest_type": null, "reviewer_is_anonymous": false, "scraped_at": "2026-05-15T07:41:41.068940+00:00" } ``` With **Include personal information** switched on, the same record would show: ```json { "review_id": "0c31605c15f5df2d", "vertical": "stays", "property_id": "180337", "property_url": "https://www.booking.com/hotel/fr/select-paris.en-gb.html", "rating": 9.0, "rating_raw": 9.0, "rating_scale_max": 10, "title": null, "positive_text": "Personnel adorable, emplacement parfait, calme, très confortable", "negative_text": null, "text": null, "language": "fr", "created_at": "2026-05-15T05:42:40+00:00", "posted_on_label": null, "helpful_votes": 0, "is_approved": true, "is_translatable": true, "has_photos": false, "photo_urls": [], "partner_reply": null, "trip_customer_type": "COUPLES", "trip_room_name": "Small Double Room with Winter Garden View", "trip_checkin_date": "2026-05-09", "trip_checkout_date": "2026-05-14", "trip_num_nights": 5, "trip_partner_types": [], "reviewer_name": "Dorothée", "reviewer_country_code": "ch", "reviewer_country_name": "Switzerland", "reviewer_avatar_url": "https://xx.bstatic.com/static/img/review/avatars/ava-d.png", "reviewer_guest_type": "Couple", "reviewer_is_anonymous": false, "scraped_at": "2026-05-15T07:41:41.068940+00:00" } ``` ### Use cases - Reputation monitoring for hotel chains. - Competitive intelligence on neighbouring properties. - Sentiment analysis pipelines feeding into a dashboard. - Building a custom review aggregator for a niche destination. - Tourism research and academic studies. ### Privacy and personal information Booking.com reviews include the guest first name, country and avatar. By default this actor returns those fields as `null`. Flip the **Include personal information** input to `true` to opt in. If you do collect personal data, you become a data controller under the GDPR. Make sure you have a lawful basis to process and store it. ### Your responsibility You are responsible for how you use the scraped data. Respect Booking.com's Terms of Service and your local laws on data protection. Do not use the data to spam, defame or otherwise harm reviewers or property owners. ### Limitations - Cars, flights and taxis do not expose per-product reviews on Booking.com. Those URLs are skipped with a warning. - Stays reviews use the positive/negative split (`positive_text`, `negative_text`) while attractions use a single `text` field. - Some properties may return few or no reviews depending on Booking.com availability and the filters you selected. - The `language` field uses Booking.com's own codes. You may see codes like `xu` or `el` — those are valid Booking.com language identifiers. ### Tips - Start small. Run with two or three URLs and a low **Reviews per property** to validate your filter combination. - The actor handles pagination automatically. - For stays, set a `language` filter to dramatically reduce noise on multilingual properties. - Mixing both vertical types in one run is supported. Cars, flights and taxis do not expose per-product reviews and will be skipped with a warning. ### Support If something looks off, please open an issue on the actor's issues page with: - the URL you tried, - the input JSON you used, - a copy of the run log. Happy scraping. # Actor input Schema ## `property_urls` (type: `array`): Booking.com hotel or attraction URLs to scrape reviews from. Both `/hotel/...` and `/attractions/...` URLs are supported and can be mixed in the same run. Cars, flights and taxis are not supported on Booking.com (no per-product reviews). ## `reviews_limit` (type: `integer`): Maximum number of reviews to scrape per property. Set to 0 for unlimited (capped only by what Booking.com returns). ## `reviews_sort` (type: `string`): How to sort reviews returned by Booking.com. ## `reviews_score` (type: `string`): Keep only reviews in the selected score band. Mapped to 9+, 7-9, 5-7, 3-5 and 1-3 for stays, and to 5/4/3/2/1 stars for attractions. ## `reviews_language` (type: `array`): ISO 639-1 codes (e.g. `en`, `fr`, `de`). Reviews not written in one of the selected languages are filtered out by Booking.com. Leave empty to include all. ## `reviews_search_text` (type: `string`): Keep only reviews whose body contains this text (case-insensitive substring match performed by Booking.com). ## `reviews_customer_type` (type: `string`): Filter stays reviews by guest trip type. Ignored for attractions. ## `reviews_time_of_year` (type: `string`): Filter reviews by the season the guest visited. ## `hide_anonymous_reviews` (type: `boolean`): Drop reviews that have no reviewer name. Attractions only. ## `hide_empty_reviews` (type: `boolean`): Drop reviews that contain only a numeric rating with no text body. Attractions only. ## `include_personal_data` (type: `boolean`): If enabled, the actor will return reviewer personal information such as the name, country, avatar and guest type. By default these fields are returned as `null`. Personal data is subject to GDPR and similar regulations - make sure you have a lawful basis to process it. ## Actor input object example ```json { "property_urls": [ "https://www.booking.com/hotel/fr/select-paris.en-gb.html", "https://www.booking.com/attractions/fr/prjyfitkuhfz-1-day-disneyland-paris-ticket.en-gb.html" ], "reviews_limit": 50, "reviews_sort": "MOST_RELEVANT", "reviews_score": "", "reviews_language": [], "reviews_search_text": "", "reviews_customer_type": "", "reviews_time_of_year": "", "hide_anonymous_reviews": false, "hide_empty_reviews": false, "include_personal_data": false } ``` # Actor output Schema ## `reviews` (type: `string`): Default dataset containing one row per scraped review. # 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 = { "property_urls": [ "https://www.booking.com/hotel/fr/select-paris.en-gb.html", "https://www.booking.com/attractions/fr/prjyfitkuhfz-1-day-disneyland-paris-ticket.en-gb.html" ] }; // Run the Actor and wait for it to finish const run = await client.actor("web_wanderer/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 = { "property_urls": [ "https://www.booking.com/hotel/fr/select-paris.en-gb.html", "https://www.booking.com/attractions/fr/prjyfitkuhfz-1-day-disneyland-paris-ticket.en-gb.html", ] } # Run the Actor and wait for it to finish run = client.actor("web_wanderer/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 '{ "property_urls": [ "https://www.booking.com/hotel/fr/select-paris.en-gb.html", "https://www.booking.com/attractions/fr/prjyfitkuhfz-1-day-disneyland-paris-ticket.en-gb.html" ] }' | apify call web_wanderer/booking-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=web_wanderer/booking-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Booking Reviews Scraper", "description": "Pull reviews from any Booking.com hotel or attraction. Get ratings, full review text, trip details, and replies from the property. Filter by language, score, or traveler type and get it all back as clean data.", "version": "0.1", "x-build-id": "INBipmuzE7smoEa9v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/web_wanderer~booking-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-web_wanderer-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/web_wanderer~booking-reviews-scraper/runs": { "post": { "operationId": "runs-sync-web_wanderer-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/web_wanderer~booking-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-web_wanderer-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": [ "property_urls" ], "properties": { "property_urls": { "title": "Property URLs", "uniqueItems": true, "type": "array", "description": "Booking.com hotel or attraction URLs to scrape reviews from. Both `/hotel/...` and `/attractions/...` URLs are supported and can be mixed in the same run. Cars, flights and taxis are not supported on Booking.com (no per-product reviews).", "items": { "type": "string" } }, "reviews_limit": { "title": "Reviews per property", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to scrape per property. Set to 0 for unlimited (capped only by what Booking.com returns).", "default": 50 }, "reviews_sort": { "title": "Sort order", "enum": [ "MOST_RELEVANT", "NEWEST_FIRST", "OLDEST_FIRST", "SCORE_DESC", "SCORE_ASC" ], "type": "string", "description": "How to sort reviews returned by Booking.com.", "default": "MOST_RELEVANT" }, "reviews_score": { "title": "Score band", "enum": [ "", "SUPERB", "GOOD", "PASSABLE", "POOR", "VERY_POOR" ], "type": "string", "description": "Keep only reviews in the selected score band. Mapped to 9+, 7-9, 5-7, 3-5 and 1-3 for stays, and to 5/4/3/2/1 stars for attractions.", "default": "" }, "reviews_language": { "title": "Languages", "uniqueItems": true, "type": "array", "description": "ISO 639-1 codes (e.g. `en`, `fr`, `de`). Reviews not written in one of the selected languages are filtered out by Booking.com. Leave empty to include all.", "default": [], "items": { "type": "string" } }, "reviews_search_text": { "title": "Search text", "type": "string", "description": "Keep only reviews whose body contains this text (case-insensitive substring match performed by Booking.com).", "default": "" }, "reviews_customer_type": { "title": "Customer type (stays only)", "enum": [ "", "FAMILIES", "COUPLES", "GROUP_OF_FRIENDS", "SOLO_TRAVELLERS", "BUSINESS_TRAVELLERS" ], "type": "string", "description": "Filter stays reviews by guest trip type. Ignored for attractions.", "default": "" }, "reviews_time_of_year": { "title": "Time of year", "enum": [ "", "MAR_MAY", "JUN_AUG", "SEP_NOV", "DEC_FEB" ], "type": "string", "description": "Filter reviews by the season the guest visited.", "default": "" }, "hide_anonymous_reviews": { "title": "Hide anonymous reviews (attractions only)", "type": "boolean", "description": "Drop reviews that have no reviewer name. Attractions only.", "default": false }, "hide_empty_reviews": { "title": "Hide empty reviews (attractions only)", "type": "boolean", "description": "Drop reviews that contain only a numeric rating with no text body. Attractions only.", "default": false }, "include_personal_data": { "title": "Include personal information", "type": "boolean", "description": "If enabled, the actor will return reviewer personal information such as the name, country, avatar and guest type. By default these fields are returned as `null`. Personal data is subject to GDPR and similar regulations - make sure you have a lawful basis to process it.", "default": false } } }, "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 } } } } } } } } } } ```