{ "openapi": "3.0.1", "info": { "title": "Booking.com All-Year Multi-Area Hotel Data Scraper", "description": "A Python-based scraper that automatically collects hotel listings from Booking.com across multiple cities and every month of the year, capturing data such as price, rating, and availability for travel and market analysis", "version": "0.0", "x-build-id": "C8Zy9BD7iSCStnCLZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moving_beacon-owner1~my-actor-25/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moving_beacon-owner1-my-actor-25", "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/moving_beacon-owner1~my-actor-25/runs": { "post": { "operationId": "runs-sync-moving_beacon-owner1-my-actor-25", "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/moving_beacon-owner1~my-actor-25/run-sync": { "post": { "operationId": "run-sync-moving_beacon-owner1-my-actor-25", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "AREA URLs", "type": "array", "description": "One or more Booking.com search URLs to crawl. The date range is applied to each URL in turn. Any filters / destination params encoded in the URL are preserved — only check-in, check-out, and currency are overridden by this Actor.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "start_date": { "title": "Start Date", "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "First check-in date (YYYY-MM-DD). If left empty, today's date is used." }, "days": { "title": "Number of Days", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many consecutive check-in dates to scrape, starting from Start Date. Each date × each URL is one Booking.com page request, so large values multiply the run time.", "default": 3 }, "currency": { "title": "Select Currency", "enum": [ "PKR", "USD", "EUR", "SAR", "GBP", "AED", "THB", "SGD", "ARS", "AUD", "AZN", "BHD", "BRL", "BGN", "CAD", "CLP", "CNY", "COP", "CZK", "DKK", "EGP", "FJD", "GEL", "HKD", "HUF", "ISK", "INR", "IDR", "ILS", "JPY", "JOD", "KZT", "KWD", "MOP", "MYR", "MXN", "MDL", "NAD", "TWD", "NZD", "NOK", "OMR", "PLN", "QAR", "RON", "RUB", "ZAR", "KRW", "SEK", "CHF", "TRY", "UAH", "XOF" ], "type": "string", "description": "Currency for displayed hotel prices. Overrides any selected_currency value in your URLs.", "default": "USD" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy configuration. Residential proxies are strongly recommended for Booking.com — datacentre IPs are blocked aggressively. If the chosen config fails at startup, the Actor automatically falls back to RESIDENTIAL → auto group → direct connection. Each retry rotates IP.", "default": { "useApifyProxy": false } }, "timeout": { "title": "Page Timeout (ms)", "minimum": 10000, "maximum": 300000, "type": "integer", "description": "Playwright navigation timeout per page, in milliseconds.", "default": 60000 }, "retries": { "title": "Max Retries", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many times to retry a single date if blocked / timed out / parsed 0 hotels. Each retry launches a fresh browser with a new proxy IP.", "default": 5 }, "delayMin": { "title": "Min Delay (seconds)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Lower bound of the random pause between consecutive date requests.", "default": 2 }, "delayMax": { "title": "Max Delay (seconds)", "minimum": 1, "maximum": 60, "type": "integer", "description": "Upper bound of the random pause between consecutive date requests. Must be ≥ Min Delay.", "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 } } } } } } } } } }