Check a hotel price
check_hotel_priceRead-onlyIdempotent
Say whether a price the person has been quoted for a hotel is high, low or usual for that hotel in that month, using HotelMonitor's own scans. Use it when someone asks "is this a good price?". Returns no verdict when there is not enough data. Prices are tax-inclusive nightly figures for two adults from past scans, not a live quote. Results include 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 |
|---|---|---|---|
| per | Yes | Is price per night or for the whole stay? | |
| 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. | |
| hotel | Yes | ||
| price | Yes | In GBP. | |
| adults | No | ||
| checkin | Yes | YYYY-MM-DD, today or later. | |
| checkout | No | YYYY-MM-DD. Required when per is "stay". At most 30 nights. | |
| destination | Yes | Destination slug, e.g. tenerife, new-york, algarve. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | ||
| error | No | ||
| hotel | No | ||
| month | No | ||
| notes | No | ||
| scans | No | ||
| nights | No | ||
| reason | No | ||
| verdict | No | ||
| book_url | No | ||
| page_url | No | ||
| requested | No | ||
| watch_url | No | ||
| comparison | No | ||
| data_as_of | No | ||
| destination | No | ||
| month_label | No | ||
| suggestions | No | ||
| samples_note | No | ||
| below_lowest_seen | No | ||
| valid_destinations | No | ||
| destination_context | No | ||
| typical_nightly_gbp | No | ||
| cheapest_month_ahead | No | ||
| lowest_seen_nightly_gbp | No | ||
| your_price_per_night_gbp | No |