# Booking Explorer 🐾 (`jupri/booking-hotels`) Actor 💫 Scrape Booking.com Hotels - **URL**: https://apify.com/jupri/booking-hotels.md - **Developed by:** [cat](https://apify.com/jupri) (community) - **Categories:** Travel - **Stats:** 474 total users, 3 monthly users, 96.1% runs succeeded, 15 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Welcome to Booking.com Explorer ### 📘 About Booking.com **Booking.com** is a Dutch online [travel agency](https://en.wikipedia.org/wiki/Travel_agency "Travel agency") for [lodging](https://en.wikipedia.org/wiki/Lodging "Lodging") reservations & other travel products, and a subsidiary of [Booking Holdings](https://en.wikipedia.org/wiki/Booking_Holdings "Booking Holdings"). It is headquartered in [Amsterdam](https://en.wikipedia.org/wiki/Amsterdam "Amsterdam").[\[1\]](https://en.wikipedia.org/wiki/Booking.com#cite_note-1) The website has over 28 million listings.[\[2\]](https://en.wikipedia.org/wiki/Booking.com#cite_note-about-2) The site is available in 43 languages.[\[2\]](https://en.wikipedia.org/wiki/Booking.com#cite_note-about-2) ### 📘 Tutorials #### 📖 Basic Usage Searching 100 hotels in paris. ```yaml { "location" : ["paris"], "limit" : 100 # default = 1 } ``` #### 📖 Pricing Informations To find out pricing information, provide `check_in`, `check_out`, number of `rooms` and number of visitors: `adults` and `children` ages *(**example:** total children 4: 1 infant (0 year), 2 children age 5, and 1 children age 7)* ```yaml { "location" : ["paris"], "limit" : 100, "check_in" : "2024-03-14", "check_out" : "2024-03-20", "rooms" : 2, "adults" : 3, "children" : "0, 5, 5, 7" } ``` #### 📖 Date Inputs (Advanced) ##### There are 2 modes of date input : ##### Mode #1: Calendar `[check_in, check_out, flex_days]` | Parameter | Type | Description | |-|-|-| | `date_mode` | **string** | `"Calendar"` *(optional)* | `check_in` | **string** | Check-In Date | `check_out` | **string** | Check-Out Date | `flex_days` | **number** | Flexible days *example :* ```yaml { ... "date_mode": "calendar", # optional (can be empty) "check_in": "2025-01-10", "check_out": "2025-01-20", "flex_days": 3, ... } ``` ##### Mode #2: Flexible `[A weekend / A Week / A Month / Other (Custom)]` | Parameter | Type | Description | |-|-|-| | `date_mode` | **string** | One of: `weekend / week / month / other` | `flex_months` | **array** | Check-In months `(1=January, 2=February, etc.)` | `flex_nights` | **number** | Number of nights `(used for date_mode=other)` | `flex_from` | **number** | Start of Day: `1=Monday, etc.` `(used for date_mode=other)` *example #1: weekend / week / month* ```yaml { ... "date_mode": "wekend", # required: weekend / week / month "flex_months": ["1", "2", "3"], # January, February, March, etc. ... } ``` *example #2: other (custom)* ```yaml { ... "date_mode": "other", "flex_months": ["1", "2", "3"], # January, February, March, etc. "flex_nights": 20, # 20 nights "flex_from": 1 # Monday ... } ``` #### 📖 Additional Info Additional informations requires more time and network consumptions. | Parameters | Type | Description | Additional Attributes| |-|-|-|-| |`includes.description`|***boolean***|long descriptions|`description`| |`includes.fineprints`|***boolean***|hotel fineprints|`fineprints`| |`includes.facilities`|***boolean***|grouped facilities, restaurants and meals information|`facilities`, `highlights`, `restaurants`, `meals`| |`includes.policies`|***boolean***|hotel rules/policies, payment methods|`policies`| |`includes.questions`|***integer***|questions and answers (numbers)|`questions`| |`includes.surroundings`|***boolean***|surrondings area (point of interests)|`surrondings `| |`includes.gallery`|***boolean***|images gallery|`gallery`| |`includes.host`|***boolean***|host profiles|`host`| |`includes.rooms`|***boolean***|room list|`rooms`| ### 📘 Output Samples #### 📖 Basic Info ```yaml { "id": 23049, "location": { "distance": "3.7 km from center", "name": "Beyoglu, Istanbul", "transport": "Taksim Metro station is within 400 meters" }, "name": "Taxim Suites Residences Istanbul", "date": { "checkin": "2024-03-19", "checkout": "2024-03-20" }, "address": { "city": "Istanbul", "country": "tr", "latitude": 41.0405019621544, "longitude": 28.9859864115715, "street": "Cumhuriyet Cad. No:31 Beyoğlu" }, "blocks": [ { "final": { "amount": 132.27831226244, "currency": "USD" }, "occupancy": 3, "original": { "amount": 121.49, "currency": "EUR" }, "roomId": "2304901" } ], "configuration": { "common": { "allBeds": 2, "area": { "area": "44", "unit": "m²" }, "bathrooms": 1, "bedConfigurations": [ { "allBeds": 2, "beds": [ { "count": 1, "type": 2 }, { "count": 1, "type": 5 } ] } ], "bedrooms": 1, "livingrooms": 1, "maxAdults": 3, "maxChildren": 1, "unitTypeNames": [ { "translation": "Private suite" } ], "units": 1 }, "units": [ { "allBeds": 2, "apartmentRooms": [ { "config": { "bedCount": 1, "bedTypeId": 2, "roomId": 71392642, "roomType": "Bedroom" } }, { "config": { "bedCount": 1, "bedTypeId": 5, "roomId": 71392643, "roomType": "Living Room" } } ], "area": { "area": "44", "unit": "m²" }, "bathrooms": 1, "bedConfigurations": [ { "allBeds": 2, "beds": [ { "count": 1, "type": 2 }, { "count": 1, "type": 5 } ] } ], "bedrooms": 1, "livingrooms": 1, "maxAdults": 3, "maxChildren": 1, "name": "Park Suite with Taksim Park View", "unitId": 2304901, "unitTypeNames": [ { "translation": "Private suite" } ], "units": 1 } ] }, "photos": { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/square600/415863524.jpg?k=454e233b1370009e95e85b081583c132bd7c1f4a1da59a8e2804db6ce1edf9a6&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/square200/415863524.jpg?k=454e233b1370009e95e85b081583c132bd7c1f4a1da59a8e2804db6ce1edf9a6&o=" }, "plus": true, "preferred": true, "price": { "charges": "Includes taxes and fees", "discounts": [ { "amount": 215.66, "currency": "USD", "text": "Last-minute Deal", "type": "rate" }, { "amount": 11.5, "currency": "USD", "text": "Booking.com pays", "type": "total" } ], "original": { "amount": 359.43, "currency": "USD", "text": "US$359.43 × 1 night" }, "summary": { "amount": 132.28, "currency": "USD", "text": "Total" } }, "rating": 4, "reviews": { "count": 1587, "score": 8.3, "secondary": { "score": 9.3, "text": "Location" }, "text": "Very Good" }, "sustainability": { "facilities": [ 182, 435, 436, 439, 440, 441, 442, 443, 444, 445, 446, 448, 489, 490, 491, 492, 493, 494, 495, 496, 498, 499, 506 ], "sustainable": true, "tier": "SILVER" }, "type": "Condo Hotels", "type_id": 219, "ufi": -755070, "url": "https://www.booking.com/hotel/tr/istanbul-taxim-suites.html" } ``` #### 📖 Description `[includes.description]` ```yaml ... "description": "Taxim Suites Residences Istanbul is conveniently located in the heart of Istanbul, just steps away from the famous Taksim Square and Gezi Park. Hotel provides long or short term homes for the guests seeking a cozy ambiance. It features accommodations with air conditioning, LCD TV and free WiFi.\n\nRooms at Taxim Suites Istanbul feature a décor. Property also offers designer suites with spacious living rooms and bedrooms. Certain rooms include a fully equipped kitchen or kitchenette with a microwave and a refrigerator. Each of the suites has minimalistic interiors, influenced by the Far East. Some suites feature a spa bathtub.\n\nOn-site restaurant offers guests a wide range of choices.\n\nThe hotel features laundry facilities consisting of washing machines and dryers for the use of our guests. The tour desk and car rental are also offered by Taxim Suites Residences Istanbul. 24-hour front desk and concierge service are available. Shuttle service is also provided.\n\nGuests can have a short walk to Istiklal Avenue, a vibrant shopping and entertainment district, and enjoy its atmosphere. Nisantasi shopping district is less than a 10-minute drive away. Taxim Suites Residences Istanbul faces the Taksim metro station in Gezi Parkı, just a few steps away, allowing guests easy access to the rest of Istanbul’s many attractions, such as Topkapi Palace, Blue Mosque, Hagia Sophia and Grand Bazaar. Lutfi Kirdar Convention Center, Istanbul Congress Center, Cemal Resit Rey Concert Hall and Muhsin Ertugrul Theater are within 0.6 mi distance. Ataturk International Airport is 16 mi from the property. Istanbul Airport is 31 mi from the property.", ... ``` #### 📖 Fineprints `[includes.fineprints]` ```yaml ... "fineprints": [ "This property is located in a busy area and guests may experience noise.", "Guests are required to show a photo ID and credit card upon check-in. Please note that all Special Requests are subject to availability and additional charges may apply.", "Please inform Taxim Suites Residences Istanbul of your expected arrival time in advance. You can use the Special Requests box when booking, or contact the property directly using the contact details in your confirmation.", "This property does not accommodate bachelor(ette) or similar parties.", "In accordance with government guidelines to minimize transmission of the coronavirus (COVID-19), this property currently isn't accepting guests from certain countries on dates where such guidelines exist.", "In response to the coronavirus (COVID-19), additional safety and sanitation measures are in effect at this property.", "Food and beverage services at this property may be limited or unavailable due to the coronavirus (COVID-19).", "Due to the coronavirus (COVID-19), wearing a face mask is mandatory in all indoor common areas.", "Coronavirus (COVID-19) PCR tests are available at this property at no extra charge for those exhibiting symptoms consistent with the virus and have been confirmed by an accredited doctor." ], ... ``` #### 📖 Facilities `[includes.facilities]` ```yaml ... "highlights": [ { "title": "Apartments" }, { "id": 47, "isFree": true, "level": "property", "title": "Free WiFi" }, { "id": 38, "level": "room", "title": "Private Bathroom" }, { "id": 17, "level": "property", "title": "Airport shuttle" }, { "id": 28, "level": "property", "title": "Family rooms" }, { "id": 14, "level": "room", "title": "Hot tub" }, { "id": 108, "level": "room", "title": "Sea view" }, { "id": 81, "level": "room", "title": "View" }, { "id": 11, "level": "room", "title": "Air conditioning" }, { "id": 5, "level": "room", "title": "Bathtub" } ], ... ``` ```yaml ... "meals": [ { "attributes": { "foodScore": { "nReviews": 4, "score": 6.9 }, "openingTime": { "endTime": "11:00", "startTime": "09:30" } }, "mealType": "BREAKFAST" } ], ... ``` ```yaml ... "restaurants": [ { "title": "Minibar" }, { "attributes": { "extendedAttributes": { "isAlacarte": true, "ambiances": [ { "id": 1, "name": "Family friendly" } ], "cuisines": [ { "id": 42, "name": "Turkish" } ], "mealTypes": [ { "id": 1, "name": "Halal" } ], "openForMeals": [ { "id": 1, "name": "Breakfast" } ] }, "name": "Restoran #1" }, "title": "Restaurant" } ] ... ``` ```yaml ... "facilities": [ { "groupId": 4, "items": [ { "id": 184, "instances": [ { "title": "Socket near the bed" } ], "slug": "socket_near_the_bed" }, { "id": 138, "instances": [ { "title": "Clothes rack" } ], "slug": "clothes_rack" }, { "id": 115, "instances": [ { "title": "Hypoallergenic" } ], "slug": "allergyfree" }, { "id": 82, "instances": [ { "title": "Hardwood or parquet floors" } ], "slug": "wooden__parquet_floor" }, { "id": 25, "instances": [ { "title": "Ironing facilities" } ], "slug": "ironing_facilities" }, { "id": 15, "instances": [ { "title": "Iron" } ], "slug": "clothing_iron" } ], "slug": "room_amenities", "title": "Room Amenities" }, { "groupId": 5, "items": [ { "id": 141, "instances": [ { "title": "Toilet paper" } ], "slug": "toilet_paper" }, { "id": 124, "instances": [ { "title": "Towels" } ], "slug": "towels" }, { "id": 43, "instances": [ { "title": "Slippers" } ], "slug": "slippers" }, { "id": 38, "instances": [ { "attributes": { "extendedAttributes": { "bathroomLocation": "INSIDE_THE_ROOM", "bathroomType": "PRIVATE", "gender": "UNKNOWN_GENDER" } }, "title": "Private Bathroom" } ], "slug": "private_bathroom" }, { "id": 31, "instances": [ { "title": "Toilet" } ], "slug": "toilet" }, { "id": 27, "instances": [ { "title": "Free toiletries" } ], "slug": "free_toiletries" }, { "id": 19, "instances": [ { "title": "Bathrobe" } ], "slug": "bathrobe" }, { "id": 12, "instances": [ { "title": "Hairdryer" } ], "slug": "hair_dryer" }, { "id": 4, "instances": [ { "title": "Shower" } ], "slug": "shower" } ], "slug": "bathroom", "title": "Bathroom" }, { "groupId": 6, "items": [ { "id": 75, "instances": [ { "title": "Flat-screen TV" } ], "slug": "flatscreen_tv" }, { "id": 74, "instances": [ { "title": "Laptop safe" } ], "slug": "laptop_safe_box" }, { "id": 44, "instances": [ { "title": "Satellite channels" } ], "slug": "satellite_channels" }, { "id": 9, "instances": [ { "title": "Telephone" } ], "slug": "telephone" }, { "id": 8, "instances": [ { "title": "TV" } ], "slug": "tv" } ], "slug": "mediatechnology", "title": "Media & Technology" }, { "groupId": 8, "items": [ { "id": 83, "instances": [ { "title": "Wake-up service" } ], "slug": "wake_up_service" }, { "id": 13, "instances": [ { "title": "Wake-up service/Alarm clock" } ], "slug": "wake_up_servicealarmclock" } ], "slug": "servicesextras", "title": "Services & Extras" }, { "groupId": 9, "items": [ { "id": 121, "instances": [ { "title": "City view" } ], "slug": "city_view" } ], "slug": "outdoorview", "title": "Outdoor & View" }, { "groupId": 11, "items": [ { "id": 47, "instances": [ { "attributes": { "extendedAttributes": { "connectionType": "WIFI", "coverageArea": "ENTIRE_PROPERTY" }, "paymentInfo": { "chargeDetails": { "currency": "EUR", "frequency": "UNKNOWN_FREQUENCY" }, "chargeMode": "FREE" } }, "title": "Internet" } ], "slug": "internet_services" } ], "slug": "internet", "summary": "WiFi is available in all areas and is free of charge.", "title": "Internet" }, { "groupId": 12, "items": [ { "id": 116, "instances": [ { "title": "Cleaning products" } ], "slug": "cleaning_products" }, { "id": 86, "instances": [ { "title": "Electric kettle" } ], "slug": "electric_kettle" } ], "slug": "kitchen", "title": "Kitchen" }, { "groupId": 15, "items": [ { "id": 23, "instances": [ { "title": "Desk" } ], "slug": "desk" } ], "slug": "living_area", "title": "Living Area" }, { "groupId": 16, "items": [ { "id": 2, "instances": [ { "attributes": { "extendedAttributes": { "reservation": "NOT_NEEDED", "type": "PUBLIC" }, "isOffsite": true, "paymentInfo": { "chargeDetails": { "currency": "EUR", "frequency": "PER_DAY", "price": 25 }, "chargeMode": "PAID" } }, "subFacilities": [ { "instances": [ { "title": "Parking garage" } ], "slug": "parking_garage" }, { "instances": [ { "title": "Electric vehicle charging station" } ], "slug": "electric_charging_station_at_property" }, { "instances": [ { "title": "Accessible parking" } ], "slug": "accessible_parking" } ], "title": "Parking" } ], "slug": "parking_fee_required" } ], "slug": "parking", "summary": "Public parking is available at a location nearby (reservation is not needed) and costs € 25 per day.", "title": "Parking" }, { "groupId": 17, "items": [ { "id": 125, "instances": [ { "title": "Linens" } ], "slug": "linen" }, { "id": 95, "instances": [ { "title": "Wardrobe or closet" } ], "slug": "wardrobecloset" } ], "slug": "bedroom", "title": "Bedroom" }, { "groupId": 19, "items": [ { "id": 132, "instances": [ { "title": "Upper floors accessible by elevator" } ], "slug": "upper_floor_reachable_by_lift" } ], "slug": "accessibility", "title": "Accessibility" }, { "groupId": 22, "items": [ { "id": 447, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Bicycle rental" } ], "slug": "bike_rental" }, { "id": 304, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Shuttle service" } ], "slug": "shuttle_service" }, { "id": 183, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Public transit tickets" } ], "slug": "public_transport_tickets" }, { "id": 75, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Car rental" } ], "slug": "car_rental" }, { "id": 17, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Airport shuttle" }, { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Airport pickup" }, { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Airport drop-off" } ], "slug": "airport_shuttle" } ], "slug": "transportation", "title": "Transportation" }, { "groupId": 23, "items": [ { "id": 465, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Invoice provided" } ], "slug": "invoices_provided" }, { "id": 127, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Private check-in/out" } ], "slug": "private_checkinout" }, { "id": 124, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Concierge" } ], "slug": "concierge_service" }, { "id": 91, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "FREE" } }, "title": "Baggage storage" } ], "slug": "luggage_storage" }, { "id": 78, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Tour desk" } ], "slug": "tour_desk" }, { "id": 49, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "FREE" } }, "title": "Express check-in/out" } ], "slug": "express_checkincheckout" }, { "id": 8, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "24-hour front desk" } ], "slug": "hour_front_desk" } ], "slug": "frontdeskreception_area_services", "title": "Front Desk Services" }, { "groupId": 26, "items": [ { "id": 158, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "FREE" } }, "title": "Daily housekeeping" } ], "slug": "daily_maid_service" }, { "id": 134, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Suit press" } ], "slug": "trouser_press" }, { "id": 44, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Ironing service" } ], "slug": "ironing_service" }, { "id": 23, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Dry cleaning" } ], "slug": "dry_cleaning" }, { "id": 22, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "PAID" } }, "title": "Laundry" } ], "slug": "laundry" } ], "slug": "cleaning_services", "title": "Cleaning Services" }, { "groupId": 27, "items": [ { "id": 81, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "FREE" } }, "title": "Fax/Photocopying" } ], "slug": "shops_on_the_premises" } ], "slug": "business_facilities", "title": "Business Facilities" }, { "groupId": 29, "items": [ { "id": 109, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "FREE" } }, "title": "Air conditioning" } ], "slug": "airconditioning" }, { "id": 80, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Heating" } ], "slug": "heating" }, { "id": 48, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Elevator" } ], "slug": "elevator" }, { "id": 28, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Family rooms" } ], "slug": "family_rooms" }, { "id": 16, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Non-smoking rooms" } ], "slug": "non_smoking_rooms" } ], "slug": "miscellaneous", "title": "Miscellaneous" }, { "groupId": 34, "items": [ { "id": 425, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Fire extinguishers" } ], "slug": "fire_extinguishers" }, { "id": 424, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "CCTV outside property" } ], "slug": "cctv_outside_public_areas_of_a_property" }, { "id": 423, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "CCTV in common areas" } ], "slug": "cctv_inside_public_areas_of_a_property" }, { "id": 422, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Smoke alarms" } ], "slug": "fire_alarmssmoke_detectors_in_public_areas_of_a_property" }, { "id": 421, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Security alarm" } ], "slug": "security_alarm" }, { "id": 420, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "Key card access" } ], "slug": "electronic_key_card_access" }, { "id": 418, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "UNKNOWN_CHARGE_MODE" } }, "title": "24-hour security" } ], "slug": "hour_security" }, { "id": 51, "instances": [ { "attributes": { "paymentInfo": { "chargeMode": "FREE" } }, "title": "Safe" } ], "slug": "safe_deposit_box" } ], "slug": "security_facilities", "title": "Safety & security" } ], ... ``` ##### 📖 Policies `[includes.policies]` ```yaml ... "policies": { "cancellation": { "hasDates": true }, "checkinAge": { "rule": "There's no age requirement for check-in" }, "checkinCheckoutTimes": { "CreditCardAndPhoto": "Guests are required to show a photo ID and credit card upon check-in. Please note that all Special Requests are subject to availability and additional charges may apply.", "NoticeOfArrivalTime": "Please inform Taxim Suites Residences Istanbul of your expected arrival time in advance. You can use the Special Requests box when booking, or contact the property directly using the contact details in your confirmation.", "checkin": { "from": "14:00", "until": "00:00" }, "checkout": { "until": "12:00" } }, "parties": { "rule": "This property does not accommodate bachelor(ette) or similar parties." }, "payment": { "cashStatus": "PATP_PROPERTY_ACCEPTS_CASH", "creditCards": [ { "id": 1, "name": "American Express" }, { "id": 2, "name": "Visa" }, { "id": 3, "name": "Mastercard" }, { "id": 5, "name": "Diners Club" }, { "id": 18, "name": "Cash only" } ] }, "pets": { "allowed": "NO", "charge": "NOT_APPLICABLE" } }, ... ``` ##### 📖 Questions `[includes.questions]` ```yaml ... "questions": [ { "answer": "Hello, Taksim is noisy indeed but we can arrange your room from upper floor it may help your situation.", "answer_ts": "28 August 2023", "id": 39306860, "question": "I know this is a noisy area. I am very sensitive to noise and a light sleeper. Are some of the suites very quiet?", "question_ts": "28 August 2023" }, { "answer": "We do not breakfast service. There is a restaurant under the building(connected from inside).", "answer_ts": "8 August 2022", "id": 28965504, "question": "Hi, is breakfast included in the offer?", "question_ts": "8 August 2022" }, { "answer": "Hi thank you for your message . All of our room's are with living room . Kind regards", "answer_ts": "4 April 2021", "id": 8501830, "question": "Hi I want only room Without living room", "question_ts": "2 April 2021" }, { "answer": "Dear Guest,\n\nOur all rooms is apartment. \n\nRegards,", "answer_ts": "26 May 2021", "id": 10380412, "question": "Hello,\nOn which floor apartment is?", "question_ts": "26 May 2021" }, { "answer": "Dear Guest,\n\nGreetings from Taxim Suites.\n\nOur room has 1 double bed and 1 sofa bed also if you need we will give you baby coat.\n\nRegards,", "answer_ts": "25 May 2021", "id": 10293102, "question": "The option shows \"fits 3 guests and 1 child\" but it also shows 1 bed. Will you provide sofa-bed for the year old child and crib for 1 year old baby.", "question_ts": "24 May 2021" } ], ... ``` #### 📖 Surroundings `[includes.surroundings]` ```yaml ... "surroundings": { "airports": [ { "distance": 29.795, "id": "37720", "name": "Istanbul Airport", "realDistance": { "commuteTime": { "byCar": "30 min" } }, "type": "Airports" }, { "distance": 30.05, "id": "37681", "name": "Istanbul Sabiha Gokcen International Airport", "realDistance": { "commuteTime": { "byCar": "32 min" } }, "type": "Airports" }, { "distance": 88.446, "id": "37388", "name": "Tekirdağ Çorlu Airport", "realDistance": { "commuteTime": { "byCar": "1 hr 24 min" } }, "type": "Airports" } ], "beaches": [ { "distance": 9.729, "id": "4580243", "name": "Caddebostan 1 Beach", "realDistance": { "commuteTime": { "byCar": "15 min" } }, "type": "Beaches" } ], "dining": { "cafeBars": [ { "distance": 0.089, "id": "1910637", "name": "Caffè Nero", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "1 min" } }, "type": "Cafes, Coffee, and Tea Houses" }, { "distance": 0.09, "id": "2013502", "name": "Cafe Italiano", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "1 min" } }, "type": "Cafes, Coffee, and Tea Houses" }, { "distance": 0.126, "id": "1909771", "name": "Fevk", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "1 min" } }, "type": "Cafes, Coffee, and Tea Houses" } ], "restaurants": [ { "distance": 0.018, "id": "11690685", "name": "View Point Restaurant", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "1 min" } }, "type": "Restaurants" }, { "distance": 0.018, "id": "12079272", "name": "Aftersix Bar", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "1 min" } }, "type": "Restaurants" } ] }, "landmarks": { "nearby": [ { "distance": 0.184, "id": "11183241", "name": "Capulcular Merkezi", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "3 min" } }, "type": "Urban Parks" }, { "distance": 0.196, "id": "11183253", "name": "Park", "realDistance": { "commuteTime": { "byCar": "2 min", "byFoot": "3 min" } }, "type": "Urban Parks" }, { "distance": 0.232, "id": "11183256", "name": "Geze Park", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "3 min" } }, "type": "Urban Parks" }, { "distance": 0.398, "id": "133197", "name": "Taksim Square", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "6 min" } }, "type": "Squares" }, { "distance": 0.608, "id": "11183262", "name": "Ömer Avni Parkı", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "9 min" } }, "type": "Urban Parks" }, { "distance": 0.621, "id": "11183249", "name": "Parkal", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "11 min" } }, "type": "Urban Parks" }, { "distance": 0.732, "id": "11183264", "name": "Maçka Demokrasi Parkı", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "15 min" } }, "type": "Urban Parks" }, { "distance": 0.793, "id": "11183261", "name": "Cihangir Çocuk Parkı", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "11 min" } }, "type": "Urban Parks" }, { "distance": 0.843, "id": "11183246", "name": "Esenler Yüzyıl Köprüsü", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "14 min" } }, "type": "Urban Parks" }, { "distance": 0.96, "id": "105501", "name": "Dolmabahce Clock Tower", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "13 min" } }, "type": "Monuments and Memorials" } ], "top": [ { "distance": 0.99, "id": "7127410", "name": "Cicek Passage", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "14 min" } }, "type": "Buildings and Structures" }, { "distance": 1.23, "id": "7127389", "name": "Dolmabahce Palace", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "18 min" } }, "type": "Architectural Buildings" }, { "distance": 1.334, "id": "111139", "name": "Pera Museum", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "20 min" } }, "type": "Museums" }, { "distance": 1.927, "id": "105107", "name": "Galata Tower", "realDistance": { "commuteTime": { "byCar": "3 min", "byFoot": "27 min" } }, "type": "Monuments and Memorials" }, { "distance": 2.644, "id": "105499", "name": "Maiden's Towers", "realDistance": { "commuteTime": { "byCar": "11 min" } }, "type": "Monuments and Memorials" }, { "distance": 3.114, "id": "107623", "name": "Topkapi Palace", "realDistance": { "commuteTime": { "byCar": "6 min" } }, "type": "Museums" }, { "distance": 3.597, "id": "7127471", "name": "Basilica Cistern", "realDistance": { "commuteTime": { "byCar": "5 min", "byFoot": "57 min" } }, "type": "Historic and Protected Sites" }, { "distance": 3.76, "id": "105684", "name": "Column of Constantine", "realDistance": { "commuteTime": { "byCar": "6 min", "byFoot": "55 min" } }, "type": "Monuments and Memorials" }, { "distance": 4.078, "id": "7132070", "name": "15 July Martyrs Bridge", "realDistance": { "commuteTime": { "byCar": "5 min" } }, "type": "Bridges" }, { "distance": 5.231, "id": "7127391", "name": "Istanbul Sapphire", "realDistance": { "commuteTime": { "byCar": "8 min" } }, "type": "Architectural Buildings" } ] }, "naturalBeauty": { "forest": [ { "distance": 3.45, "id": "11072868", "name": "Banaz Parkı", "realDistance": { "commuteTime": { "byCar": "4 min", "byFoot": "50 min" } }, "type": "Forests" } ] }, "publicTransport": { "metro": [ { "distance": 0.083, "id": "7135035", "name": "Taksim Metro Station-Gezi Parkı Exit", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "2 min" } }, "type": "Metro Stations" }, { "distance": 0.134, "id": "7135036", "name": "Taksim Metro Station-Talimhane Exit", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "2 min" } }, "type": "Metro Stations" } ], "train": [ { "distance": 0.397, "id": "4185486", "name": "Taksim", "realDistance": { "commuteTime": { "byCar": "1 min", "byFoot": "6 min" } }, "type": "Rail Stations" }, { "distance": 0.906, "id": "4193793", "name": "Kabataş", "realDistance": { "commuteTime": { "byCar": "2 min", "byFoot": "15 min" } }, "type": "Rail Stations" } ] } }, ... ``` #### 📖 Gallery `[includes.gallery]` ```yaml ... "gallery": [ { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/max1024x768/56147715.jpg?k=b859abd0abb07ae97103abb09ad128dd47a66de2cd17eb571d4c413365697fce&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/max200/56147715.jpg?k=b859abd0abb07ae97103abb09ad128dd47a66de2cd17eb571d4c413365697fce&o=" }, { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/max1024x768/56152096.jpg?k=5294dc69dfb13ba259ce51765abdc2991b8593908170109f5688ca6746ec3cba&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/max200/56152096.jpg?k=5294dc69dfb13ba259ce51765abdc2991b8593908170109f5688ca6746ec3cba&o=" }, { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/max1024x768/56152698.jpg?k=3c2a7caf7cbd75e4b47d7da443dad740cbe325ee6d69c8269907df1a6c734296&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/max200/56152698.jpg?k=3c2a7caf7cbd75e4b47d7da443dad740cbe325ee6d69c8269907df1a6c734296&o=" }, { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/max1024x768/182867058.jpg?k=4053516170570541758e6980918962a413e8e40261c13b8309aecf33a7b5e382&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/max200/182867058.jpg?k=4053516170570541758e6980918962a413e8e40261c13b8309aecf33a7b5e382&o=" }, { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/max1024x768/415859172.jpg?k=853cb95627b85dc906884076901d403bdea2b00b4e9217b43f424a923ae9475a&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/max200/415859172.jpg?k=853cb95627b85dc906884076901d403bdea2b00b4e9217b43f424a923ae9475a&o=" }, { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/max1024x768/415859173.jpg?k=2585c0d15d2c7b70b3005a7c3d384729e306ae7afaeeb6d9559c109201a78cc8&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/max200/415859173.jpg?k=2585c0d15d2c7b70b3005a7c3d384729e306ae7afaeeb6d9559c109201a78cc8&o=" }, { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/max1024x768/415859174.jpg?k=c55a07825728516cccc983aab0f666659578271f100fb6910e09f17aab292378&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/max200/415859174.jpg?k=c55a07825728516cccc983aab0f666659578271f100fb6910e09f17aab292378&o=" }, { "hi": "https://t-cf.bstatic.com/xdata/images/hotel/max1024x768/415859175.jpg?k=ed34618ddecdd6bcd09a29b3337872a2c82ac3c3d13e95d473dea4b4c0342cfa&o=", "lo": "https://t-cf.bstatic.com/xdata/images/hotel/max200/415859175.jpg?k=ed34618ddecdd6bcd09a29b3337872a2c82ac3c3d13e95d473dea4b4c0342cfa&o=" } ], ... ``` #### 📖 Host `[includes.host]` ```yaml ... "host": { "info": { "name": "Bono Turizm Yat. San ve Tic. Ltd Şti.", "professionalInfo": { "managedProperties": 1, "yearsOnWebsite": 13 }, "reviews": { "count": 1564, "score": 9.2 } }, "messages": { "familyTips": "Taxim Suites Istanbul's rooms are stylish and elegantly decorated. Some of the rooms overlook the Bosphorus. The hotel also offers specially designed suites with spacious living rooms and bedrooms. Some rooms have a fully equipped kitchen or kitchenette with a microwave and refrigerator. Each suite features minimalist interiors with elegant, modern and stylishly designed City or Bosphorus views. Guests can make tea and coffee with the heater provided free of charge in the rooms. Featuring a desk and seating area, each room has a private bathroom with toiletries. Slippers, towels, bathrobes and a hairdryer are provided. A safe deposit box is standard in each room. Some suites have a jacuzzi.\n\nGuests can choose from a menu of international and local specialties served à la carte in the on-site restaurant. There are many restaurants around the hotel for breakfast, lunch and dinner.\n\nThe hotel has a 24-hour front desk and provides concierge service. Minibar items are available at the reception. The friendly staff at Taxim Suites & Residences Istanbul can assist guests with SPA & Turkish Bath reservation, car rental service, transfer service, dry cleaning service, ticket service, information about tourist attractions. The hotel has a laundry room with washing machines and dryers for guests' use.", "languageCode": "en", "neighboorhoodInfo": "You can enjoy the lively atmosphere in Istiklal Street, the shopping and entertainment district, which can be reached by a short walk. The Nisantasi entertainment and shopping district with world-famous brands can be reached in less than 5 minutes by car. There are also many popular medical and aesthetic centers in Nişantaşı. The American Hospital is 1.8 km away and Acibadem Taksim Hospital is just 1 km away. Taksim Suites & Residences Istanbul is a 1-minute walk from Taksim Metro Station in Gezi Park, which provides easy access to many other Istanbul attractions such as Old City, Topkapi Palace, Blue Mosque, Hagia Sophia and Grand Bazaar. Taksim Suites is in the hotels area and Vodafone Park ( Besiktas JK Stadium ) is 1 km away and Dolmabahce Palace is 1.1 km away. It is a 5-minute walk from the Ataturk Cultural Center (AKM). Lütfi Kırdar Congress and Exhibition Center, Istanbul Congress Center, Cemal Reşit Rey Concert Hall and Muhsin Ertuğrul Theater are 1 km away. Cevahir Shopping Center is 3 km away, Zorlu Shopping Center is 6.5 km away and Kanyon Shopping Center is 6.7 km away. Maçka democracy park is 5 minutes walk away. Galata Port is 2.9 km from Istanbul, Sabiha Gökçen Airport is 40 km away and Atatürk International Airport is 20 km away. Istanbul Airport is 38 km from the property.", "ownerInfo": "Taxim Suites & Residences is centrally located on the main street in the heart of Istanbul, just a few steps away from the famous Taksim Square and Gezi Park. The hotel offers long or short stay houses for guests looking for a comfortable and safe environment. The property offers quality time and relaxation in modern rooms equipped with air conditioning, TV and free internet (Wi-Fi).", "welcomeMessage": "Taxim Suites & Residences is centrally located on the main street in the heart of Istanbul, just a few steps away from the famous Taksim Square and Gezi Park. The hotel offers long or short stay houses for guests looking for a comfortable and safe environment. The property offers quality time and relaxation in modern rooms equipped with air conditioning, TV and free internet (Wi-Fi). Taxim Suites Istanbul's rooms are stylish and elegantly decorated. Some of the rooms overlook the Bosphorus. The hotel also offers specially designed suites with spacious living rooms and bedrooms. Some rooms have a fully equipped kitchen or kitchenette with a microwave and refrigerator. Each suite features minimalist interiors with elegant, modern and stylishly designed City or Bosphorus views. Guests can make tea and coffee with the heater provided free of charge in the rooms. Featuring a desk and seating area, each room has a private bathroom with toiletries. Slippers, towels, bathrobes and a hairdryer are provided. A safe deposit box is standard in each room. Some suites have a jacuzzi.\n\nGuests can choose from a menu of international and local specialties served à la carte in the on-site restaurant. There are many restaurants around the hotel for breakfast, lunch and dinner.\n\nThe hotel has a 24-hour front desk and provides concierge service. Minibar items are available at the reception. The friendly staff at Taxim Suites & Residences Istanbul can assist guests with SPA & Turkish Bath reservation, car rental service, transfer service, dry cleaning service, ticket service, information about tourist attractions. The hotel has a laundry room with washing machines and dryers for guests' use." }, "spokenLanguages": [ "ar", "de", "en", "es", "tr" ] }, ... ``` #### 📖 Rooms `[includes.rooms]` ``` ... WORKING IN PROGRESS ... ``` # Actor input Schema ## `location` (type: `array`): 💡 Acceptable Location Values : ## `example` (type: `string`): No description ## `limit` (type: `integer`): Limit number of results. ## `sort` (type: `string`): Sorting key ## `language` (type: `string`): No description ## `currency` (type: `string`): No description ## `map_viewer` (type: `boolean`): No description ## `includes.all` (type: `boolean`): 💡 Fetch All Detail ## `includes.description` (type: `boolean`): 💡 Long description, brands ## `includes.fineprints` (type: `boolean`): 💡 fineprints ## `includes.facilities` (type: `boolean`): 💡 facilities, highlights, restaurants, meals ## `includes.policies` (type: `boolean`): 💡 House rules, policies ## `includes.gallery` (type: `boolean`): 💡 Images gallery ## `includes.host` (type: `boolean`): 💡 Host profile ## `includes.surroundings` (type: `boolean`): 💡 Surroundings area ## `includes.rooms` (type: `string`): 💡 Rooms Table table ## `includes.questions` (type: `integer`): 💡 Include questions and answers ## `includes.calendar` (type: `integer`): 💡 Include Availability calendar ## `includes.reviews` (type: `integer`): 💡 Include reviews. For Filters and Sorting please use Reviews Filters below. ## `date_mode` (type: `string`): 💡 How long do you want to stay? ## `check_in` (type: `string`): YYYY-MM-DD ## `check_out` (type: `string`): YYYY-MM-DD ## `flex_days` (type: `string`): No description ## `flex_nights` (type: `integer`): 💡 for date_mode=Custom ## `flex_from` (type: `string`): 💡 for date_mode=Custom ## `flex_months` (type: `array`): No description ## `rooms` (type: `integer`): No description ## `adults` (type: `integer`): No description ## `children` (type: `string`): Children ages (0-17) separated by comma. example: "2,3,5" ## `bed_pre` (type: `array`): No description ## `min_bedrooms` (type: `integer`): Min. Numbers of bedrooms ## `min_bathrooms` (type: `integer`): Min. Numbers of bathrooms ## `travel_purpose` (type: `string`): No description ## `hotel_type` (type: `array`): No description ## `entire_place` (type: `boolean`): No description ## `health_safety` (type: `boolean`): Properties that take health & safety measures ## `sustainable` (type: `boolean`): Travel Sustainable properties ## `stars` (type: `array`): No description ## `review_score` (type: `array`): No description ## `min_price` (type: `integer`): No description ## `max_price` (type: `integer`): No description ## `mealplan` (type: `array`): No description ## `reservation` (type: `array`): No description ## `popular_activities` (type: `array`): No description ## `hotelfacility` (type: `array`): No description ## `accessible_hotel` (type: `array`): No description ## `roomfacility` (type: `array`): No description ## `accessible_room` (type: `array`): No description ## `reviews_sort` (type: `string`): No description ## `reviews_search` (type: `string`): 💡 Search within reviews ## `reviews_user` (type: `string`): No description ## `reviews_score` (type: `string`): No description ## `reviews_lang` (type: `array`): No description ## `reviews_time` (type: `string`): No description ## `dev_proxy_config` (type: `object`): 💡 Supported protocol:

HTTP(S), SOCKS5
{http|socks5}://{user:pass}@{hostname|ip-address}:port

Example: socks5://example.com:9000 ## `dev_custom_headers` (type: `array`): 💡 Additional HTTP Headers ## `dev_custom_cookies` (type: `array`): 💡 Additional HTTP Cookies ## `dev_transform_fields` (type: `array`): 💡 Transform the resulting output. Select only needed fields.

For nested object use DOT. For example: 
address.streetAddress

For nested array use NUMBER (index of array element starting from index=0). For example: 
images.0.url
## `dev_dataset_name` (type: `string`): 💡 Save results into custom named Dataset, use mask to customize dataset name

{ACTOR} = actor name
{DATE} = date (YYYYMMDD)
{TIME} = time (HHMMSS)

This masks can be used to autogenerate Dataset Name.

example: data-{DATE}
Depending on today date the dataset name will be: data-20230603

default: data-{ACTOR}-{DATE}-{TIME} ## `dev_dataset_clear` (type: `boolean`): Clear Dataset before insert/update. ## `dev_no_strip` (type: `boolean`): 💡 Keep/Save empty values (NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING) ## Actor input object example ```json { "location": [ "Istanbul" ], "limit": 5, "currency": "USD", "rooms": 1, "adults": 1 } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `extras` (type: `string`): No description ## `results` (type: `string`): No description ## `mapViewer` (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 = { "location": [ "Istanbul" ], "limit": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("jupri/booking-hotels").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 = { "location": ["Istanbul"], "limit": 5, } # Run the Actor and wait for it to finish run = client.actor("jupri/booking-hotels").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "location": [ "Istanbul" ], "limit": 5 }' | apify call jupri/booking-hotels --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,jupri/booking-hotels" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/XqyIZxHDZ5OfyKy6z/builds/VzC6T5prX7jAsvp4S/openapi.json