Check the hotel's own price against Booking.com
check_direct_priceChecks whether a hotel is cheaper on its own website than on Booking.com, for one stay. Give the hotel, the dates, the guests and, when you have it, the total Booking.com shows for the whole stay with its meal plan and cancellation terms. BookHotels.direct reads the hotel's own booking site live, applying the public promo codes and free-club prices it knows for that hotel, or uses a traveller's read of the same stay from the last 24 hours, and compares like for like: same hotel, dates and guests, with every difference in room, meal plan or cancellation stated. The answer is honest either way: when Booking.com is cheaper, it says so. When the hotel's site cannot be read automatically, the answer gives the link to the hotel's own site for these dates and asks you to report the prices shown there with report_hotel_price. Without a Booking.com total, the answer gives the hotel's own price and, when the evidence allows, an estimated saving, always labelled as an estimate with its basis. Only Booking.com prices can be compared. One room per check.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | The town or city the hotel is in, e.g. "Sitges". Helps find hotels we have not checked before. | |
| hotel | Yes | The hotel's name as the traveller sees it, e.g. "Hotel Calipolis". | |
| adults | No | Number of adults (default 2). | |
| checkin | Yes | Check-in date, YYYY-MM-DD. | |
| checkout | Yes | Check-out date, YYYY-MM-DD. | |
| language | No | Language of the check page for the traveller (default en). | |
| booking_url | No | Optional: the Booking.com address of the hotel's page (https://www.booking.com/hotel/…). Only the address is read, to recognise the hotel and the dates; the page is never opened. | |
| booking_room | No | The room name of the Booking.com offer, when shown. | |
| booking_total | No | The total Booking.com shows for the whole stay, in euros, when known. Without it you get the hotel's own price and, when the evidence allows, an estimated saving. | |
| children_ages | No | Each child's age on the day of check-out, one number per child. Leave out when no children travel. Hotels price children by age, so ages are needed for families. | |
| booking_meal_plan | No | The meal plan of the Booking.com offer, when Booking.com shows it. | |
| booking_taxes_extra | No | Taxes Booking.com lists on top of its total, in euros (e.g. a city tax), when shown. | |
| booking_cancellation | No | The cancellation terms of the Booking.com offer, when Booking.com shows them: free cancellation, non-refundable, or partly refundable. | |
| booking_taxes_included | No | true when Booking.com says its total includes taxes and charges; false when it lists taxes on top. |