{
"openapi": "3.0.1",
"info": {
"title": "Booking.com Scraper - Hotels, Prices & Availability",
"description": "Scrape Booking.com hotels: live prices for your dates with taxes and all-in totals, availability, review scores by category, stars, rooms, policies, photos and business contacts. Search any city, landmark or hotel, or paste URLs. Monitor prices. Independent tool, not affiliated with Booking.com.",
"version": "1.0",
"x-build-id": "nAJbfROxyFxlHksok"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~booking-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~booking-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~booking-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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",
"properties": {
"searchTerms": {
"title": "Search terms (destinations or hotels)",
"type": "array",
"description": "What to search. Type a destination (Paris, Bali, New York, Eiffel Tower, Schiphol Airport) to get the hotels there, or a hotel name (Hotel Armoni Paris) to get just that property. Each term is resolved with Booking.com's own search box, so cities, regions, districts, landmarks, airports and individual hotels all work.",
"items": {
"type": "string"
}
},
"searchUrls": {
"title": "Booking.com URLs",
"type": "array",
"description": "Paste Booking.com search results URLs (https://www.booking.com/searchresults.html?ss=Rome&dest_id=-126693&dest_type=city...) or hotel page URLs (https://www.booking.com/hotel/fr/de-nesle.html, language versions like .en-gb.html work too). Dates, guests, sort order and filters in a search URL are used. Combined with the search terms above.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"destinations": {
"title": "Destination IDs (advanced)",
"type": "array",
"description": "Advanced: Booking.com destination IDs as destId:destType (e.g. -1456928:city, 735:landmark, 850371:hotel). Types: city, region, country, district, airport, landmark, hotel.",
"items": {
"type": "string"
}
},
"checkInDate": {
"title": "Check-in date",
"type": "string",
"description": "Exact check-in date (YYYY-MM-DD). Leave empty to use Check-in in N days below, which keeps saved tasks and schedules from going stale. Booking.com sells stays from today up to about 500 days ahead."
},
"checkOutDate": {
"title": "Check-out date",
"type": "string",
"description": "Exact check-out date (YYYY-MM-DD). Leave empty to use Nights below."
},
"checkInDaysFromToday": {
"title": "Check-in in N days",
"minimum": 0,
"maximum": 500,
"type": "integer",
"description": "Relative check-in: the stay starts this many days after the run date (0 = today). Used when no check-in date is set; ideal for scheduled price tracking."
},
"nights": {
"title": "Nights",
"minimum": 1,
"maximum": 90,
"type": "integer",
"description": "Length of stay when no check-out date is set (1-90; Booking.com prices stays up to 90 nights)."
},
"adults": {
"title": "Adults",
"minimum": 1,
"maximum": 30,
"type": "integer",
"description": "Number of adults.",
"default": 2
},
"children": {
"title": "Children",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Number of children (0-17 years).",
"default": 0
},
"childrenAges": {
"title": "Children ages",
"type": "array",
"description": "Age of each child (0-17), e.g. 6 and 9. Missing ages are taken as 8; ages 18+ are counted as adults, as Booking.com does.",
"items": {
"type": "string"
}
},
"rooms": {
"title": "Rooms",
"minimum": 1,
"maximum": 30,
"type": "integer",
"description": "Number of rooms.",
"default": 1
},
"currency": {
"title": "Currency",
"enum": [
"USD",
"EUR",
"GBP",
"AED",
"ARS",
"AUD",
"AZN",
"BAM",
"BDT",
"BGN",
"BHD",
"BRL",
"BYN",
"CAD",
"CHF",
"CLP",
"CNY",
"COP",
"CZK",
"DKK",
"EGP",
"FJD",
"GEL",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"ISK",
"JOD",
"JPY",
"KES",
"KRW",
"KWD",
"KZT",
"LKR",
"MAD",
"MDL",
"MOP",
"MXN",
"MYR",
"NAD",
"NGN",
"NOK",
"NZD",
"OMR",
"PEN",
"PHP",
"PKR",
"PLN",
"QAR",
"RON",
"RSD",
"RUB",
"SAR",
"SEK",
"SGD",
"THB",
"TRY",
"TWD",
"UAH",
"UYU",
"VND",
"XOF",
"ZAR"
],
"type": "string",
"description": "Currency for every price.",
"default": "USD"
},
"language": {
"title": "Language",
"enum": [
"en-gb",
"en-us",
"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": "Language of text fields (descriptions, room names, labels).",
"default": "en-us"
},
"sortBy": {
"title": "Sort by",
"enum": [
"popularity",
"price",
"price_from_high_to_low",
"review_score_and_price",
"bayesian_review_score",
"class_descending",
"class_ascending",
"class_and_price",
"distance_from_search",
"upsort_bh"
],
"type": "string",
"description": "Result order, as on Booking.com.",
"default": "popularity"
},
"minPrice": {
"title": "Minimum price per night",
"minimum": 0,
"type": "integer",
"description": "Only hotels whose price per night (in the chosen currency) is at least this. 0 = no limit.",
"default": 0
},
"maxPrice": {
"title": "Maximum price per night",
"minimum": 0,
"type": "integer",
"description": "Only hotels whose price per night is at most this. 0 = no limit.",
"default": 0
},
"starRatings": {
"title": "Star ratings",
"type": "array",
"description": "Only hotels with these star classes. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5"
],
"enumTitles": [
"1 star",
"2 stars",
"3 stars",
"4 stars",
"5 stars"
]
}
},
"minReviewScore": {
"title": "Minimum review score",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Only hotels with a guest review score at or above this (0-10).",
"default": 0
},
"minReviews": {
"title": "Minimum number of reviews",
"minimum": 0,
"type": "integer",
"description": "Only hotels with at least this many guest reviews.",
"default": 0
},
"freeCancellationOnly": {
"title": "Free cancellation only",
"type": "boolean",
"description": "Only stays that can be cancelled for free.",
"default": false
},
"breakfastIncludedOnly": {
"title": "Breakfast included only",
"type": "boolean",
"description": "Only stays with breakfast included.",
"default": false
},
"entireHomesOnly": {
"title": "Entire homes & apartments only",
"type": "boolean",
"description": "Only properties you have to yourself (entire apartments, houses, villas).",
"default": false
},
"propertyTypes": {
"title": "Property types",
"type": "array",
"description": "Only these property types (Booking.com's own categories). Leave empty for all.",
"items": {
"type": "string",
"enum": [
"204",
"201",
"216",
"208",
"203",
"206",
"205",
"219",
"220",
"213",
"222",
"223",
"228",
"221",
"210",
"212",
"214",
"224",
"215",
"209",
"225",
"226",
"227"
],
"enumTitles": [
"Hotels",
"Apartments",
"Guesthouses",
"Bed and breakfasts",
"Hostels",
"Resorts",
"Motels",
"Condo hotels",
"Vacation homes",
"Villas",
"Homestays",
"Country houses",
"Chalets",
"Lodges",
"Farm stays",
"Resort villages",
"Campgrounds",
"Luxury tents",
"Boats",
"Ryokans",
"Capsule hotels",
"Love hotels",
"Riads"
]
}
},
"extraFilters": {
"title": "Extra filters (advanced)",
"type": "string",
"description": "Advanced: Booking.com filter codes from the nflt= part of a search URL, separated by semicolons (e.g. hotelfacility=107;distance=1000)."
},
"includeDetails": {
"title": "Include hotel details",
"type": "boolean",
"description": "Add each hotel's page data: description, facilities, review scores by category (staff, cleanliness, location...), check-in/out times, pet and child policy, languages spoken, payment methods, up to 20 photos, licence numbers and, for business hosts, the company contact details Booking.com publishes.",
"default": true
},
"includeRooms": {
"title": "Include room offers",
"type": "boolean",
"description": "Add the rooms list: each offered room with its price, guests, meal plan, free-cancellation deadline and rooms left.",
"default": true
},
"maxResultsPerSearch": {
"title": "Max results per search",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum hotels per destination or search URL. With several searches, the total is shared fairly between them.",
"default": 50
},
"maxResults": {
"title": "Max results (total)",
"minimum": 1,
"type": "integer",
"description": "Maximum hotels in the whole run.",
"default": 200
},
"deduplicateResults": {
"title": "Deduplicate hotels",
"type": "boolean",
"description": "Save a hotel only once per run when it appears in several searches.",
"default": true
},
"monitorMode": {
"title": "Monitor mode (only new & changed)",
"type": "boolean",
"description": "Remember each hotel's price and availability between runs (in a named key-value store) and save only hotels that are new or whose price changed (price_drop / price_rise); for hotels searched by name or URL also sold_out / now_available. Each record gets a monitorChange field. Pair it with an Apify Schedule; in this mode Max results per search is how many hotels each search watches.",
"default": false
},
"monitorStoreName": {
"title": "Monitor store name",
"type": "string",
"description": "Named key-value store that remembers prices. Use a different name per watch list (lowercase letters, digits and hyphens).",
"default": "booking-monitor"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 16,
"type": "integer",
"description": "Parallel requests for destination lookups and hotel details.",
"default": 8
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to use. The default Apify Proxy (datacenter, US) works for Booking.com's data service.",
"default": {
"useApifyProxy": true,
"apifyProxyCountry": "US"
}
},
"urlsFromFile": {
"title": "Import URLs from a file",
"type": "string",
"description": "Paste Booking.com URLs (one per line), OR one link to a .txt/.csv file, Google Sheet or Google Drive file that lists them."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}