# Booking Reviews Scraper - Fast & Browserless (`mof1re/booking-reviews-scraper-browserless`) Actor ⚡ Scrapes Booking.com hotel reviews via raw HTTP requests — no browser, no headless Chrome. Structured output: ratings, guest info, stay dates, hotel replies, keyword filtering, per-category rating breakdowns. Built for speed and clean data. - **URL**: https://apify.com/mof1re/booking-reviews-scraper-browserless.md - **Developed by:** [Vladimir Efimenco](https://apify.com/mof1re) (community) - **Categories:** SEO tools, Lead generation, Travel - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 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 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 | ⚡ Fast Browserless Browserless Booking.com review scraper built on the site's internal review API, not a headless browser. Returns full review content — positive, negative, and title — alongside guest details, stay data, and hotel-wide rating breakdowns. ### ⚡ Why this one - **Full dataset, not a summary** — every review comes with the complete positive/negative text split, guest profile info, room and stay details, and the hotel's reply where present. - **Hotel-wide rating breakdown included** — per-category scores (cleanliness, comfort, location, etc.) are attached to every review, not buried in a separate call. - **Flexible filtering** — sort order and translation language match what's available on the live site, plus keyword search across title, positive, and negative text. - **Batch by design** — scrape multiple hotels in a single run, with a configurable result cap per hotel or unlimited collection. - **Proxies included** — proxy pool is built in. You don't need to bring your own. - **Fast** — no browser, no rendering wait. Pure HTTP calls to the same internal API the booking.com frontend uses. ### 📋 Example output ```json [ { "hotel_url": "https://www.booking.com/hotel/cy/flora-apartments.ro.html", "hotel_name": "Flora Hotel Apartments", "accommodation_type": "HOTEL", "review_score": 9.0, "review_approved": true, "review_title": "Very enjoyable weekend break at tha Flora Hotel Appts which was very enjoyable.", "review_positive_text": "This was a short two day break to Protaras for my wife’s birthday.\nMy only slight gripe was the mattresses on the beds.\nI don’t know if they were new but they were very hard.\nWe had two breakfasts and one evening meal which were all delicious\nA special shout out to all the staff who were all brilliant.\nThis was our second short stay at the Flora Hotel Appts and we will definitely be back later in the year.", "review_negative_text": null, "review_reply": "Thank you for choosing Flora Hotel Apartments for your wife's birthday getaway! We are thrilled to hear that you enjoyed your stay with us and found the breakfasts and evening meal delicious. Your feedback on the mattresses is greatly appreciated, and we will look into improving this for your next visit. We are grateful for your kind words about our staff; they work hard to ensure our guests have a memorable experience. We can't wait to welcome you back later this year for another enjoyable stay.", "guest_username": "Brian", "guest_type": "Couple", "guest_reviews": 19, "guest_country": "Cyprus", "guest_country_code": "cy", "guest_avatar": "https://xx.bstatic.com/static/img/review/avatars/ava-b.png", "guest_anonymous": false, "guest_join_date": "2013-06-03", "booking_room": "Standard Apartment", "booking_checkin": "2025-04-04", "booking_checkout": "2025-04-06", "booking_customer_type": "COUPLES", "booking_stay_status": "stayed", "rating_statistics": { "hotel_staff": { "rating_rounded": 9.0, "rating_orig": 9.00786304473877, "name_translated": "Staff" }, "hotel_services": { "rating_rounded": 7.7, "rating_orig": 7.72118091583252, "name_translated": "Facilities" }, "hotel_clean": { "rating_rounded": 8.2, "rating_orig": 8.20839023590088, "name_translated": "Cleanliness" }, "hotel_comfort": { "rating_rounded": 8.1, "rating_orig": 8.10650062561035, "name_translated": "Comfort" }, "hotel_value": { "rating_rounded": 8.5, "rating_orig": 8.52496433258057, "name_translated": "Value for money" }, "hotel_location": { "rating_rounded": 9.2, "rating_orig": 9.24711036682129, "name_translated": "Location" }, "hotel_free_wifi": { "rating_rounded": 8.5, "rating_orig": 8.51440048217773, "name_translated": "Free Wifi" } }, "keyword_match": false, "matched_keywords": {} }, { "hotel_url": "https://www.booking.com/hotel/cy/flora-apartments.ro.html", "hotel_name": "Flora Hotel Apartments", "accommodation_type": "HOTEL", "review_score": 9.0, "review_approved": true, "review_title": null, "review_positive_text": "Great location, right on top of the northern end of the strip, few minutes walk down to the beach. Room was clean, WiFi was stable, staff were polite and attentive. Would happily stay again if a cheap and cheerful place was needed.", "review_negative_text": null, "review_reply": "Thank you for taking the time to share your thoughts! We are thrilled to hear you enjoyed our central location, clean rooms, reliable WiFi, and our attentive staff. It's wonderful to know that you had a pleasant stay with us. We look forward to welcoming you back to Flora Hotel Apartments whenever you need a \"cheap and cheerful\" place in the area. Your kind words mean a lot to us!", "guest_username": "Mark", "guest_type": "Family", "guest_reviews": 14, "guest_country": "United Kingdom", "guest_country_code": "gb", "guest_avatar": "https://graph.facebook.com/v2.9/10157434864745648/picture?type=square&height=64&width=64", "guest_anonymous": false, "guest_join_date": "2016-09-30", "booking_room": "One-Bedroom Apartment", "booking_checkin": "2025-03-29", "booking_checkout": "2025-03-30", "booking_customer_type": "FAMILIES", "booking_stay_status": "stayed", "rating_statistics": { "hotel_staff": { "rating_rounded": 9.0, "rating_orig": 9.00786304473877, "name_translated": "Staff" }, "hotel_services": { "rating_rounded": 7.7, "rating_orig": 7.72118091583252, "name_translated": "Facilities" }, "hotel_clean": { "rating_rounded": 8.2, "rating_orig": 8.20839023590088, "name_translated": "Cleanliness" }, "hotel_comfort": { "rating_rounded": 8.1, "rating_orig": 8.10650062561035, "name_translated": "Comfort" }, "hotel_value": { "rating_rounded": 8.5, "rating_orig": 8.52496433258057, "name_translated": "Value for money" }, "hotel_location": { "rating_rounded": 9.2, "rating_orig": 9.24711036682129, "name_translated": "Location" }, "hotel_free_wifi": { "rating_rounded": 8.5, "rating_orig": 8.51440048217773, "name_translated": "Free Wifi" } }, "keyword_match": false, "matched_keywords": {} }, { "hotel_url": "https://www.booking.com/hotel/cy/flora-apartments.ro.html", "hotel_name": "Flora Hotel Apartments", "accommodation_type": "HOTEL", "review_score": 8.0, "review_approved": true, "review_title": "Nice option for a short stay", "review_positive_text": "Friendly staff", "review_negative_text": "Mattress are very hard", "review_reply": null, "guest_username": "Milos", "guest_type": "Solo traveler", "guest_reviews": 129, "guest_country": "United Kingdom", "guest_country_code": "gb", "guest_avatar": "https://xx.bstatic.com/static/img/review/avatars/ava-m.png", "guest_anonymous": false, "guest_join_date": "2013-03-25", "booking_room": "One-Bedroom Apartment with Pool View", "booking_checkin": "2024-09-27", "booking_checkout": "2024-09-30", "booking_customer_type": "SOLO_TRAVELLERS", "booking_stay_status": "stayed", "rating_statistics": { "hotel_staff": { "rating_rounded": 9.0, "rating_orig": 9.00786304473877, "name_translated": "Staff" }, "hotel_services": { "rating_rounded": 7.7, "rating_orig": 7.72118091583252, "name_translated": "Facilities" }, "hotel_clean": { "rating_rounded": 8.2, "rating_orig": 8.20839023590088, "name_translated": "Cleanliness" }, "hotel_comfort": { "rating_rounded": 8.1, "rating_orig": 8.10650062561035, "name_translated": "Comfort" }, "hotel_value": { "rating_rounded": 8.5, "rating_orig": 8.52496433258057, "name_translated": "Value for money" }, "hotel_location": { "rating_rounded": 9.2, "rating_orig": 9.24711036682129, "name_translated": "Location" }, "hotel_free_wifi": { "rating_rounded": 8.5, "rating_orig": 8.51440048217773, "name_translated": "Free Wifi" } }, "keyword_match": false, "matched_keywords": {} } ] ```` ### 🧾 What you get, per review - Review content — title, positive text, negative text, overall score, approval status - Guest info — username, guest type, review count, country, avatar, anonymity flag, join date - Stay details — room type, check-in/check-out dates, customer type, stay status - Hotel reply — reply message, when the hotel responded - Hotel-wide ratings — category-by-category score breakdown for the hotel - Keyword match — whether and where a search term was found ### 🔧 Input options | Field | Description | |---|---| | `hotelUrls` | One or more Booking.com hotel page URLs | | `maxResults` | Max reviews to collect per hotel. Leave empty to collect all available | | `sort` | Sort order — most relevant, newest, oldest, highest or lowest score | | `lang` | Language Booking auto-translates reviews into (40+ supported) | | `search` | Keywords to filter reviews by — matched against title, positive, and negative text | ### 📊 Data Fields #### 📝 Review Details | Field | Description | |---|---| | `hotel_url` | Booking.com hotel page URL this review belongs to | | `hotel_name` | Name of the hotel | | `accommodation_type` | Type of accommodation (hotel, apartment, etc.) | | `review_score` | Reviewer's overall score for this stay | | `review_approved` | Whether the review passed Booking's approval/moderation | | `review_title` | Review headline | | `review_positive_text` | Positive part of the review | | `review_negative_text` | Negative part of the review | | `review_reply` | Hotel's reply to the review, if any | #### 👤 Guest | Field | Description | |---|---| | `guest_username` | Display name of the reviewer | | `guest_type` | Type of guest (e.g. couple, solo, family) as shown on Booking | | `guest_reviews` | Total number of reviews written by this guest | | `guest_country` | Reviewer's country name | | `guest_country_code` | Reviewer's country code | | `guest_avatar` | URL of the reviewer's avatar image | | `guest_anonymous` | Whether the reviewer chose to stay anonymous | | `guest_join_date` | Date the reviewer joined Booking.com | #### 🛏️ Stay Details | Field | Description | |---|---| | `booking_room` | Room type booked by the guest | | `booking_checkin` | Check-in date of the stay | | `booking_checkout` | Check-out date of the stay | | `booking_customer_type` | Customer type for this booking | | `booking_stay_status` | Status of the stay (e.g. completed) | #### ⭐ Ratings & Matching | Field | Description | |---|---| | `rating_statistics` | Hotel-wide rating breakdown by category (cleanliness, comfort, etc.). Same for every review of a given hotel | | `keyword_match` | True if search keywords were set and at least one matched this review | | `matched_keywords` | Map of matched keyword → field it was found in (title / positive / negative text) | ### 💳 Pricing Pay-per-result. You're charged for reviews actually delivered, not for pages fetched or requests made. ### ⚠️ Notes - Free-tier accounts are capped at a small sample size per run — upgrade to a paid Apify plan for full volume. - Data reflects what's publicly listed on booking.com at the time of the run; the source updates continuously. ### 🔗 See also Need reviews from another platform? Check out: - [Trustpilot Reviews Scraper](https://apify.com/mof1re/trustpilot-scraper-fast-browserlessapif) - [AirBNB Reviews Scraper](https://apify.com/mof1re/mof1re/airbnb-reviews-scraper-browserless) - Same browserless approach, full review + business profile data. # Actor input Schema ## `hotelUrls` (type: `array`): Booking.com hotel page URLs to scrape reviews from. ## `maxResults` (type: `integer`): How many reviews to collect per hotel. Leave empty to get all (free-tier is capped at 50 anyway). ## `sort` (type: `string`): Order in which reviews are fetched from Booking. ## `lang` (type: `string`): Language Booking will auto-translate reviews into. ## `search` (type: `array`): Keywords to tag/flag in reviews (does not filter them out). Every review is still returned, but each one gets marked with keyword\_match and matched\_keywords showing whether/where a keyword was found (title, positive, or negative text). ## Actor input object example ```json { "hotelUrls": [ { "url": "https://www.booking.com/hotel/tr/veyron-hotels-amp-spa.html" } ], "sort": "MOST_RELEVANT", "lang": "en-us", "search": [] } ``` # Actor output Schema ## `jobAds` (type: `string`): No description # 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 = { "hotelUrls": [ { "url": "https://www.booking.com/hotel/tr/veyron-hotels-amp-spa.html" } ], "search": [] }; // Run the Actor and wait for it to finish const run = await client.actor("mof1re/booking-reviews-scraper-browserless").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 = { "hotelUrls": [{ "url": "https://www.booking.com/hotel/tr/veyron-hotels-amp-spa.html" }], "search": [], } # Run the Actor and wait for it to finish run = client.actor("mof1re/booking-reviews-scraper-browserless").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 '{ "hotelUrls": [ { "url": "https://www.booking.com/hotel/tr/veyron-hotels-amp-spa.html" } ], "search": [] }' | apify call mof1re/booking-reviews-scraper-browserless --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mof1re/booking-reviews-scraper-browserless", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Booking Reviews Scraper - Fast & Browserless", "description": "⚡ Scrapes Booking.com hotel reviews via raw HTTP requests — no browser, no headless Chrome. Structured output: ratings, guest info, stay dates, hotel replies, keyword filtering, per-category rating breakdowns. Built for speed and clean data.", "version": "0.1", "x-build-id": "Y7NJxn81gwnvkL2R1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mof1re~booking-reviews-scraper-browserless/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mof1re-booking-reviews-scraper-browserless", "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/mof1re~booking-reviews-scraper-browserless/runs": { "post": { "operationId": "runs-sync-mof1re-booking-reviews-scraper-browserless", "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/mof1re~booking-reviews-scraper-browserless/run-sync": { "post": { "operationId": "run-sync-mof1re-booking-reviews-scraper-browserless", "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": [ "hotelUrls" ], "properties": { "hotelUrls": { "title": "🏨 Hotel URLs", "type": "array", "description": "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" } } } }, "maxResults": { "title": "🔢 Max reviews per hotel", "type": "integer", "description": "How many reviews to collect per hotel. Leave empty to get all (free-tier is capped at 50 anyway)." }, "sort": { "title": "↕️ Sort order", "enum": [ "MOST_RELEVANT", "NEWEST_FIRST", "OLDEST_FIRST", "HIGHEST_SCORE", "LOWEST_SCORE" ], "type": "string", "description": "Order in which reviews are fetched from Booking.", "default": "MOST_RELEVANT" }, "lang": { "title": "🌐 Review language", "enum": [ "en-us", "en-gb", "de", "nl", "fr", "es", "es-ar", "es-mx", "ca", "it", "pt-pt", "pt-br", "no", "fi", "sv", "da", "cs", "hu", "ro", "ja", "zh-cn", "zh-tw", "pl", "el", "ru", "tr", "bg", "ar", "ko", "he", "lv", "uk", "hi", "id", "ms", "th", "et", "hr", "lt", "sk", "sr", "sl", "vi", "tl", "is" ], "type": "string", "description": "Language Booking will auto-translate reviews into.", "default": "en-us" }, "search": { "title": "🔍 Search keywords", "type": "array", "description": "Keywords to tag/flag in reviews (does not filter them out). Every review is still returned, but each one gets marked with keyword_match and matched_keywords showing whether/where a keyword was found (title, positive, or negative text).", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```