{ "openapi": "3.0.1", "info": { "title": "Booking Com Scraper", "description": "Scrape hotel listings from Booking.com. Get names, prices, star ratings, review scores, photos, meal plans, cancellation policies, GPS coordinates, and availability. Filter by star rating, price range, property type, and review score. Search by destination, dates, and currency.", "version": "1.0", "x-build-id": "77ILhkEcjr2hIw0GM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~booking-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~booking-com-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~booking-com-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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", "properties": { "startUrl": { "title": "Start URL", "type": "string", "description": "Booking.com search results URL (e.g. https://www.booking.com/searchresults.html?dest_id=-2140479&dest_type=city&...). If provided, destination text is ignored." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000." }, "destination": { "title": "Destination", "type": "string", "description": "City, region, or property name to search (e.g. 'New York', 'Paris', 'Marriott Times Square'). Used to look up destId automatically." }, "checkin": { "title": "Check-in Date", "type": "string", "description": "Check-in date in YYYY-MM-DD format (e.g. 2026-03-15)." }, "checkout": { "title": "Check-out Date", "type": "string", "description": "Check-out date in YYYY-MM-DD format (e.g. 2026-03-17)." }, "nbAdults": { "title": "Number of Adults", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "nbChildren": { "title": "Number of Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of child guests.", "default": 0 }, "nbRooms": { "title": "Number of Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of rooms to book.", "default": 1 }, "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).", "default": "en-us" }, "sortBy": { "title": "Sort By", "enum": [ "popularity", "price", "review_score", "distance" ], "type": "string", "description": "Sort results by: popularity, price, review_score, or distance.", "default": "popularity" }, "minStarRating": { "title": "Minimum Star Rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Filter to hotels with at least this star rating (1-5)." }, "minReviewScore": { "title": "Minimum Review Score", "minimum": 0, "maximum": 10, "type": "number", "description": "Filter to hotels with at least this review score (e.g. 7.0 for Good, 8.0 for Very Good, 9.0 for Superb)." }, "maxPricePerNight": { "title": "Maximum Price per Night", "minimum": 0, "type": "number", "description": "Maximum price per night in selected currency." }, "propertyType": { "title": "Property Type", "enum": [ "Hotels", "Apartments", "Hostels", "Bed and Breakfasts", "Guest Houses", "Holiday Homes", "Resorts", "Villas", "Motels", "Campsites", "Boats" ], "type": "string", "description": "Filter by property type." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are required for Booking.com (AWS WAF protection)." } } }, "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 } } } } } } } } } }