# Booking.com Scraper - Hotels, Prices & Reviews (`memo23/booking-scraper`) Actor Scrape Booking.com hotels by destination: prices, star ratings, guest review scores, GPS coordinates, room types, photos and booking URLs. Fast, no browser, JSON/CSV. - **URL**: https://apify.com/memo23/booking-scraper.md - **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community) - **Categories:** Travel, AI, Agents - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 hotel 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 Scraper 🏨 Scrape **Booking.com** hotels and accommodations by destination — prices, ratings, guest review scores, coordinates, room types, photos, cancellation policies, and direct booking URLs. Fast, HTTP-only, and structured JSON/CSV/Excel out. ![Booking.com Scraper](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-booking.png) ### Why use Booking.com Scraper? - **Search any destination** — city, region, country, or a specific hotel name. - **Rich per-hotel data** — name, star rating, guest review score & count, total & per-night price, room type, bed/bathroom counts, GPS coordinates, full address, photo, and the direct Booking.com URL. - **Full control** — set check-in/check-out dates, guests, rooms, currency, language, sort order, price range, star filters, and property type. - **Unlimited results** — paginate through every matching property, not just the first page. - **No login, no browser** — talks directly to Booking's data API, so runs are fast and cheap. - **Pay only for what you scrape** — pay-per-result pricing, no monthly rental. ### What data can you extract from Booking.com? | Field | Type | Description | |-------|------|-------------| | name | string | Hotel or property name | | hotelId | number | Booking.com internal hotel ID | | ufi | number | Booking.com destination (city) ID | | url | string | Direct Booking.com hotel page URL | | propertyType | number | Accommodation type ID (204 = Hotel, 201 = Apartment, …) | | address | string | Street address | | city | string | City | | countryCode | string | ISO country code | | latitude | number | GPS latitude | | longitude | number | GPS longitude | | starRating | number | Star rating (1–5) | | reviewScore | number | Guest review score (0–10) | | reviewScoreWord | string | Rating label (e.g. "Exceptional", "Very Good") | | reviewCount | number | Total number of guest reviews | | price | number | Total price for the stay (numeric) | | priceFormatted | string | Total price, formatted with currency symbol | | priceBeforeDiscount | number | Original price before discount, if any | | currency | string | Currency code (USD, EUR, GBP, …) | | roomType | string | Recommended room/unit type | | bedrooms | number | Number of bedrooms | | bathrooms | number | Number of bathrooms | | beds | number | Total number of beds | | freeCancellation | boolean | Whether free cancellation is available | | noPrepayment | boolean | Whether no-prepayment is available | | petsAllowed | boolean | Whether pets are allowed for free | | mealPlan | string | Included meal plan text, if any | | isSustainable | boolean | Whether the property has a sustainability certification | | distanceFromCenter | string | Distance from city centre | | photoUrl | string | Main hotel photo URL | | description | string | Short property description, if available | | checkin / checkout | string | The searched stay dates | | scrapedAt | string | ISO 8601 timestamp of collection | ### Use cases - **Rate & availability monitoring** — track competitor hotel prices across dates and markets. - **Travel content & metasearch** — power a hotel directory, deals site, or comparison tool. - **Market research** — analyse pricing, star ratings, and review scores across a destination. - **Lead lists** — build accommodation-partner prospect lists with locations and contact-ready URLs. - **Data science** — feed structured hotel data into pricing models and dashboards. ### How to scrape Booking.com hotels 1. Set **Destination** to a city, region, country, or hotel name (e.g. `London`, `Paris, France`, `The Savoy`). 2. Choose your **check-in** and **check-out** dates (defaults to tomorrow + 2 nights). 3. Set guests, rooms, and any filters — sort order, price range, star rating, property type, currency. 4. Set **Max results** (0 = unlimited) and run. 5. Download the results as JSON, CSV, Excel, HTML, or XML — one row per property. ### Input configuration | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | locationQuery | string | — | **Required.** City, region, country, or hotel name to search. | | checkin | string | tomorrow | Check-in date, `YYYY-MM-DD`. | | checkout | string | check-in + 2 days | Check-out date, `YYYY-MM-DD`. | | adults | integer | 2 | Number of adult guests. | | rooms | integer | 1 | Number of rooms. | | children | integer | 0 | Number of children. | | maxResults | integer | 100 | Max hotels to return. `0` = unlimited. | | sortBy | enum | popularity | `popularity`, `price`, `review_score`, `class`, `distance`. | | propertyType | enum | any | `hotels`, `apartments`, `hostels`, `guesthouses`, `villas`, `resorts`, `bnb`. | | currency | string | USD | Currency code for prices (USD, EUR, GBP, …). | | language | string | en-us | Language code (en-us, de, fr, es, it, …). | | minPrice | integer | — | Minimum price-per-night filter. | | maxPrice | integer | — | Maximum price-per-night filter. | | starsFilter | string[] | — | Star ratings to include, e.g. `["4","5"]`. | | proxyConfiguration | object | Residential | Proxy settings. Residential is strongly recommended. | ### Output sample ```json { "name": "Sansi Pedralbes", "hotelId": 91017, "ufi": -372490, "url": "https://www.booking.com/hotel/es/sansipedralbes.html", "propertyType": 204, "address": "Avenida Pearson, 1-3", "city": "Barcelona", "countryCode": "es", "latitude": 41.3937882727419, "longitude": 2.1118788421154, "starRating": 4, "reviewScore": 9.7, "reviewScoreWord": "Exceptional", "reviewCount": 567, "price": 790.42, "priceFormatted": "€ 790", "currency": "EUR", "roomType": "Double Room", "bedrooms": 0, "bathrooms": 0, "beds": 2, "freeCancellation": true, "noPrepayment": true, "petsAllowed": false, "isSustainable": false, "distanceFromCenter": "4.9 km from downtown", "photoUrl": "https://cf.bstatic.com/xdata/images/hotel/square600/36537530.jpg", "checkin": "2026-09-10", "checkout": "2026-09-12", "scrapedAt": "2026-07-12T04:05:09.746Z" } ```` ### FAQ **Do I need a Booking.com account or API key?** No. The scraper pulls public search-results data directly — no login, cookies, or key required. **Which fields need a proxy?** Residential proxies are strongly recommended for reliable results and correct regional pricing. The default proxy configuration uses Apify Residential. **Why is `roomType` / `mealPlan` sometimes empty?** Search-results pages expose a recommended room and a summary. Fields like full room lists, amenities, and reviews live on the individual hotel page — see *Additional services* below for a detail/reviews-focused run. **Can I control the currency and language?** Yes — set the `currency` (e.g. `EUR`, `GBP`) and `language` (e.g. `fr`, `de`) inputs. **How many results can I get?** Set `maxResults` to `0` for unlimited — the scraper paginates through every matching property for your search. ### Support Found a bug or need a field added? Open an issue on the Actor's **Issues** tab and we'll take a look. ### Additional services Need **individual hotel details** (full room matrix, amenities, all photos) or **guest reviews** at scale? Those are available as companion runs on the same fast, HTTP-only pipeline — get in touch via the Issues tab. ### Explore more scrapers Check the Apify Store for more travel and accommodation data tools. ### ⚠️ Disclaimer This Actor scrapes only publicly available information from Booking.com. It does not log in, bypass access controls, or collect personal data. You are responsible for how you use the extracted data, including compliance with Booking.com's Terms of Service, applicable laws (such as GDPR), and any copyright or database rights. Use the data lawfully and ethically. ### SEO Keywords booking.com scraper, booking scraper, hotel scraper, booking.com api, scrape booking.com, hotel price scraper, accommodation data, hotel data extraction, booking.com data, travel data scraper, hotel rates api, hotel availability scraper, booking hotels export, hotel review scraper, accommodation prices, hotel listings scraper # Actor input Schema ## `locationQuery` (type: `string`): City, region, country, or hotel name to search (e.g. 'London', 'Paris, France', 'The Savoy London'). ## `checkin` (type: `string`): Check-in date in YYYY-MM-DD format. Defaults to tomorrow. ## `checkout` (type: `string`): Check-out date in YYYY-MM-DD format. Defaults to 2 days after check-in. ## `adults` (type: `integer`): Number of adult guests. ## `rooms` (type: `integer`): Number of rooms. ## `children` (type: `integer`): Number of children. ## `maxResults` (type: `integer`): Maximum number of hotels to return. Set to 0 for unlimited (all available results). ## `sortBy` (type: `string`): Sort order for search results. ## `propertyType` (type: `string`): Restrict results to a single accommodation type. ## `currency` (type: `string`): Currency code for prices (e.g. USD, EUR, GBP). ## `language` (type: `string`): Language code for results (e.g. en-us, de, fr, es, it). ## `minPrice` (type: `integer`): Minimum price per night filter (in the selected currency). ## `maxPrice` (type: `integer`): Maximum price per night filter (in the selected currency). ## `starsFilter` (type: `array`): Filter by hotel star rating. Enter star values (1-5) to include. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies are strongly recommended for Booking.com. ## Actor input object example ```json { "locationQuery": "London", "adults": 2, "rooms": 1, "children": 0, "maxResults": 100, "sortBy": "popularity", "propertyType": "", "currency": "USD", "language": "en-us", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "locationQuery": "London", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("memo23/booking-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 = { "locationQuery": "London", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("memo23/booking-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 '{ "locationQuery": "London", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call memo23/booking-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=memo23/booking-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Booking.com Scraper - Hotels, Prices & Reviews", "description": "Scrape Booking.com hotels by destination: prices, star ratings, guest review scores, GPS coordinates, room types, photos and booking URLs. Fast, no browser, JSON/CSV.", "version": "0.0", "x-build-id": "3DxVT1aEbERmaYoDK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~booking-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-booking-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/memo23~booking-scraper/runs": { "post": { "operationId": "runs-sync-memo23-booking-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/memo23~booking-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-booking-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": [ "locationQuery" ], "properties": { "locationQuery": { "title": "Destination", "type": "string", "description": "City, region, country, or hotel name to search (e.g. 'London', 'Paris, France', 'The Savoy London')." }, "checkin": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Defaults to tomorrow." }, "checkout": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. Defaults to 2 days after check-in." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of rooms.", "default": 1 }, "children": { "title": "Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of children.", "default": 0 }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum number of hotels to return. Set to 0 for unlimited (all available results).", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "popularity", "price", "review_score", "class", "distance" ], "type": "string", "description": "Sort order for search results.", "default": "popularity" }, "propertyType": { "title": "Property type", "enum": [ "", "hotels", "apartments", "hostels", "guesthouses", "villas", "resorts", "bnb" ], "type": "string", "description": "Restrict results to a single accommodation type.", "default": "" }, "currency": { "title": "Currency", "type": "string", "description": "Currency code for prices (e.g. USD, EUR, GBP).", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Language code for results (e.g. en-us, de, fr, es, it).", "default": "en-us" }, "minPrice": { "title": "Min price per night", "type": "integer", "description": "Minimum price per night filter (in the selected currency)." }, "maxPrice": { "title": "Max price per night", "type": "integer", "description": "Maximum price per night filter (in the selected currency)." }, "starsFilter": { "title": "Star rating filter", "type": "array", "description": "Filter by hotel star rating. Enter star values (1-5) to include.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended for Booking.com.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```