{ "openapi": "3.0.1", "info": { "title": "Booking.com Hotels - Search, Prices & Reviews", "description": "Search Booking.com or look up individual hotels. Search returns name, price in two currencies, review score, room type and location per property. Detail mode adds the review score broken down by category, full postal address and nearby landmarks.", "version": "0.1", "x-build-id": "ehEVk2DNBRVJmLU0X" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~booking-hotels/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-booking-hotels", "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/s-r~booking-hotels/runs": { "post": { "operationId": "runs-sync-s-r-booking-hotels", "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/s-r~booking-hotels/run-sync": { "post": { "operationId": "run-sync-s-r-booking-hotels", "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": { "hotel_urls": { "title": "Hotel page addresses (detail mode)", "type": "array", "description": "Paste Booking.com hotel page addresses to look each one up in detail instead of searching. Detail mode returns the review score broken down by category (cleanliness, staff, location, value, wifi, comfort, facilities), the full postal address and nearby landmarks, none of which a search result carries. Leave empty to search a destination instead.", "items": { "type": "string" } }, "destination": { "title": "Destination", "type": "string", "description": "Where to search, as you would type it into Booking's own search box: a city, region, district or landmark, for example \"Amsterdam\". Ignored when hotel page addresses are given." }, "checkin": { "title": "Check-in date", "type": "string", "description": "Arrival date as YYYY-MM-DD. Leave empty for 30 days from today. A search without dates returns no prices at all, so a date is always used." }, "checkout": { "title": "Check-out date", "type": "string", "description": "Departure date as YYYY-MM-DD, after the arrival date. Leave empty for a two-night stay." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of adults. Prices and availability both depend on it, so this changes the result set, not only the total.", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of children in the party.", "default": 0 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of rooms to price.", "default": 1 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter code the headline price should be shown in, for example EUR, USD or GBP. Leave empty to accept Booking's own choice. The property's local-currency price is returned alongside it either way, whenever the two differ.", "default": "EUR" }, "sort_orders": { "title": "Sort orders to collect", "type": "array", "description": "Booking's paging does not work: asking for later pages returns the same properties again. Different sort orders do return different properties, so each order you add is roughly another 25 hotels. Three orders returned 73 distinct properties where one returned 26.", "items": { "type": "string", "enum": [ "top_picks", "price", "review_score", "stars_high", "stars_low", "distance" ], "enumTitles": [ "Our top picks", "Price (lowest first)", "Review score", "Stars (high to low)", "Stars (low to high)", "Distance from centre" ] }, "default": [ "top_picks", "price", "review_score" ] }, "region": { "title": "Search from country", "type": "string", "description": "Two-letter country code the search should appear to come from. Travel prices and availability are regional, so this is recorded with every run rather than left to chance.", "default": "nl" }, "max_results": { "title": "Maximum properties", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop after this many distinct properties. Also the cost ceiling for the run.", "default": 75 } } }, "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 } } } } } } } } } }