{ "openapi": "3.0.1", "info": { "title": "Booking Hotel Scraper", "description": "It extracts hotel name, location, price per night, star rating, guest rating, review count, amenities, room types, images, and property description by navigating search results and visiting individual hotel detail pages. Suitable for price monitoring, hotel dataset creation, and market analysis.", "version": "1.0", "x-build-id": "Mz4gK6l75aSVyeR74" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeai~booking-hotel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeai-booking-hotel-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/scrapeai~booking-hotel-scraper/runs": { "post": { "operationId": "runs-sync-scrapeai-booking-hotel-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/scrapeai~booking-hotel-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeai-booking-hotel-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", "type": "array", "description": "Provide one or more Booking.com search result URLs. If set, individual search parameters below are ignored.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "Booking.com search results URL" } } } }, "ss": { "title": "Destination", "type": "string", "description": "City or destination name (e.g. 'Chennai'). Used when no startUrls are provided.", "default": "Chennai" }, "checkin": { "title": "Check-in Date", "type": "string", "description": "Check-in date in YYYY-MM-DD format (e.g. 2026-02-18)" }, "checkout": { "title": "Check-out Date", "type": "string", "description": "Check-out date in YYYY-MM-DD format (e.g. 2026-02-24)" }, "group_adults": { "title": "Number of Adults", "type": "integer", "description": "Number of adult guests", "default": 2 }, "no_rooms": { "title": "Number of Rooms", "type": "integer", "description": "Number of rooms required", "default": 1 }, "group_children": { "title": "Number of Children", "type": "integer", "description": "Number of child guests", "default": 0 }, "maxItems": { "title": "Max Hotels to Scrape", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of hotel detail pages to scrape from the search results", "default": 10 }, "scrollTimeout": { "title": "Page Scroll Timeout (seconds)", "type": "integer", "description": "Number of seconds to scroll the search results page to load more hotels", "default": 40 }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Use Apify Proxy or provide your own proxy servers", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "debugMode": { "title": "Debug Mode", "type": "boolean", "description": "Enable to save debug screenshots and detailed logs", "default": false }, "includeDetails": { "title": "Load hotel details", "type": "boolean", "description": "Try each actual hotel detail page; preserve source card fields with an explicit status when detail access fails.", "default": true }, "maxConcurrency": { "title": "Browser concurrency", "minimum": 1, "maximum": 3, "type": "integer", "description": "Maximum concurrent browser pages, from one to three; the default is two.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration (alias)", "type": "object", "description": "Optional override for proxy." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }