{ "openapi": "3.0.1", "info": { "title": "Booking.com Hotel Scraper - Ratings, Review Counts & Prices", "description": "Scrape Booking.com hotels by destination, or paste hotel URLs directly. Get the overall guest rating, total review count, star rating, full address, GPS coordinates, price per night and room type. One clean row per hotel. Fast, HTTP-only, no browser. JSON, CSV or Excel.", "version": "0.0", "x-build-id": "z1uu2pExBYpZpwWge" }, "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", "properties": { "startUrls": { "title": "Start URLs (Booking.com hotel pages)", "type": "array", "description": "Direct Booking.com hotel page URLs, e.g. https://www.booking.com/hotel/gb/the-savoy.html. Each URL is resolved to one hotel row with its overall guest score, review count, star rating, address and coordinates. Use this instead of (or alongside) a destination query when you already know the exact properties you want.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "resolveUrlsViaPage": { "title": "Resolve start URLs by reading the hotel page", "type": "boolean", "description": "Read each start URL's own page to get its exact name, guest rating and review count. A hotel's URL slug and its listed name are independent (booking.com/hotel/tc/the-alexandra is listed as 'Alexandra Resort - All-Inclusive'), so resolving a URL by searching its name misses renamed properties — on a real 41-hotel list, 13 of them. Turn this off to use name-search resolution only, which is faster but drops those.", "default": true }, "locationQuery": { "title": "Destination", "type": "string", "description": "City, region, country, or hotel name to search (e.g. 'London', 'Paris, France', 'The Savoy London'). Optional if you supply Start URLs." }, "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. The default Apify proxy is enough: Booking's data API is not geo-gated and hotel pages load fine from a datacenter exit. Residential is supported if you prefer it, but it costs considerably more per run and is not required.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }