{ "openapi": "3.0.1", "info": { "title": "Booking Scraper", "description": "$1 / 1000 results in 10s. Extract Hotels, Apartment Search result listing & Search Metadata at Scale. Booking Scraper allows real-time search, pricing, availability, filters, and metadata from Booking.com. Designed for market research, competitive intelligence, travel analytics, and monitoring.", "version": "0.0", "x-build-id": "6z5sXHJ5DsAesGObK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/saswave~booking-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-saswave-booking-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/saswave~booking-scraper/runs": { "post": { "operationId": "runs-sync-saswave-booking-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/saswave~booking-scraper/run-sync": { "post": { "operationId": "run-sync-saswave-booking-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": { "feature": { "title": "Select Feature", "enum": [ "search", "metadata" ], "type": "string", "description": "Search or metadata", "default": "search" }, "destination": { "title": "Destination", "type": "string", "description": "Where ? Provide city name" }, "checkin": { "title": "Checkin Date", "type": "string", "description": "Provide dates for your stay. Both checkin and checkout need to be provided, else we use today and today + 1", "default": "" }, "checkout": { "title": "Checkout Date", "type": "string", "description": "Provide dates for your stay. Both checkin and checkout need to be provided, else we use today and today + 1", "default": "" }, "flex_days": { "title": "Flexible days", "enum": [ "0", "1", "2", "3", "7" ], "type": "string", "description": "Select if flexible days", "default": "0" }, "max_results": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "0 or empty = no limit" }, "nb_rooms": { "title": "Rooms number", "minimum": 1, "maximum": 30, "type": "integer", "description": "", "default": 1 }, "nb_adults": { "title": "Adults number", "minimum": 1, "maximum": 30, "type": "integer", "description": "", "default": 1 }, "nb_children": { "title": "Children number", "minimum": 0, "maximum": 10, "type": "integer", "description": "", "default": 0 }, "children_ages": { "title": "List of children ages", "type": "array", "description": "For each children provide a number between 0 and 17. If nb_children is 5, children_ages needs to be a list of 5 numbers for age, ex: [3, 2, 10, 11, 16]", "default": [] }, "price_min": { "title": "Price minimum", "minimum": 0, "type": "integer", "description": "0, means no price filters", "default": 0 }, "price_max": { "title": "Price maximum", "minimum": 0, "type": "integer", "description": "0, means no price filters", "default": 0 }, "currency": { "title": "Currency", "enum": [ "EUR", "ARS", "AUD", "AZN", "BHD", "BRL", "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", "GBP", "QAR", "RON", "RUB", "SAR", "SGD", "ZAR", "KRW", "SEK", "CHF", "THB", "TRY", "USD", "UAH", "AED", "XOF" ], "type": "string", "description": "Select your currency", "default": "USD" }, "lang": { "title": "Language", "enum": [ "en-us", "en-gb", "de", "nl", "fr", "es", "es-ar", "es-mx", "ca", "it", "pt-pt", "pt-br", "no", "fi", "sv", "da", "cs", "hu", "ro", "ja", "zh-cn", "zh-tw", "pl", "el", "ru", "tr", "bg", "ar", "ko", "he", "lv", "uk", "hi", "id", "ms", "th", "et", "hr", "lt", "sk", "sr", "sl", "vi", "tl", "is" ], "type": "string", "description": "Select your language", "default": "en-us" }, "sort": { "title": "Sort", "enum": [ "", "upsort_bh", "price", "price_from_high_to_low", "review_score_and_price", "class", "class_asc", "class_and_price", "distance_from_search", "bayesian_review_score" ], "type": "string", "description": "Select your filter", "default": "" }, "entire_place_bedroom": { "title": "Bedrooms", "minimum": 0, "maximum": 5, "type": "integer", "description": "0, means no bedrooms filters", "default": 0 }, "min_bathrooms": { "title": "Bathrooms", "minimum": 0, "maximum": 5, "type": "integer", "description": "0, means no bathrooms filters", "default": 0 }, "list_selected_filters": { "title": "Multiple filters", "type": "array", "description": "Multi Select your filter", "items": { "type": "string", "enum": [ "ht_id=204", "privacy_type=3", "ht_id=201", "ht_id=203", "ht_id=222", "ht_id=220", "ht_id=208", "ht_id=213", "ht_id=226", "mealplan=999", "mealplan=1", "mealplan=9", "hotelfacility=2", "hotelfacility=3", "hotelfacility=5", "hotelfacility=8", "hotelfacility=11", "roomfacility=38", "roomfacility=11", "roomfacility=999", "roomfacility=17", "roomfacility=93", "review_score=90", "review_score=80", "review_score=70", "review_score=60", "class=1", "class=2", "class=3", "class=4", "class=5", "fc=2", "distance=1000", "distance=3000", "distance=5000", "stay_type=1", "stay_type=2", "stay_type=4", "SustainablePropertyLevelFilter=4", "pmt=101", "accessible_facilities=186", "accessible_facilities=187", "accessible_facilities=188", "accessible_facilities=189", "accessible_facilities=211", "accessible_facilities=212", "accessible_facilities=213", "accessible_room_facilities=131", "accessible_room_facilities=132", "accessible_room_facilities=134", "accessible_room_facilities=147", "accessible_room_facilities=148", "accessible_room_facilities=149", "accessible_room_facilities=150", "accessible_room_facilities=151", "accessible_room_facilities=152", "accessible_room_facilities=153", "accessible_room_facilities=154", "hotelfacility=54", "hotelfacility=107", "hotelfacility=17", "hotelfacility=16" ], "enumTitles": [ "Hotels", "Entire homes & apartments", "Apartments", "Hostels", "Homestays", "Vacation Homes", "Bed and Breakfasts", "Villas", "Love Hotels", "Kitchen facilities", "Breakfast included", "Breakfast & dinner included", "Parking", "Restaurant", "Room service", "24-hour front desk", "Fitness center", "Private bathroom", "Air conditioning", "Kitchen/Kitchenette", "Balcony", "Private pool", "Wonderful: 9+", "Very Good: 8+", "Good: 7+", "Pleasant: 6+", "1 star", "2 stars", "3 stars", "4 stars", "5 stars", "Free cancellation", "Less than 1 km", "Less than 3 km", "Less than 5 km", "Pet friendly", "Adults only", "Travel Proud (LGBTQ+ friendly)", "Sustainability certification", "Accepts online payments", "Toilet with grab rails", "Raised toilet", "Lowered sink", "Bathroom emergency cord", "Visual aids (Braille)", "Visual aids (tactile signs)", "Auditory guidance", "Entire unit located on ground floor", "Upper floors accessible by elevator", "Entire unit wheelchair accessible", "Toilet with grab rails", "Adapted bath", "Roll-in shower", "Walk-in shower", "Raised toilet", "Lower sink", "Emergency cord in bathroom", "Shower chair", "Spa", "Free Wifi", "Airport shuttle", "Non-smoking rooms" ] }, "default": [] } } }, "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 } } } } } } } } } }