{ "openapi": "3.0.1", "info": { "title": "Booking.com Things-to-Do Price & Rating Snapshot", "description": "Get Booking.com tours and activities for a destination with price, currency, rating, review count and a photo for each listing, by city or a custom country/city code.", "version": "1.1", "x-build-id": "qKkfpiPudTr5BblJN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nimbryxo-studio~booking-com-things-to-do-price-and-rating-snapshot/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nimbryxo-studio-booking-com-things-to-do-price-and-rating-snapshot", "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/nimbryxo-studio~booking-com-things-to-do-price-and-rating-snapshot/runs": { "post": { "operationId": "runs-sync-nimbryxo-studio-booking-com-things-to-do-price-and-rating-snapshot", "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/nimbryxo-studio~booking-com-things-to-do-price-and-rating-snapshot/run-sync": { "post": { "operationId": "run-sync-nimbryxo-studio-booking-com-things-to-do-price-and-rating-snapshot", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "productDetails", "availability", "reviews", "destinations" ], "type": "string", "description": "What to fetch. Search lists activities for a destination; productDetails looks up specific products; availability returns time slots; reviews returns guest reviews; destinations lists the city catalogue.", "default": "search" }, "destination": { "title": "Destination", "enum": [ "fr/paris", "gb/london", "us/new-york", "it/rome", "es/barcelona", "nl/amsterdam", "de/berlin", "at/vienna", "cz/prague", "pt/lisbon", "gr/athens", "tr/istanbul", "ae/dubai", "th/bangkok", "jp/tokyo", "sg/singapore", "au/sydney", "us/los-angeles", "us/san-francisco", "us/las-vegas", "us/miami", "gb/edinburgh", "ie/dublin", "dk/copenhagen", "se/stockholm", "hu/budapest", "pl/krakow", "hr/dubrovnik", "eg/cairo", "ma/marrakech", "custom" ], "type": "string", "description": "City to search. Pick a popular destination or choose Custom and enter a city slug and country code below. Used by mode=search." }, "customCity": { "title": "Custom city", "type": "string", "description": "City name or Booking.com city slug (e.g. 'kuala-lumpur', 'Porto'). Used when destination=custom." }, "customCountry": { "title": "Custom country", "type": "string", "description": "Two-letter country code or country name (e.g. 'my', 'Portugal'). Used when destination=custom." }, "query": { "title": "Search query", "type": "string", "description": "Optional free-text search inside the destination, e.g. 'Eiffel', 'Louvre', 'food tour' (mode=search)." }, "sortBy": { "title": "Sort by", "enum": [ "trending", "lowest_price", "highest_weighted_rating" ], "type": "string", "description": "Result order (mode=search).", "default": "trending" }, "minRating": { "title": "Minimum rating", "enum": [ "", "4.5", "4.0", "3.5", "3.0" ], "type": "string", "description": "Minimum guest rating on Booking.com's 5-point scale (mode=search).", "default": "" }, "freeCancellationOnly": { "title": "Free cancellation only", "type": "boolean", "description": "Keep only activities with free cancellation (mode=search).", "default": false }, "skipTheLineOnly": { "title": "Skip-the-line only", "type": "boolean", "description": "Keep only activities labelled skip the line (mode=search).", "default": false }, "wheelchairAccessibleOnly": { "title": "Wheelchair accessible only", "type": "boolean", "description": "Keep only activities labelled wheelchair accessible (mode=search).", "default": false }, "timeOfDay": { "title": "Time of day", "enum": [ "", "morning", "afternoon", "evening" ], "type": "string", "description": "Filter by start time (mode=search).", "default": "" }, "guideLanguage": { "title": "Guide language", "enum": [ "", "en", "fr", "es", "it", "de", "ru", "pt", "ja", "ar", "nl" ], "type": "string", "description": "Keep activities available with a guide in this language (mode=search).", "default": "" }, "category": { "title": "Category", "enum": [ "", "Tours", "Museums", "Nature & outdoor", "Entertainment & tickets", "Food & drink", "Services & rentals" ], "type": "string", "description": "Keep activities in this category. Applied after fetch and verified against each product's own categories (mode=search).", "default": "" }, "minPrice": { "title": "Minimum price", "minimum": 0, "maximum": 100000, "type": "number", "description": "Keep activities at or above this representative price (mode=search)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "maximum": 100000, "type": "number", "description": "Keep activities at or below this representative price (mode=search)." }, "minReviews": { "title": "Minimum review count", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Keep activities with at least this many guest reviews (mode=search)." }, "startDate": { "title": "Start date", "type": "string", "description": "Optional availability window start in YYYY-MM-DD format (mode=search or availability)." }, "endDate": { "title": "End date", "type": "string", "description": "Optional availability window end in YYYY-MM-DD format (mode=search or availability)." }, "productIds": { "title": "Product IDs or URLs", "type": "array", "description": "Booking.com attraction IDs (e.g. 'PRe4kSVWXdrD') or product URLs. Used by productDetails, availability and reviews modes.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "One or more Booking.com attraction product URLs. Used by productDetails, availability and reviews modes.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "Product URL", "description": "A public Booking.com attraction product URL." } } }, "default": [] }, "availabilityDate": { "title": "Availability date", "type": "string", "description": "Date for time-slot availability in YYYY-MM-DD format. Defaults to tomorrow (mode=availability or includeAvailability)." }, "includeCalendar": { "title": "Include availability calendar", "type": "boolean", "description": "Also fetch available dates and cheapest-price groups for the startDate/endDate range (mode=availability or productDetails).", "default": false }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Fetch guest reviews for each product. Adds one or more requests per product.", "default": false }, "reviewSortBy": { "title": "Review sort", "enum": [ "most_relevant", "newest", "oldest", "highest_rating", "lowest_rating" ], "type": "string", "description": "Review order when includeReviews or mode=reviews is active.", "default": "most_relevant" }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum guest reviews to include per product.", "default": 10 }, "includeAvailability": { "title": "Include availability", "type": "boolean", "description": "Fetch time slots for each product in search or product modes. Adds one request per product.", "default": false }, "includeDetails": { "title": "Include full product details", "type": "boolean", "description": "Fetch the full product record (all photos, inclusions, accessibility, additional info) for each search result. Adds one request per product.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum records to return (attractions, products, reviews products or destinations depending on mode).", "default": 50 }, "language": { "title": "Content language", "enum": [ "en", "fr", "de", "es", "it", "pt", "nl", "ru", "ja", "ar" ], "type": "string", "description": "Language for names and descriptions. Prices use the selected currency.", "default": "en" }, "currency": { "title": "Currency", "enum": [ "EUR", "USD", "GBP", "CHF", "SEK", "DKK", "NOK", "PLN", "CZK", "HUF", "TRY", "AED", "AUD", "CAD", "JPY", "SGD", "THB", "BRL", "MYR", "INR" ], "type": "string", "description": "Currency for representative prices.", "default": "EUR" } } }, "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 } } } } } } } } } }