Find hotel deals
find_hotel_dealsRead-onlyIdempotent
Current hotel deals from the latest scans (at most 20): hotels priced below their usual level, optionally for one destination, check-in month or maximum nightly price. Prices are tax-inclusive nightly figures for two adults from past scans, not a live quote. Each deal includes page_url (price history) and book_url (a booking-site link with the dates filled in) for checking the current price.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| via | No | Optional short name of your app or assistant (lower-case letters, digits, - or _), used in booking links so we can see where visits come from. | |
| month | No | YYYY-MM check-in month. | |
| max_price | No | Maximum price per night in GBP. | |
| destination | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | ||
| deals | No | ||
| error | No | ||
| notes | No | ||
| page_url | No | ||
| requested | No | ||
| data_as_of | No | ||
| suggestions | No | ||
| valid_destinations | No |