# Booking Scraper (`saswave/booking-scraper`) Actor $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. - **URL**: https://apify.com/saswave/booking-scraper.md - **Developed by:** [SASWAVE](https://apify.com/saswave) (community) - **Categories:** Real estate, Travel, Social media - **Stats:** 40 total users, 7 monthly users, 97.3% runs succeeded, 3 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Booking Scraper Extract Hotels, Apartment Search results listing & Search Metadata at Scale The Booking Scraper allows you to extract real-time search results, pricing, availability, filters, and metadata from Booking.com. It is designed for market research, competitive intelligence, travel analytics, and price monitoring. This scraper works on Booking.com search result pages and returns clean, structured JSON ready for dashboards, databases, or BI tools. ### ✨ Features πŸ”Ž Extract search result listings (hotels, apartments, properties) πŸ’° Capture prices, discounts, currency & availability ⭐ Retrieve ratings, reviews count & star ratings πŸ“ Collect location data (coordinates, distance, districts) 🏷️ Access Booking.com badges & sponsored ads πŸ›οΈ Extract room & bed configurations 🧩 Full search metadata (filters, availability, totals) πŸ“Š Ideal for large-scale analysis & automation ⚑ Output delivered in structured JSON ### OUTPUT Samples Search result (Property Listing) ```json { "input_city": "Paris", "input_dest_id": -1456928, "host_type": "PROFESSIONAL", "is_new_open": false, "meal_included": null, "accept_wallet_credit": false, "profile_needs": null, "is_sustainable": false, "certifications": [], "name": "Paris Marriott Rive Gauche Hotel & Conference Center", "exclusive_property": false, "price": 423.15, "currency": "EUR", "ad_sponsor": { "nativeAdsCpc": 0.8, "geniusRateAvailable": false, "preferred": true, "highlighted": false, "nativeAdId": "9133747e-ccb1-4523-9e1e-66b874865ff4_5", "__typename": "SearchResultPersuasion", "autoextended": false, "nativeAdsTracking": "eyJhdWN0aW9uRXBvY2giOjE3NjY1NjQ3MjExNzEsInJhbmsiOjEsImtvZGRpVHJhY2tpbmdJbmZvIjoiVWRWSGxQcCtoOTVOT2haaDAzaEwzRVlRVWpvbkJwbFdmVk9rQ2JMZWVwSE5JSjk2cjN2UkdFSlhZUzcvbXluaEZXeGE5bHZidEtqMUR0UWxYQ0k1Nk0xTWxJZzhZd3pRT3RQNkNLTVR3OFIrYyt1NE1FOWlEQmlReHJyQjlMNmlyNmx3cHAxd0YrYnFOWWdMODJLRTNVQ21hQjBGWDdVOGw5TktoTXZnazRzaHpPUzJVUkY5bnhQS1VRbVp0SmpkMy9qaVB0MnV1MXJOaFBoM0ZDWHZuVXc0YmZUVldnRlk0a0VOSEJOQW1kcS83eVljZ2VXRFVmTkFabUpNbGZWUVZuTU1XamJkclJTcGc1MGRDKzdrME15RzQyWmltTTdUUnIzajh5NVNzdDl5eC81aUYvdEZWOU9QK3hTZk1EUXEzMy9kWDlpSkpJWmUyeWpRaHRZL3J4bEFIZ1VsWGtsOE1VUDNmZnFzdWh5WU5BZlJLbXQ1SVdVOThBOHRWTFhOUFBPc2ZURS9abDlvbmpLYThYNVMvZ3ZBMWNJK2c5Y3R2YnFGYkxGVi9sWTNlbDAxRGkzcTRXSnRvZVZxQy9yVVFTN1RLd09YN1JxUEc1NnV6c282d3VWN2dLL2JRdjIwZHZwN3o4RnZyMzRsOU5GT2EzWklqL3hvYVRjZmMyVmhqYWtsQytIY2hNeTZ3bzFpdS81ZWRhUEJ6TFZncVA5UG1KSWtlUnVJYysxZm1rWWUwNEZQbmJFVTJyRGNnYi92RTJPOXFsOGREOWpQem1rSjhPeEtIR25IUitIVlNidFRveWRlTnZjMDFqMXRZNVRxMjFFQ0h6RVFwbHpLcnNFaGwreUw2Vmh6aytJWUpKZXc0eHE1emtDdVVtemVGTHk5ZW9UR0ozRE8wZEFsMUk1dGFNZDd2bWNZRUI3Y2FMRHljN1VSQXpjUWp3TGx4NG90bmVuRU5FaEd2a2Z5UEZnVWpTTDhlbXpQZFIraFo1ZDNUaW9CNG4yZEt4M0dKUjVTTTNiWE1RRjFISCtVcWcvckxwbE9zQzM0aWVUakx0ZVdLK2dWL0lnWHJBZVFTSnp1RzIwOWNIYnhCRXhseGdKa01FdHlhVU5CZmhTWGhKRkVpU01yWHF3NnNUcnkzajhwVk5NMW5BWkJxWXdRc0cwUHFWL3VIcVM0bXAycFpRVnhrenRSKzMweTJ2ekdKVGNodTFNTlFIS1Z4M2VpdWYrbi9yTVh2dGtIOXFJUXcvZFh6OGtFZkRleU52OENUQWxmNzBrRjlOd25DVHRxbUVDb1d5cEM4ek1iYVpSb1R1R0dZRjBubTB3S01XemNBWkZqQnZkL29vb2NVaklvY3VjNHkrKzU1TmhSSDFwbCt5N1c4YkFkc1V3aEd1SWpLNis4VG5PU2ZhOVFaMTVhR0NsRGt0bVp5Q05NY3M5Y3c2Z1RrY2FRRjVPb2V3RW5NWjhadmlTK0tlWURiS1ducnVBQWc2ZXE0U2Q3MU93ZFU1Sjl4b3hvQ1FEZEpnQ1NLeHEwRjIxbG1lUENCNmEyK2Faall3UTdqU1lPdTB5RlhrZXpaT202b0FBQTI3R0c5L0hmVjhIWDh6NlNqNTE3SUg5ajNHWlRrREhIclhoazMwUkduTXlXTlBOSDhGcTdVNnNmeFVlZ2VaYmg4a3BIUzBsb0RnTEdjZk4zMVN6OUxVTFRNL1E2ZkpBcHYwT3JFQ1MxeW8xVGY5eDJid0RpYkg3VmZEVWdOL0xzekV4NysxdEtzTVNVdlpzUmhrd1haUE4xTmR5L1hqM09sVjNEU1NzNy85SDZQNm1kL09kVk5nSTJqR0F1Q2tiVlNjTVduaHVHbUpUM1pteHNORzZzaXU3c3l0NXhjM0xKUEU2L0VmSkhtOTJHT3IvY2kxVTR4aUc3Y2loU013YWlwVlpFUk0rLzlzUUtwTGpNemREN2h3T3RveFVqN3hnOWNPMUtnRHVPQTduM1pOZDhpNXBOIn0=", "sponsoredAdsData": { "legalEntityName": "Marriott", "__typename": "SponsoredAds", "designType": "GREY_BG_DEFAULT_BORDER_MEDIA_ALT_BADGE", "isDsaCompliant": true }, "preferredPlus": false, "showNativeAdLabel": true }, "unit_configuration": { "nbLivingrooms": 0, "nbBedrooms": 0, "name": null, "unitTypeNames": [], "__typename": "UnitConfiguration", "nbBathrooms": 0, "nbUnits": 2, "nbAllBeds": 2, "bedConfigurations": [ { "nbAllBeds": 2, "__typename": "BedConfiguration", "beds": [ { "__typename": "Bed", "count": 2, "type": 3 } ] } ], "localizedArea": null, "nbKitchens": 0, "unitId": 0 }, "property_usp_badges": [], "policies": { "__typename": "Policies", "showPetsAllowedForFree": false, "showFreeCancellation": false, "showNoPrepayment": false, "enableJapaneseUsersSpecialCase": null }, "sold_out": false, "property": { "__typename": "BasicPropertyData", "paymentConfig": { "installments": null, "__typename": "PaymentConfig" }, "location": { "countryCode": "fr", "longitude": 2.33954608440399, "city": "Paris", "latitude": 48.8319079555571, "address": "17 Boulevard Saint Jacques", "__typename": "Location" }, "photos": { "__typename": "PropertyPhotos", "main": { "__typename": "Photo", "highResJpegUrl": { "__typename": "PhotoResource", "relativeUrl": "/xdata/images/hotel/square600/591701749.jpg?k=5a94570d2220f44fec3ec1b9984601cc5afbc6ec0ce380791680856c695f5136&o=" }, "highResUrl": { "__typename": "PhotoResource", "relativeUrl": "/xdata/images/hotel/square600/591701749.webp?k=7ef283f893b45732b6fabec9078cbfd3a1fbbefb2f46a749b0da20228e0dbd62&o=" }, "lowResUrl": { "__typename": "PhotoResource", "relativeUrl": "/xdata/images/hotel/square240/591701749.webp?k=7ef283f893b45732b6fabec9078cbfd3a1fbbefb2f46a749b0da20228e0dbd62&o=" }, "tags": [ { "__typename": "PhotoTag", "id": 160 } ], "lowResJpegUrl": { "__typename": "PhotoResource", "relativeUrl": "/xdata/images/hotel/square240/591701749.jpg?k=5a94570d2220f44fec3ec1b9984601cc5afbc6ec0ce380791680856c695f5136&o=" } } }, "externalReviewScore": null, "ufi": -1456928, "isClosed": false, "accommodationTypeId": 204, "pageName": "paris-marriott-rive-gauche-conference-center", "id": 59913, "isTestProperty": false, "reviewScore": { "score": 7.5, "secondaryTextTag": { "__typename": "TranslationTag", "translation": null }, "__typename": "Reviews", "reviewCount": 212, "totalScoreTextTag": { "translation": "Good", "__typename": "TranslationTag" }, "secondaryScore": 0.0, "showSecondaryScore": false, "showScore": true }, "starRating": { "tocLink": { "translation": "Learn more on the \"How we work\" page", "__typename": "TranslationTag" }, "showAdditionalInfoIcon": false, "caption": { "translation": "This star rating is provided to Booking.com by the property and is usually determined by an official hotel rating organization or another third party. ", "__typename": "TranslationTag" }, "symbol": "STARS", "value": 4.0, "__typename": "StarRating" } }, "is_ad": false, "wishlists": 0, "review_summary": "- Guests appreciated friendly, helpful staff throughout their stay \n- Location praised for metro access but seen as slightly out of centre \n- Rooms generally clean though some found them small or dated \n- Breakfast received mixed reviews, some wanted more variety and freshness \n- Value for money was questioned by several guests due to ageing facilities", "location": { "isWithinBestLocationScoreArea": false, "mainDistanceDescription": "This is the straight-line distance on the map. Actual travel distance may vary.", "__typename": "SearchResultsPropertyLocation", "geoDistanceMeters": null, "nearbyBeachNames": [], "isCentrallyLocated": false, "nearbyUsNaturalParkText": null, "beachDistance": null, "popularFreeDistrictName": null, "skiLiftDistance": null, "beachWalkingTime": null, "displayLocation": "14th arr., Paris", "mainDistance": "2.9 km from downtown", "publicTransportDistanceDescription": "Saint-Jacques station is within 250 meters" }, "bundle_rates": false, "top_photos": [], "description_summary": null, "badges": [] } ```` Search Metadata (Filters, Availability, Market Size) ```json { "city": "Paris", "dest_id": -1456928, "total": 2765, "unavailability_percent": 79, "low_availability": false, "filters": [ { "count": 1162, "url_id": "mealplan=1", "source": "POPULAR", "field": "mealplan", "generic_id": "mealplan-1", "selected": false, "name": "Breakfast included" }, { "count": 1554, "url_id": "ht_id=204", "source": "POPULAR", "field": "ht_id", "generic_id": "ht_id-204", "selected": false, "name": "Hotels" }, { "count": 412, "url_id": "review_score=90", "source": "POPULAR", "field": "review_score", "generic_id": "review_score-90", "selected": false, "name": "Wonderful: 9+" }, { "count": 159, "url_id": "hotelfacility=54", "source": "POPULAR", "field": "hotelfacility", "generic_id": "hotelfacility-54", "selected": false, "name": "Spa" }, { "count": 1525, "url_id": "fc=2", "source": "POPULAR", "field": "fc", "generic_id": "fc-2", "selected": false, "name": "Free cancellation" }, { "count": 1126, "url_id": "di=2281", "source": "POPULAR", "field": "di", "generic_id": "di-2281", "selected": false, "name": "Paris City Center" }, { "count": 258, "url_id": "distance=1000", "source": "POPULAR", "field": "distance", "generic_id": "distance-1000", "selected": false, "name": "Less than 1 km" }, { "count": 566, "url_id": "hotelfacility=2", "source": "POPULAR", "field": "hotelfacility", "generic_id": "hotelfacility-2", "selected": false, "name": "Parking" }, { "count": 1280, "url_id": "mealplan=999", "source": "SELF_FILTER_GROUP", "field": "mealplan", "generic_id": "mealplan-999", "selected": false, "name": "Kitchen facilities" }, { "count": 1162, "url_id": "mealplan=1", "source": "SELF_FILTER_GROUP", "field": "mealplan", "generic_id": "mealplan-1", "selected": false, "name": "Breakfast included" }, { "count": 14, "url_id": "mealplan=9", "source": "SELF_FILTER_GROUP", "field": "mealplan", "generic_id": "mealplan-9", "selected": false, "name": "Breakfast & dinner included" }, { "count": 1554, "url_id": "ht_id=204", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-204", "selected": false, "name": "Hotels" }, { "count": 1273, "url_id": "privacy_type=3", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "privacy_type-3", "selected": false, "name": "Entire homes & apartments" }, { "count": 1255, "url_id": "ht_id=201", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-201", "selected": false, "name": "Apartments" }, { "count": 251, "url_id": "family_friendly_property=1", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "family_friendly_property-1", "selected": false, "name": "Family-Friendly Properties" }, { "count": 28, "url_id": "ht_id=203", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-203", "selected": false, "name": "Hostels" }, { "count": 9, "url_id": "ht_id=208", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-208", "selected": false, "name": "Bed and Breakfasts" }, { "count": 8, "url_id": "ht_id=220", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-220", "selected": false, "name": "Vacation Homes" }, { "count": 5, "url_id": "ht_id=222", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-222", "selected": false, "name": "Homestays" }, { "count": 1, "url_id": "ht_id=213", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-213", "selected": false, "name": "Villas" }, { "count": 1, "url_id": "ht_id=214", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-214", "selected": false, "name": "Campgrounds" }, { "count": 1, "url_id": "ht_id=216", "source": "SELF_FILTER_GROUP", "field": "ht_id", "generic_id": "ht_id-216", "selected": false, "name": "Guesthouses" }, { "count": 566, "url_id": "hotelfacility=2", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-2", "selected": false, "name": "Parking" }, { "count": 262, "url_id": "hotelfacility=3", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-3", "selected": false, "name": "Restaurant" }, { "count": 748, "url_id": "hotelfacility=5", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-5", "selected": false, "name": "Room service" }, { "count": 1536, "url_id": "hotelfacility=8", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-8", "selected": false, "name": "24-hour front desk" }, { "count": 297, "url_id": "hotelfacility=11", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-11", "selected": false, "name": "Fitness center" }, { "count": 2286, "url_id": "hotelfacility=16", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-16", "selected": false, "name": "Non-smoking rooms" }, { "count": 375, "url_id": "hotelfacility=17", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-17", "selected": false, "name": "Airport shuttle" }, { "count": 159, "url_id": "hotelfacility=54", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-54", "selected": false, "name": "Spa" }, { "count": 69, "url_id": "hotelfacility=63", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-63", "selected": false, "name": "Hot tub/Jacuzzi" }, { "count": 2661, "url_id": "hotelfacility=107", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-107", "selected": false, "name": "Free Wifi" }, { "count": 99, "url_id": "hotelfacility=182", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-182", "selected": false, "name": "Electric vehicle charging station" }, { "count": 561, "url_id": "hotelfacility=185", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-185", "selected": false, "name": "Wheelchair accessible" }, { "count": 97, "url_id": "hotelfacility=433", "source": "SELF_FILTER_GROUP", "field": "hotelfacility", "generic_id": "hotelfacility-433", "selected": false, "name": "Swimming pool" }, { "count": 2414, "url_id": "roomfacility=38", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-38", "selected": false, "name": "Private bathroom" }, { "count": 1280, "url_id": "roomfacility=999", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-999", "selected": false, "name": "Kitchen/Kitchenette" }, { "count": 1637, "url_id": "roomfacility=11", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-11", "selected": false, "name": "Air conditioning" }, { "count": 6, "url_id": "roomfacility=93", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-93", "selected": false, "name": "Private pool" }, { "count": 324, "url_id": "roomfacility=17", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-17", "selected": false, "name": "Balcony" }, { "count": 51, "url_id": "roomfacility=14", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-14", "selected": false, "name": "Hot tub" }, { "count": 813, "url_id": "roomfacility=5", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-5", "selected": false, "name": "Bathtub" }, { "count": 20, "url_id": "roomfacility=92", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-92", "selected": false, "name": "Sauna" }, { "count": 63, "url_id": "roomfacility=71", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-71", "selected": false, "name": "Fireplace" }, { "count": 27, "url_id": "roomfacility=20", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-20", "selected": false, "name": "Spa tub" }, { "count": 1595, "url_id": "roomfacility=125", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-125", "selected": false, "name": "Linens" }, { "count": 1171, "url_id": "roomfacility=45", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-45", "selected": false, "name": "Kitchen" }, { "count": 2178, "url_id": "roomfacility=75", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-75", "selected": false, "name": "Flat-screen TV" }, { "count": 7, "url_id": "roomfacility=99", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-99", "selected": false, "name": "Barbecue" }, { "count": 495, "url_id": "roomfacility=33", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-33", "selected": false, "name": "Dishwasher" }, { "count": 2169, "url_id": "roomfacility=124", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-124", "selected": false, "name": "Towels" }, { "count": 1055, "url_id": "roomfacility=132", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-132", "selected": false, "name": "Upper floors accessible by elevator" }, { "count": 2045, "url_id": "roomfacility=4", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-4", "selected": false, "name": "Shower" }, { "count": 4, "url_id": "roomfacility=220", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-220", "selected": false, "name": "Complimentary evening snacks and drinks in the executive lounge" }, { "count": 1017, "url_id": "roomfacility=32", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-32", "selected": false, "name": "Microwave" }, { "count": 1, "url_id": "roomfacility=109", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-109", "selected": false, "name": "Lake view" }, { "count": 18, "url_id": "roomfacility=36", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-36", "selected": false, "name": "Video games" }, { "count": 12, "url_id": "roomfacility=101", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-101", "selected": false, "name": "Computer" }, { "count": 17, "url_id": "roomfacility=103", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-103", "selected": false, "name": "Game console" }, { "count": 843, "url_id": "roomfacility=34", "source": "SELF_FILTER_GROUP", "field": "roomfacility", "generic_id": "roomfacility-34", "selected": false, "name": "Washing machine" }, { "count": 412, "url_id": "review_score=90", "source": "SELF_FILTER_GROUP", "field": "review_score", "generic_id": "review_score-90", "selected": false, "name": "Wonderful: 9+" }, { "count": 1650, "url_id": "review_score=80", "source": "SELF_FILTER_GROUP", "field": "review_score", "generic_id": "review_score-80", "selected": false, "name": "Very Good: 8+" }, { "count": 2263, "url_id": "review_score=70", "source": "SELF_FILTER_GROUP", "field": "review_score", "generic_id": "review_score-70", "selected": false, "name": "Good: 7+" }, { "count": 2481, "url_id": "review_score=60", "source": "SELF_FILTER_GROUP", "field": "review_score", "generic_id": "review_score-60", "selected": false, "name": "Pleasant: 6+" }, { "count": 50, "url_id": "class=1", "source": "SELF_FILTER_GROUP", "field": "class", "generic_id": "class-1", "selected": false, "name": "1 star" }, { "count": 163, "url_id": "class=2", "source": "SELF_FILTER_GROUP", "field": "class", "generic_id": "class-2", "selected": false, "name": "2 stars" }, { "count": 871, "url_id": "class=3", "source": "SELF_FILTER_GROUP", "field": "class", "generic_id": "class-3", "selected": false, "name": "3 stars" }, { "count": 1218, "url_id": "class=4", "source": "SELF_FILTER_GROUP", "field": "class", "generic_id": "class-4", "selected": false, "name": "4 stars" }, { "count": 120, "url_id": "class=5", "source": "SELF_FILTER_GROUP", "field": "class", "generic_id": "class-5", "selected": false, "name": "5 stars" }, { "count": 2337, "url_id": "di=9580", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-9580", "selected": false, "name": "Guests' favorite area" }, { "count": 1211, "url_id": "di=9999997", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-9999997", "selected": false, "name": "Best areas outside center" }, { "count": 1126, "url_id": "di=2281", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-2281", "selected": false, "name": "Paris City Center" }, { "count": 234, "url_id": "di=8", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-8", "selected": false, "name": "8th arr." }, { "count": 219, "url_id": "di=9", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-9", "selected": false, "name": "9th arr." }, { "count": 203, "url_id": "di=7918", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-7918", "selected": false, "name": "Le Marais" }, { "count": 194, "url_id": "di=11167", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-11167", "selected": false, "name": "Champs ElysΓ©es" }, { "count": 185, "url_id": "di=15", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-15", "selected": false, "name": "15th arr." }, { "count": 183, "url_id": "di=10", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-10", "selected": false, "name": "10th arr." }, { "count": 180, "url_id": "di=2", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-2", "selected": false, "name": "2nd arr." }, { "count": 178, "url_id": "di=17", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-17", "selected": false, "name": "17th arr." }, { "count": 164, "url_id": "di=16", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-16", "selected": false, "name": "16th arr." }, { "count": 148, "url_id": "di=11", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-11", "selected": false, "name": "11th arr." }, { "count": 138, "url_id": "di=18", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-18", "selected": false, "name": "18th arr." }, { "count": 131, "url_id": "di=11213", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-11213", "selected": false, "name": "Saint Germain des Pres" }, { "count": 130, "url_id": "di=14", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-14", "selected": false, "name": "14th arr." }, { "count": 127, "url_id": "di=6", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-6", "selected": false, "name": "6th arr." }, { "count": 125, "url_id": "di=1", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-1", "selected": false, "name": "1st arr." }, { "count": 123, "url_id": "di=12", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-12", "selected": false, "name": "12th arr." }, { "count": 120, "url_id": "di=5", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-5", "selected": false, "name": "5th arr." }, { "count": 118, "url_id": "di=3", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-3", "selected": false, "name": "3rd arr." }, { "count": 118, "url_id": "di=7970", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-7970", "selected": false, "name": "Latin Quarter" }, { "count": 99, "url_id": "di=7", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-7", "selected": false, "name": "7th arr." }, { "count": 96, "url_id": "di=7917", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-7917", "selected": false, "name": "Les Halles" }, { "count": 88, "url_id": "di=7936", "source": "SELF_FILTER_GROUP", "field": "di", "generic_id": "di-7936", "selected": false, "name": "Montparnasse" }, { "count": 258, "url_id": "distance=1000", "source": "SELF_FILTER_GROUP", "field": "distance", "generic_id": "distance-1000", "selected": false, "name": "Less than 1 km" }, { "count": 1533, "url_id": "distance=3000", "source": "SELF_FILTER_GROUP", "field": "distance", "generic_id": "distance-3000", "selected": false, "name": "Less than 3 km" }, { "count": 2565, "url_id": "distance=5000", "source": "SELF_FILTER_GROUP", "field": "distance", "generic_id": "distance-5000", "selected": false, "name": "Less than 5 km" }, { "count": 297, "url_id": "popular_activities=11", "source": "SELF_FILTER_GROUP", "field": "popular_activities", "generic_id": "popular_activities-11", "selected": false, "name": "Fitness center" }, { "count": 261, "url_id": "popular_activities=253", "source": "SELF_FILTER_GROUP", "field": "popular_activities", "generic_id": "popular_activities-253", "selected": false, "name": "Fitness" }, { "count": 206, "url_id": "popular_activities=55", "source": "SELF_FILTER_GROUP", "field": "popular_activities", "generic_id": "popular_activities-55", "selected": false, "name": "Massage" }, { "count": 166, "url_id": "popular_activities=404", "source": "SELF_FILTER_GROUP", "field": "popular_activities", "generic_id": "popular_activities-404", "selected": false, "name": "Walking tours" }, { "count": 159, "url_id": "popular_activities=54", "source": "SELF_FILTER_GROUP", "field": "popular_activities", "generic_id": "popular_activities-54", "selected": false, "name": "Spa" }, { "count": 904, "url_id": "stay_type=1", "source": "SELF_FILTER_GROUP", "field": "stay_type", "generic_id": "stay_type-1", "selected": false, "name": "Pet friendly" }, { "count": 251, "url_id": "stay_type=3", "source": "SELF_FILTER_GROUP", "field": "stay_type", "generic_id": "stay_type-3", "selected": false, "name": "Family-Friendly Properties" }, { "count": 208, "url_id": "stay_type=4", "source": "SELF_FILTER_GROUP", "field": "stay_type", "generic_id": "stay_type-4", "selected": false, "name": "Travel Proud (LGBTQ+ friendly)" }, { "count": 2765, "url_id": "oos=1", "source": "SELF_FILTER_GROUP", "field": "oos", "generic_id": "oos-1", "selected": false, "name": "Only show available properties" }, { "count": 1525, "url_id": "fc=2", "source": "SELF_FILTER_GROUP", "field": "fc", "generic_id": "fc-2", "selected": false, "name": "Free cancellation" }, { "count": 43, "url_id": "chaincode=3292", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-3292", "selected": false, "name": "Belvilla" }, { "count": 36, "url_id": "chaincode=15712", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-15712", "selected": false, "name": "Studio Prestige" }, { "count": 32, "url_id": "chaincode=1053", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1053", "selected": false, "name": "ibis" }, { "count": 31, "url_id": "chaincode=1051", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1051", "selected": false, "name": "Mercure" }, { "count": 29, "url_id": "chaincode=15713", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-15713", "selected": false, "name": "Check My Guest" }, { "count": 25, "url_id": "chaincode=3086", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-3086", "selected": false, "name": "ibis Styles" }, { "count": 16, "url_id": "chaincode=1166", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1166", "selected": false, "name": "Astotel" }, { "count": 14, "url_id": "chaincode=7352", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-7352", "selected": false, "name": "HipHop Hostels" }, { "count": 12, "url_id": "chaincode=1029", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1029", "selected": false, "name": "Best Western" }, { "count": 12, "url_id": "chaincode=11860", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-11860", "selected": false, "name": "HappyCulture" }, { "count": 10, "url_id": "chaincode=1050", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1050", "selected": false, "name": "Novotel" }, { "count": 10, "url_id": "chaincode=1585", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1585", "selected": false, "name": "Citadines" }, { "count": 10, "url_id": "chaincode=11865", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-11865", "selected": false, "name": "Emeraude France" }, { "count": 9, "url_id": "chaincode=3707", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-3707", "selected": false, "name": "Adagio Aparthotels" }, { "count": 8, "url_id": "chaincode=15752", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-15752", "selected": false, "name": "HIGHSTAY" }, { "count": 6, "url_id": "chaincode=15627", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-15627", "selected": false, "name": "Hotels Prince Albert" }, { "count": 5, "url_id": "chaincode=1072", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1072", "selected": false, "name": "Holiday Inn Hotels & Resorts" }, { "count": 5, "url_id": "chaincode=1510", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1510", "selected": false, "name": "Small Luxury Hotels of the World" }, { "count": 5, "url_id": "chaincode=1936", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-1936", "selected": false, "name": "MGallery" }, { "count": 5, "url_id": "chaincode=3186", "source": "SELF_FILTER_GROUP", "field": "chaincode", "generic_id": "chaincode-3186", "selected": false, "name": "ibis Budget" }, { "count": 994, "url_id": "tdb=2", "source": "SELF_FILTER_GROUP", "field": "tdb", "generic_id": "tdb-2", "selected": false, "name": "Twin beds" }, { "count": 2698, "url_id": "tdb=3", "source": "SELF_FILTER_GROUP", "field": "tdb", "generic_id": "tdb-3", "selected": false, "name": "Double bed" }, { "count": 151, "url_id": "SustainablePropertyLevelFilter=4", "source": "SELF_FILTER_GROUP", "field": "SustainablePropertyLevelFilter", "generic_id": "SustainablePropertyLevelFilter-4", "selected": false, "name": "Sustainability certification" }, { "count": 528, "url_id": "rated_high=1", "source": "SELF_FILTER_GROUP", "field": "rated_high", "generic_id": "rated_high-1", "selected": false, "name": "Very good breakfast" }, { "count": 2415, "url_id": "pmt=101", "source": "SELF_FILTER_GROUP", "field": "pmt", "generic_id": "pmt-101", "selected": false, "name": "Accepts online payments" }, { "count": 1162, "url_id": "mealplan=1", "source": "POPULAR", "field": "mealplan", "generic_id": "mealplan-1", "selected": false, "name": "Breakfast included" }, { "count": 1554, "url_id": "ht_id=204", "source": "POPULAR", "field": "ht_id", "generic_id": "ht_id-204", "selected": false, "name": "Hotels" }, { "count": 412, "url_id": "review_score=90", "source": "POPULAR", "field": "review_score", "generic_id": "review_score-90", "selected": false, "name": "Wonderful: 9+" }, { "count": 159, "url_id": "hotelfacility=54", "source": "POPULAR", "field": "hotelfacility", "generic_id": "hotelfacility-54", "selected": false, "name": "Spa" }, { "count": 1525, "url_id": "fc=2", "source": "POPULAR", "field": "fc", "generic_id": "fc-2", "selected": false, "name": "Free cancellation" }, { "count": 1126, "url_id": "di=2281", "source": "POPULAR", "field": "di", "generic_id": "di-2281", "selected": false, "name": "Paris City Center" }, { "count": 258, "url_id": "distance=1000", "source": "POPULAR", "field": "distance", "generic_id": "distance-1000", "selected": false, "name": "Less than 1 km" }, { "count": 566, "url_id": "hotelfacility=2", "source": "POPULAR", "field": "hotelfacility", "generic_id": "hotelfacility-2", "selected": false, "name": "Parking" }, { "count": 871, "url_id": "class=3", "source": "POPULAR", "field": "class", "generic_id": "class-3", "selected": false, "name": "3 stars" }, { "count": 1255, "url_id": "ht_id=201", "source": "POPULAR", "field": "ht_id", "generic_id": "ht_id-201", "selected": false, "name": "Apartments" }, { "count": 1536, "url_id": "hotelfacility=8", "source": "POPULAR", "field": "hotelfacility", "generic_id": "hotelfacility-8", "selected": false, "name": "24-hour front desk" }, { "count": 219, "url_id": "di=9", "source": "POPULAR", "field": "di", "generic_id": "di-9", "selected": false, "name": "9th arr." }, { "count": 97, "url_id": "hotelfacility=433", "source": "POPULAR", "field": "hotelfacility", "generic_id": "hotelfacility-433", "selected": false, "name": "Swimming pool" }, { "count": 1, "url_id": "ht_id=213", "source": "POPULAR", "field": "ht_id", "generic_id": "ht_id-213", "selected": false, "name": "Villas" }, { "count": 9, "url_id": "ht_id=208", "source": "POPULAR", "field": "ht_id", "generic_id": "ht_id-208", "selected": false, "name": "Bed and Breakfasts" }, { "count": 123, "url_id": "di=12", "source": "POPULAR", "field": "di", "generic_id": "di-12", "selected": false, "name": "12th arr." }, { "count": 456, "url_id": "accessible_facilities=186", "source": "SELF_FILTER_GROUP", "field": "accessible_facilities", "generic_id": "accessible_facilities-186", "selected": false, "name": "Toilet with grab rails" }, { "count": 322, "url_id": "accessible_facilities=187", "source": "SELF_FILTER_GROUP", "field": "accessible_facilities", "generic_id": "accessible_facilities-187", "selected": false, "name": "Raised toilet" }, { "count": 375, "url_id": "accessible_facilities=188", "source": "SELF_FILTER_GROUP", "field": "accessible_facilities", "generic_id": "accessible_facilities-188", "selected": false, "name": "Lowered sink" }, { "count": 79, "url_id": "accessible_facilities=189", "source": "SELF_FILTER_GROUP", "field": "accessible_facilities", "generic_id": "accessible_facilities-189", "selected": false, "name": "Bathroom emergency cord" }, { "count": 86, "url_id": "accessible_facilities=211", "source": "SELF_FILTER_GROUP", "field": "accessible_facilities", "generic_id": "accessible_facilities-211", "selected": false, "name": "Visual aids (Braille)" }, { "count": 52, "url_id": "accessible_facilities=212", "source": "SELF_FILTER_GROUP", "field": "accessible_facilities", "generic_id": "accessible_facilities-212", "selected": false, "name": "Visual aids (tactile signs)" }, { "count": 26, "url_id": "accessible_facilities=213", "source": "SELF_FILTER_GROUP", "field": "accessible_facilities", "generic_id": "accessible_facilities-213", "selected": false, "name": "Auditory guidance" }, { "count": 332, "url_id": "accessible_room_facilities=131", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-131", "selected": false, "name": "Entire unit located on ground floor" }, { "count": 1055, "url_id": "accessible_room_facilities=132", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-132", "selected": false, "name": "Upper floors accessible by elevator" }, { "count": 407, "url_id": "accessible_room_facilities=134", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-134", "selected": false, "name": "Entire unit wheelchair accessible" }, { "count": 261, "url_id": "accessible_room_facilities=147", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-147", "selected": false, "name": "Toilet with grab rails" }, { "count": 132, "url_id": "accessible_room_facilities=148", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-148", "selected": false, "name": "Adapted bath" }, { "count": 277, "url_id": "accessible_room_facilities=149", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-149", "selected": false, "name": "Roll-in shower" }, { "count": 495, "url_id": "accessible_room_facilities=150", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-150", "selected": false, "name": "Walk-in shower" }, { "count": 189, "url_id": "accessible_room_facilities=151", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-151", "selected": false, "name": "Raised toilet" }, { "count": 203, "url_id": "accessible_room_facilities=152", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-152", "selected": false, "name": "Lower sink" }, { "count": 29, "url_id": "accessible_room_facilities=153", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-153", "selected": false, "name": "Emergency cord in bathroom" }, { "count": 187, "url_id": "accessible_room_facilities=154", "source": "SELF_FILTER_GROUP", "field": "accessible_room_facilities", "generic_id": "accessible_room_facilities-154", "selected": false, "name": "Shower chair" } ] } ``` ### πŸš€ Use Cases πŸ“ˆ Hotel price monitoring & revenue intelligence 🧭 Travel market research 🏨 Competitor benchmarking πŸ“Š Availability & demand analysis 🧠 AI & ML training datasets πŸ—ΊοΈ Location-based accommodation analysis πŸ§ͺ A/B testing of Booking.com search filters πŸ“‰ Low-availability & scarcity tracking ### πŸ’‘ Notes All extracted data is publicly available Prices and availability may vary based on: - Dates - Location - Currency Sponsored listings and ads are clearly flagged Output is schema-stable and suitable for automation Large searches may return thousands of results without a limit set ### πŸ›Ÿ SUPPORT Share your runs with the developer team and create issues on error to help us improve actor quality. You might discover edge case we didn't test yet We stay available anytime # Actor input Schema ## `feature` (type: `string`): Search or metadata ## `destination` (type: `string`): Where ? Provide city name ## `checkin` (type: `string`): Provide dates for your stay. Both checkin and checkout need to be provided, else we use today and today + 1 ## `checkout` (type: `string`): Provide dates for your stay. Both checkin and checkout need to be provided, else we use today and today + 1 ## `flex_days` (type: `string`): Select if flexible days ## `max_results` (type: `integer`): 0 or empty = no limit ## `nb_rooms` (type: `integer`): No description ## `nb_adults` (type: `integer`): No description ## `nb_children` (type: `integer`): No description ## `children_ages` (type: `array`): 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] ## `price_min` (type: `integer`): 0, means no price filters ## `price_max` (type: `integer`): 0, means no price filters ## `currency` (type: `string`): Select your currency ## `lang` (type: `string`): Select your language ## `sort` (type: `string`): Select your filter ## `entire_place_bedroom` (type: `integer`): 0, means no bedrooms filters ## `min_bathrooms` (type: `integer`): 0, means no bathrooms filters ## `list_selected_filters` (type: `array`): Multi Select your filter ## Actor input object example ```json { "feature": "search", "destination": "Paris", "checkin": "", "checkout": "", "flex_days": "0", "max_results": 25, "nb_rooms": 1, "nb_adults": 1, "nb_children": 0, "children_ages": [], "price_min": 0, "price_max": 0, "currency": "USD", "lang": "en-us", "sort": "", "entire_place_bedroom": 0, "min_bathrooms": 0, "list_selected_filters": [] } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "destination": "Paris", "max_results": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("saswave/booking-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "destination": "Paris", "max_results": 25, } # Run the Actor and wait for it to finish run = client.actor("saswave/booking-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "destination": "Paris", "max_results": 25 }' | apify call saswave/booking-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=saswave/booking-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "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 } } } } } } } } } } ```