{ "openapi": "3.0.1", "info": { "title": "Booking.com Scraper: Hotel Prices and Availability", "description": "Scrape Booking.com hotels and homes by place, link, property id or map area, past the 1,000 result cap, no login. Rows: price for your dates with taxes and fees, stars, guest score, free cancellation, meals; add rooms and rates, price calendar, reviews. JSON, CSV, Excel, API; pay per property.", "version": "0.1", "x-build-id": "FPPqdtq2lzJHtBTRi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~booking-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-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/automation_craft~booking-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-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/automation_craft~booking-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-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": { "search": { "title": "Places to search", "type": "array", "description": "City, region, district, landmark, airport or country names, for example \"Paris\", \"Tuscany\", \"Le Marais, Paris\", \"Eiffel Tower\" or \"Springfield, Missouri\". A property's full name as Booking.com shows it (\"Hotel Adlon Kempinski Berlin\") reads that one property. A name Booking.com does not offer exactly gets a free row listing the closest destinations to copy from.", "items": { "type": "string" } }, "startUrls": { "title": "Booking.com links", "type": "array", "description": "Booking.com search result links (they keep their own dates, guests, filters and order) and property page links (www.booking.com/hotel//.html, with or without dates) and shared list links (www.booking.com/mywishlist.html?wl=...: every property saved in the list). A setting you give below replaces the link's own value of that setting.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "propertyIds": { "title": "Booking.com property ids", "type": "array", "description": "Booking.com property ids (digits, for example 128735), each read as one property for your stay.", "items": { "type": "string" } }, "mapAreas": { "title": "Map areas", "type": "array", "description": "Search around a point or inside a box: {\"latitude\": 48.8584, \"longitude\": 2.2945, \"radiusKm\": 2} (0.1 to 50 km) or {\"north\": 48.88, \"south\": 48.84, \"east\": 2.37, \"west\": 2.30} (at most 1 degree north to south, about 111 km, and 1.5 degrees east to west). Properties outside the circle or box are left out free." }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in date, YYYY-MM-DD. Give it with \"checkOut\", or use the relative dates below instead." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Check-out date, YYYY-MM-DD (at most 90 nights after check-in)." }, "checkInDaysFromToday": { "title": "Check-in in N days", "minimum": 0, "maximum": 480, "type": "integer", "description": "Relative dates for scheduled runs: check-in this many days after the day the run starts (0 is that day). Use with \"nights\"; not with fixed dates." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 90, "type": "integer", "description": "Length of the stay in nights, with \"checkInDaysFromToday\"." }, "flexibleDays": { "title": "Flexible dates (days)", "minimum": 0, "maximum": 7, "type": "integer", "description": "Let Booking.com move the stay up to this many days either way to find a lower price (0, 1, 2, 3 or 7). A property Booking.com prices for other dates in that window comes with those dates as its check-in and check-out (its link, price and add-ons are for them) and the dates you searched in \"searchedDates\"." }, "checkInWindowDays": { "title": "Rate shopping: check-in days in a row", "minimum": 1, "maximum": 60, "type": "integer", "description": "Run every search once per check-in day for this many days in a row from the check-in date, same number of nights (for daily rate tracking). Each property row carries its own dates." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of adults (default 2)." }, "childrenAges": { "title": "Children's ages", "type": "array", "description": "One age (0 to 17) per child, for example [5, 9]. Prices and availability change with children's ages." }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of rooms (default 1)." }, "currency": { "title": "Currency", "type": "string", "description": "Three letter currency code of every price (default USD, or the link's own)." }, "language": { "title": "Language", "type": "string", "description": "Language of names and texts Booking.com translates (default en-us, or the link's own)." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest price per night (or for the whole stay with \"priceLimitsPerStay\"), in the run's currency." }, "maxPrice": { "title": "Maximum price", "minimum": 1, "type": "integer", "description": "Highest price per night (or for the whole stay with \"priceLimitsPerStay\"), in the run's currency." }, "priceIncludesTaxes": { "title": "Price limits include taxes and charges", "type": "boolean", "description": "Off: the price limits apply to the price Booking.com shows per night. On: they apply to the price per night with the taxes and charges Booking.com lists apart (city tax, cleaning fee), checked on every row." }, "priceLimitsPerStay": { "title": "Price limits are for the whole stay", "type": "boolean", "description": "Off: \"minPrice\" and \"maxPrice\" are per night. On: they are for the whole stay (all nights), checked on every row's price for the stay." }, "stars": { "title": "Stars", "type": "array", "description": "Star ratings to keep (any of them). \"Unrated\" keeps properties without a star rating; Booking.com has no filter for it, so with it every row is checked by its own rating.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "unrated" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars", "Unrated (no star rating)" ] } }, "minReviewScore": { "title": "Minimum guest score", "pattern": "^(10(\\.0)?|[1-9](\\.[0-9])?)$", "type": "string", "description": "Lowest guest review score, 1 to 10 with at most one decimal. 6, 7, 8 and 9 are Booking.com's own bands (Pleasant, Good, Very good, Wonderful); a score between them, such as 8.4, is checked on every row." }, "minReviewCount": { "title": "Minimum number of reviews", "minimum": 1, "type": "integer", "description": "Leave out properties with fewer guest reviews (checked on each row)." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Property types to keep (any of them).", "items": { "type": "string", "enum": [ "apartment", "hostel", "hotel", "motel", "resort", "bedAndBreakfast", "ryokan", "farmStay", "resortVillage", "villa", "campground", "boat", "guesthouse", "condoHotel", "vacationHome", "lodge", "homestay", "countryHouse", "luxuryTent", "capsuleHotel", "loveHotel", "riad", "chalet", "economyHotel" ], "enumTitles": [ "Apartments", "Hostels", "Hotels", "Motels", "Resorts", "Bed and breakfasts", "Ryokans", "Farm stays", "Resort villages", "Villas", "Campgrounds", "Boats", "Guesthouses", "Condo hotels", "Vacation homes", "Lodges", "Homestays", "Country houses", "Luxury tents", "Capsule hotels", "Love hotels", "Riads", "Chalets", "Economy hotels" ] } }, "entireHomesOnly": { "title": "Entire homes and apartments only", "type": "boolean", "description": "Keep only places you have to yourself." }, "freeCancellation": { "title": "Free cancellation", "type": "boolean", "description": "Keep only properties with a free cancellation rate." }, "noPrepayment": { "title": "No prepayment", "type": "boolean", "description": "Keep only properties with a rate you pay at the property." }, "bookWithoutCreditCard": { "title": "Book without credit card", "type": "boolean", "description": "Keep only properties bookable without a credit card." }, "meals": { "title": "Meals", "type": "array", "description": "Meal plans to keep (any of them).", "items": { "type": "string", "enum": [ "breakfast", "breakfastAndLunch", "breakfastAndDinner", "allMeals", "allInclusive", "kitchen" ], "enumTitles": [ "Breakfast included", "Breakfast and lunch included", "Breakfast and dinner included", "All meals included", "All inclusive", "Kitchen facilities" ] } }, "facilities": { "title": "Property facilities", "type": "array", "description": "Facilities every kept property must have (all of them).", "items": { "type": "string", "enum": [ "freeWifi", "parking", "swimmingPool", "spa", "hotTub", "fitnessCenter", "restaurant", "airportShuttle", "nonSmokingRooms", "evCharging", "frontDesk24h", "roomService", "wheelchairAccessible" ], "enumTitles": [ "Free WiFi", "Parking", "Swimming pool", "Spa", "Hot tub", "Fitness center", "Restaurant", "Airport shuttle", "Non-smoking rooms", "EV charging station", "24-hour front desk", "Room service", "Wheelchair accessible" ] } }, "roomFacilities": { "title": "Room facilities", "type": "array", "description": "Room facilities every kept property must offer (all of them).", "items": { "type": "string", "enum": [ "privateBathroom", "airConditioning", "balcony", "kitchen", "kitchenette", "washingMachine", "view", "seaView", "lakeView", "terrace", "privatePool", "privateHotTub", "bath", "flatScreenTv" ], "enumTitles": [ "Private bathroom", "Air conditioning", "Balcony", "Kitchen", "Kitchenette", "Washing machine", "View", "Sea view", "Lake view", "Terrace", "Private pool", "Private hot tub", "Bath", "Flat-screen TV" ] } }, "bedTypes": { "title": "Bed preference", "type": "array", "description": "Bed types to keep (any of them).", "items": { "type": "string", "enum": [ "twin", "double", "queen", "king" ], "enumTitles": [ "Twin beds", "Double bed", "Queen bed", "King bed" ] } }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 1, "maximum": 5, "type": "integer", "description": "Entire places with at least this many bedrooms." }, "minBathrooms": { "title": "Minimum bathrooms", "minimum": 1, "maximum": 19, "type": "integer", "description": "Properties with at least this many bathrooms." }, "petFriendly": { "title": "Pet friendly", "type": "boolean", "description": "Keep only pet friendly properties." }, "adultsOnly": { "title": "Adults only", "type": "boolean", "description": "Keep only adults only properties." }, "lgbtqFriendly": { "title": "LGBTQ+ friendly (Travel Proud)", "type": "boolean", "description": "Keep only Travel Proud properties." }, "sustainableOnly": { "title": "Sustainability certified", "type": "boolean", "description": "Keep only properties with a sustainability certification." }, "maxDistanceKm": { "title": "Maximum distance (km)", "minimum": 0.1, "maximum": 500, "type": "number", "description": "For places and map areas: leave out properties farther than this from the place's centre (straight line, checked on each row)." }, "bookingFilters": { "title": "Booking.com filter codes", "type": "array", "description": "Any other filter of Booking.com's search, as the code a search link carries in \"nflt\", for example \"di=8\" (a district), \"chaincode=1053\" (a brand), \"popular_activities=11\" or \"distance=1610\". Turn on \"includeFilterCounts\" to get every code of a search with its count. Star codes (\"class=\") and guest score codes (\"review_score=\") go here only when \"stars\" or \"minReviewScore\" is left empty.", "items": { "type": "string" } }, "includeNearbyProperties": { "title": "Include nearby properties", "type": "boolean", "description": "Booking.com adds properties from outside the destination when few match; they are left out free by default. Turn this on to keep them (flagged with \"outsideDestination\": true)." }, "sortBy": { "title": "Sort order", "enum": [ "popularity", "price", "price_from_high_to_low", "review_score_and_price", "bayesian_review_score", "class", "class_asc", "class_and_price", "distance_from_search", "upsort_bh", "business_popularity" ], "type": "string", "description": "Order of the results (default: Booking.com's own top picks; map areas default to distance)." }, "maxItems": { "title": "Maximum properties per run", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Most properties to deliver in the run, all searches and lookups together. Empty: no run cap (each search still stops at Booking.com's 1,000 results unless \"maxItemsPerSearch\" is above 1,000)." }, "maxItemsPerSearch": { "title": "Maximum properties per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most property rows one search delivers (default 1,000, the most Booking.com shows per search). Above 1,000 the Actor splits the search by property type and price to read past that limit." }, "includeDetails": { "title": "Property details", "type": "boolean", "description": "Add every room and rate of the stay (price, taxes, meal plan, cancellation and prepayment terms, rooms left, room size, beds, photos), the description, facilities, house rules, check-in and check-out times, category scores, photos, surroundings and the host's business details. Billed as Property details per property read in full." }, "maxPropertiesWithDetails": { "title": "Maximum properties with details", "minimum": 1, "type": "integer", "description": "Read Property details for the first N properties of the run only (the rest are delivered without details and not charged for them). Empty: every property." }, "includeCalendar": { "title": "Price calendar", "type": "boolean", "description": "Add a day by day calendar from the run's day: whether a stay can start, Booking.com's date picker price per night and the minimum stay. Billed per calendar day delivered." }, "calendarDays": { "title": "Calendar days", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many days of calendar (default 61)." }, "includeReviews": { "title": "Guest reviews", "type": "boolean", "description": "Add each property's guest reviews as rows of their own: score, title, liked and disliked text, language, date, stay dates, nights, room, traveller type, reviewer first name and country, property reply and photos. Billed per review." }, "maxReviewsPerProperty": { "title": "Maximum reviews per property", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most reviews delivered per property (default 10)." }, "reviewsSort": { "title": "Review order", "enum": [ "newest", "oldest", "highestScore", "lowestScore", "mostRelevant" ], "type": "string", "description": "Order of the reviews (default newest first)." }, "reviewsLanguages": { "title": "Review languages", "type": "array", "description": "Only reviews in these languages, as codes such as \"en\", \"fr\" or \"pt\".", "items": { "type": "string" } }, "reviewsTravellerType": { "title": "Traveller type", "enum": [ "families", "couples", "groupsOfFriends", "solo", "business" ], "type": "string", "description": "Only reviews of this traveller type." }, "reviewsScoreBand": { "title": "Review score band", "enum": [ "superb", "good", "passable", "poor", "veryPoor" ], "type": "string", "description": "Only reviews in this score band." }, "reviewsSeason": { "title": "Time of year", "enum": [ "marchToMay", "juneToAugust", "septemberToNovember", "decemberToFebruary" ], "type": "string", "description": "Only reviews of stays in this season." }, "reviewsKeyword": { "title": "Review keyword", "type": "string", "description": "Only reviews mentioning this word or phrase." }, "reviewsFrom": { "title": "Reviews posted from", "type": "string", "description": "Only reviews posted on or after this date (YYYY-MM-DD). With newest first, the walk stops at the first older review." }, "reviewsTo": { "title": "Reviews posted until", "type": "string", "description": "Only reviews posted on or before this date (YYYY-MM-DD)." }, "includePersonalData": { "title": "Include personal data", "type": "boolean", "description": "All public data is always delivered and this setting has no effect (kept so saved inputs keep working)." }, "includeFilterCounts": { "title": "Include filter counts", "type": "boolean", "description": "Add to each search's free summary row every filter Booking.com offers there, with its code and the number of properties (market size by stars, type, price band, district, brand and more)." }, "mapFile": { "title": "Map file (KML)", "type": "boolean", "description": "Also save the delivered properties as MAP.kml in the run's key-value store, for Google Earth or My Maps." }, "mapColorBy": { "title": "Map pin colour", "enum": [ "score", "price" ], "type": "string", "description": "How the map file colours its pins (default guest score)." }, "outputFields": { "title": "Output fields", "type": "array", "description": "Keep only these top level fields of each property row (the row's type, id, key, link and add-on fields always stay; with the map file on, the position, guest score and price stay too). Empty: every field.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify's datacenter proxy is used and included in the price; give your own proxy links only if you need 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 } } } } } } } } } }