Booking.com Scraper — Hotels, Reviews, Calendar & Reviews API
Pricing
from $2.00 / 1,000 hotel search results
Scrape Booking.com hotels, reviews, calendar pricing, photos, facilities & policies via one API. Property-forensics bundle returns 10+ enrichment fields per hotel in a single row. Lean search mode also available at commodity per-place pricing. No login or API key needed.
You can access the Booking.com Scraper — Hotels, Reviews, Calendar & Reviews API programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "1.0", "x-build-id": "OcEusxP9Y2RNgd2fK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~booking-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-booking-com-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/sian.agency~booking-com-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-booking-com-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/sian.agency~booking-com-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-booking-com-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": [ "operation" ], "properties": { "operation": { "title": "Operation", "enum": [ "search", "searchByCoordinates", "hotelDetail", "reviews", "calendarPricing", "forensicsBundle" ], "type": "string", "description": "📋 Which Booking.com endpoint to run. Each run extracts ONE operation. Pick the right tool for the job:\n\n• **Hotel Search** — paginated list of hotels in a city/destination\n• **Hotel Search by Coordinates** — lat/lon based area search\n• **Hotel Detail** — full info for one hotel (address, check-in window, currency)\n• **Hotel Reviews** — paginated reviews for one hotel\n• **Calendar Pricing** — 30-day forward availability + length-of-stay rules\n• **Property Forensics Bundle** — premium: 1 row per hotel = details + photos + top reviews + policies + facilities fused", "default": "search" }, "destinationName": { "title": "🔍 Destination name (for Hotel Search)", "type": "string", "description": "City, region, or neighborhood name. Example: \"Paris\", \"Bali\", \"New York\". The actor resolves it to Booking's internal destination ID automatically." }, "destinationId": { "title": "Destination ID (optional, for Hotel Search)", "type": "string", "description": "Skip auto-resolution by passing Booking.com's internal `dest_id` directly. Use when you know it; saves one upstream call." }, "destinationType": { "title": "Destination type (optional)", "enum": [ "city", "region", "district", "landmark", "airport", "hotel" ], "type": "string", "description": "Booking.com's dest type. Defaults to `city`. Other values: `region`, `district`, `landmark`, `airport`, `hotel`.", "default": "city" }, "latitude": { "title": "📍 Latitude (for Search by Coordinates)", "type": "string", "description": "Decimal latitude. Example: `48.85668` for central Paris." }, "longitude": { "title": "📍 Longitude (for Search by Coordinates)", "type": "string", "description": "Decimal longitude. Example: `2.3514764` for central Paris." }, "hotelId": { "title": "🏨 Hotel ID (for Detail / Reviews / Calendar / Forensics)", "type": "string", "description": "Booking.com hotel ID. Find one from a previous Hotel Search run (each row carries `hotelId`). Example: `15854834`." }, "checkinDate": { "title": "Check-in date (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Check-in date used by search and pricing operations. Defaults to 30 days from today." }, "checkoutDate": { "title": "Check-out date (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Check-out date used by search and pricing operations. Defaults to 32 days from today (2-night stay)." }, "adults": { "title": "Number of adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Guests per booking. Defaults to 2.", "default": 2 }, "rooms": { "title": "Number of rooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Rooms requested. Defaults to 1.", "default": 1 }, "currency": { "title": "Currency", "type": "string", "description": "3-letter currency code (USD, EUR, GBP, etc.). Defaults to USD.", "default": "USD" }, "orderBy": { "title": "Sort order (for Hotel Search)", "enum": [ "popularity", "price", "review_score", "distance", "class", "class_descending" ], "type": "string", "description": "How Booking.com should order the results.", "default": "popularity" }, "sortType": { "title": "Review sort (for Hotel Reviews)", "enum": [ "SORT_MOST_RELEVANT", "SORT_RECENT_DESC", "SORT_RECENT_ASC", "SORT_SCORE_DESC", "SORT_SCORE_ASC" ], "type": "string", "description": "How to sort review results.", "default": "SORT_MOST_RELEVANT" }, "maxPages": { "title": "Max pages (for paginated operations)", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap on pages to fetch for paginated operations (search, reviews). Each page = 1 upstream call. Defaults to 5, max 50.", "default": 5 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Booking.com Scraper — Hotels, Reviews, Calendar & Reviews API from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: