{ "openapi": "3.0.1", "info": { "title": "Booking.com Hotels & Prices Scraper", "description": "Scrape Booking.com hotels and accommodation by destination and dates. Get name, type, nightly price, review score, star rating, address, coordinates and distance from center. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "0UhBvc1tjAsdyzDaG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~booking-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-booking-hotels-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/scrapers_lat~booking-hotels-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-booking-hotels-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/scrapers_lat~booking-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-booking-hotels-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": [ "destination" ], "properties": { "maxHotels": { "title": "Max hotels", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of hotels (properties) to collect. Optional." }, "withDetails": { "title": "Fetch property details", "type": "boolean", "description": "When enabled, each property is enriched from its own page with a full description, street address, postal code and region. Adds one request per property.", "default": true }, "withListingSummary": { "title": "AI listing summary", "type": "boolean", "description": "Add an AI-generated concise English summary of each property (from its name, location, rating and description). Paid add-on; paying users only. Charged only on usable output.", "default": false }, "withFeatures": { "title": "AI feature extraction", "type": "boolean", "description": "Extract a structured list of amenities/features from each property's description using AI. Paid add-on; paying users only. Charged only on usable output.", "default": false }, "destination": { "title": "Destination", "type": "string", "description": "City, region, country or property name to search, for example Paris, Cancun, Tuscany or Amsterdam." }, "starRatings": { "title": "Star Ratings", "type": "array", "description": "Optional. Keep only properties with these star ratings (1-5). Leave empty for all.", "items": { "type": "string" } }, "minReviewScore": { "title": "Minimum Review Score", "minimum": 0, "maximum": 10, "type": "integer", "description": "Optional. Keep only properties with a guest review score at or above this value (0-10)." }, "minPrice": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Optional. Keep only properties at or above this total stay price (in the selected currency)." }, "maxPrice": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Optional. Keep only properties at or below this total stay price (in the selected currency)." }, "propertyTypes": { "title": "Property Types", "type": "array", "description": "Optional. Keep only these property types, e.g. Hotel, Apartment, Resort, Villa, Hostel, Guest house.", "items": { "type": "string" } }, "freeCancellation": { "title": "Free Cancellation Only", "type": "boolean", "description": "Optional. When enabled, keep only properties offering free cancellation.", "default": false }, "breakfastIncluded": { "title": "Breakfast Included Only", "type": "boolean", "description": "Optional. When enabled, keep only properties where breakfast is included.", "default": false }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Optional. Leave empty to use a default upcoming stay." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. Optional. Leave empty to use a default upcoming stay." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of adults." }, "children": { "title": "Children", "minimum": 0, "maximum": 20, "type": "integer", "description": "Number of children." }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of rooms." }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "MXN", "BRL", "ARS", "CLP", "COP", "PEN", "CAD", "AUD", "JPY", "CNY", "INR", "AED", "CHF" ], "type": "string", "description": "Currency for the displayed prices.", "default": "USD" } } }, "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 } } } } } } } } } }