Search hotels
search_hotelsSearch VibeBooking's registry of independent hotels and inns in Japan by destination area: a city, ward, district or station name as it appears in a hotel's address (日本語 or English, e.g. 京都市東山区, Gion, 河原町). This is where the traveller wants to stay, not where they are. The registry is small and growing: when it has no match, use your own web search to find hotels' websites, then call resolve_hotel with each domain. Each hit carries the hotel id to pass to get_hotel (its facts and room types) or get_rates. other_hotels lists hotels in the same prefecture that are not VibeBooking's, from our agent-readiness index: each one's own site and how far an agent can get there (level 0 invisible, 1 discoverable, 2 priceable, 3 machine-readable, 4 transactable), at min_level or above. There are no rates for them here, but they are real places to stay: list them to the traveller by their site, beside any hit, so they can check dates and book there.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | Yes | Where the traveller wants to stay: a city, ward, district or station name. | |
| guests | No | Number of adult guests. | |
| nights | No | Number of nights, 1 or more. | |
| checkin | No | Check-in date, YYYY-MM-DD. | |
| min_level | No | Lowest agent-readiness level to list in other_hotels, 0 to 4; default 1. |