# Booking.com Hotels Scraper (`fetch_cat/booking-com-hotels-scraper`) Actor Extract Booking.com hotel listings, prices, ratings, reviews, availability text, and hotel URLs for travel market research. - **URL**: https://apify.com/fetch\_cat/booking-com-hotels-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Travel, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $12.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. 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 Hotels Scraper Booking.com Hotels Scraper extracts public hotel search results from Booking.com: hotel names, listing URLs, prices, ratings, reviews, star counts, addresses, room/availability text, taxes and image URLs. Use it to monitor hotel supply, compare destinations, build travel-market datasets, and refresh hospitality research without manually copying search results. ### At a glance - **Source:** Public Booking.com hotel search result pages. - **Best for:** Travel market research, OTA monitoring, hotel lead lists, price snapshots, and destination supply analysis. - **Output:** One dataset row per hotel listing. - **Proxy mode:** Residential proxy by default because Booking.com commonly challenges datacenter traffic. - **Details mode:** Optional detail-page enrichment for coordinates and amenities. ### What does this actor do? Give the actor a destination such as `Lisbon`, `Porto`, or `New York`, choose guest/stay settings, and it saves the matching hotel cards from Booking.com. The scraper is designed for recurring public listing snapshots, not account-only data, reservations, or private traveler information. ### Who is it for? - **Travel analysts** comparing hotel supply and public prices across destinations. - **Hospitality operators** checking competitor ratings, review counts, and offer text. - **Revenue-management teams** collecting recurring market snapshots. - **Agencies and data teams** feeding dashboards, spreadsheets, and internal research pipelines. ### Input example ```json { "destination": "Lisbon", "maxItems": 25, "currency": "USD", "language": "en-us", "adults": 2, "children": 0, "rooms": 1, "includeDetails": false } ```` ### Input settings | Key | Type | Description | | --- | --- | --- | | `destination` | string | City, region, landmark, or hotel search text. | | `checkIn` | string | Optional check-in date in `YYYY-MM-DD` format. | | `checkOut` | string | Optional check-out date in `YYYY-MM-DD` format. | | `adults` | integer | Number of adult guests. | | `children` | integer | Number of children. | | `rooms` | integer | Number of rooms. | | `currency` | string | Three-letter currency code for displayed prices. | | `language` | string | Booking.com locale parameter, for example `en-us`. | | `countryCode` | string | Optional residential proxy country code. | | `maxItems` | integer | Maximum hotel listings to save. | | `includeDetails` | boolean | Open detail pages to collect coordinates and amenities. Slower and more expensive. | ### Output example ```json { "search": "Lisbon", "destination": "Lisbon", "checkIn": null, "checkOut": null, "hotelName": "Example Lisbon Hotel", "url": "https://www.booking.com/hotel/pt/example.html", "bookingId": "example", "address": "Lisbon, Portugal", "city": null, "country": null, "coordinates": null, "rating": 8.7, "reviewCount": 1234, "stars": 4, "price": "US$120", "currency": "USD", "taxesAndFeesText": "Includes taxes and fees", "availabilityText": "Only 2 rooms left", "roomSummary": "Standard double room", "amenities": [], "imageUrls": ["https://cf.bstatic.com/..."] , "rank": 1, "scrapedAt": "2026-07-12T09:00:00.000Z" } ``` ### Output fields | Field | Description | | --- | --- | | `search`, `destination` | Search text used for the run. | | `checkIn`, `checkOut` | Stay dates from input, when supplied. | | `hotelName` | Hotel listing name. | | `url` | Canonical Booking.com hotel URL. | | `bookingId` | ID parsed from the hotel URL when available. | | `address` | Address/location text from the listing card. | | `city`, `country` | Reserved location fields. | | `coordinates` | Latitude/longitude when detail enrichment finds them. | | `rating`, `reviewCount`, `stars` | Public score, review count, and star count. | | `price`, `currency` | Displayed price text and selected currency. | | `taxesAndFeesText` | Taxes/fees text shown on the result card. | | `availabilityText` | Availability or urgency text shown by Booking.com. | | `roomSummary` | Room/offer summary from the card. | | `amenities` | Amenities from detail pages when `includeDetails` is enabled. | | `imageUrls` | Listing image URLs. | | `rank` | Position in the current search result page. | | `scrapedAt` | ISO timestamp for the scrape. | ### Pricing This actor uses pay-per-event pricing: | Event | Price | | --- | --- | | Start | $0.005 per run | | Hotel scraped | Free $0.0046, Bronze $0.004, Silver $0.00312, Gold $0.0024, Platinum $0.0016, Diamond $0.00112 per hotel | Residential proxy traffic is required for reliability on Booking.com and is included in actor operating costs. ### Verified public example tasks These Apify Store tasks use small, QA-verified inputs and can be opened or cloned directly: - [Collect Lisbon Hotel Details](https://apify.com/fetch_cat/booking-com-hotels-scraper/tasks/collect-lisbon-hotel-details) — verified run `JdUYLAJueiWm1jmnL` produced 3 dataset items. - [Research Tokyo Hotels In Jpy](https://apify.com/fetch_cat/booking-com-hotels-scraper/tasks/research-tokyo-hotels-in-jpy) — verified run `9xb8jArnNqUFjaXo8` produced 5 dataset items. - [Search Family Hotels Barcelona](https://apify.com/fetch_cat/booking-com-hotels-scraper/tasks/search-family-hotels-barcelona) — verified run `hHnQyggjC0dUZiGa0` produced 5 dataset items. - [Search Lisbon Hotels](https://apify.com/fetch_cat/booking-com-hotels-scraper/tasks/search-lisbon-hotels) — verified run `YW9RWP7KhnEpAen8E` produced 5 dataset items. - [Search Paris Hotels In Euros](https://apify.com/fetch_cat/booking-com-hotels-scraper/tasks/search-paris-hotels-in-euros) — verified run `MtXIMH7eI7GKuQdIm` produced 5 dataset items. ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/booking-com-hotels-scraper').call({ destination: 'Lisbon', maxItems: 10 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('$APIFY_TOKEN') run = client.actor('fetch_cat/booking-com-hotels-scraper').call(run_input={'destination': 'Lisbon', 'maxItems': 10}) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~booking-com-hotels-scraper/runs?token=$APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"destination":"Lisbon","maxItems":10}' ``` ### MCP / AI-agent usage You can use this actor from AI tools through the Apify MCP Server. Configure the Apify MCP server with your Apify API token, then ask your agent to run `booking-com-hotels-scraper` with a destination, maximum item count, and optional dates. The dataset URL returned by Apify can be used directly in spreadsheets, notebooks, or downstream automations. Claude CLI add command: ```bash claude mcp add apify -- npx -y @apify/actors-mcp-server --actors fetch_cat/booking-com-hotels-scraper ``` Example MCP JSON config: ```json { "mcpServers": { "apify": { "command": "npx", "args": ["-y", "@apify/actors-mcp-server", "--actors", "fetch_cat/booking-com-hotels-scraper"], "env": { "APIFY_TOKEN": "$APIFY_TOKEN" } } } } ``` Example prompts: - "Run the Booking.com Hotels Scraper for Lisbon with 10 hotels and USD prices." - "Collect 25 Booking.com hotel listings for Porto and summarize the highest-rated properties." - "Scrape Booking.com hotels for New York with two adults and return hotel names, prices, and ratings." ### Tips and limits - Keep `maxItems` small for frequent monitoring runs, then scale once your query is stable. - Use `includeDetails` only when coordinates or amenities are required. - Booking.com may change layout or show different text by locale, currency, dates, and user location. - The actor only collects public data visible without signing in. ### Legality and responsible use This actor is intended for public web data and market research. Make sure your use case complies with Booking.com's terms, applicable laws, and privacy rules. Do not use it to collect personal traveler data or perform abusive traffic patterns. ### FAQ **Can I scrape hotel reviews?** This actor focuses on hotel listings. Use a reviews-specific actor for review text. **Why are prices text, not normalized numbers?** Booking.com displays prices with localized symbols, taxes, and offer labels. The actor preserves the visible text so users can decide how to normalize it. **Why use residential proxies?** Booking.com commonly challenges plain datacenter traffic; residential proxy routing improves reliability. **What should I send to support?** Include the run ID or run URL, input JSON, expected output, actual output, and a reproducible public Booking.com search URL when possible. ### Related actors - [Booking.com Reviews Scraper](https://apify.com/fetch_cat/booking-reviews-scraper) - [Agoda Hotels Scraper](https://apify.com/fetch_cat/agoda-hotels-scraper) - [Airbnb Listings Scraper](https://apify.com/fetch_cat/airbnb-listings-scraper) - [Google Flights Scraper](https://apify.com/fetch_cat/google-flights-scraper) ### Support If a run fails or output looks wrong, open an Apify issue with the run ID/run URL, the exact input JSON, expected output, actual output, what you received, and any public URL that reproduces the same Booking.com result page. ### Changelog - 2026-07-16 - Feature: Added ready-to-run example tasks on the Apify Store - 2026-07-16 - Feature: Launched booking com hotels scraper for public Apify Store users. # Actor input Schema ## `destination` (type: `string`): City, region, landmark, or hotel search text. ## `checkIn` (type: `string`): Optional check-in date in YYYY-MM-DD format. ## `checkOut` (type: `string`): Optional check-out date in YYYY-MM-DD format. ## `adults` (type: `integer`): Number of adult guests. ## `children` (type: `integer`): Number of children. ## `rooms` (type: `integer`): Number of rooms. ## `currency` (type: `string`): Three-letter currency code for displayed prices. ## `language` (type: `string`): Booking.com language parameter, for example en-us. ## `countryCode` (type: `string`): Optional ISO country code for the residential proxy exit country. ## `maxItems` (type: `integer`): Maximum number of hotel listings to save. ## `includeDetails` (type: `boolean`): Open each hotel page for coordinates and more amenities. This is slower and costs more proxy bandwidth. ## Actor input object example ```json { "destination": "Lisbon", "adults": 2, "children": 0, "rooms": 1, "currency": "USD", "language": "en-us", "maxItems": 5, "includeDetails": false } ``` # Actor output Schema ## `overview` (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 = { "destination": "Lisbon", "currency": "USD", "language": "en-us", "maxItems": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/booking-com-hotels-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 = { "destination": "Lisbon", "currency": "USD", "language": "en-us", "maxItems": 5, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/booking-com-hotels-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 '{ "destination": "Lisbon", "currency": "USD", "language": "en-us", "maxItems": 5 }' | apify call fetch_cat/booking-com-hotels-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/booking-com-hotels-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Booking.com Hotels Scraper", "description": "Extract Booking.com hotel listings, prices, ratings, reviews, availability text, and hotel URLs for travel market research.", "version": "0.1", "x-build-id": "9lFl1GbaUI8UFXwZe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~booking-com-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-booking-com-hotels-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/fetch_cat~booking-com-hotels-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-booking-com-hotels-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/fetch_cat~booking-com-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-booking-com-hotels-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": [ "destination" ], "properties": { "destination": { "title": "Destination", "type": "string", "description": "City, region, landmark, or hotel search text." }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Optional check-in date in YYYY-MM-DD format." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Optional check-out date in YYYY-MM-DD format." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of children.", "default": 0 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of rooms.", "default": 1 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for displayed prices.", "default": "USD" }, "language": { "title": "Language/locale", "type": "string", "description": "Booking.com language parameter, for example en-us.", "default": "en-us" }, "countryCode": { "title": "Proxy country code", "type": "string", "description": "Optional ISO country code for the residential proxy exit country." }, "maxItems": { "title": "Maximum hotels", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of hotel listings to save.", "default": 10 }, "includeDetails": { "title": "Include hotel detail pages", "type": "boolean", "description": "Open each hotel page for coordinates and more amenities. This is slower and costs more proxy bandwidth.", "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 } } } } } } } } } } ```