Service
Search Japanese hotels, inspect public hotel details, and check dated room-plan prices and availability on Jalan.
90.15%30-day uptimeAvg response904ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/jalan/get-hotel | Reads the public detail page of one Jalan hotel by its six-digit hotel ID: name, description, address, image, guest rating, review count, and any displayed minimum JPY price. Use when the caller already has a hotel_id from jalan:search-hotels and needs hotel-level details. Do NOT use for dated room-plan prices or availability — use jalan:list-hotel-plans instead. Do NOT use to find hotels — use jalan:search-hotels instead. Returns hotel. | |
| POST | /v1/jalan/list-hotel-areas | Lists Jalan's current public lodging-area catalog as 47 Japanese prefectures with their large-area search codes. Use when the caller needs a large_area_code before searching for hotels. Do NOT use to find hotels — use jalan:search-hotels instead, passing a large_area_code from this operation unchanged. Returns prefectures, each with prefecture_code, name, and large_areas. Each large area carries large_area_code and, until 2026-10-14, the retired area_code spelling of the same value. | |
| POST | /v1/jalan/list-hotel-plans | Checks one Jalan hotel for the room-plan combinations currently offered for an exact check-in date, stay length, and adult count. Use when the caller needs dated, tax-inclusive JPY plan prices or a limited-inventory signal for a specific hotel. Do NOT use to find hotels in an area — use jalan:search-hotels instead. Do NOT use for hotel-level details such as address or rating — use jalan:get-hotel instead. Does not log in or create a reservation. Returns availability_status, plan_count, room_offer_count, and plans. | |
| POST | /v1/jalan/search-hotels | Searches Jalan's public hotel listings in one large area for one room. Use when the caller needs candidate hotels for an area, with an optional check-in date, stay length of 1 to 30 nights, and 1 to 9 adults; supports server-side sort modes (recommended, price_ascending, price_descending, area) and fixed 30-hotel pages. Do NOT use for room-plan prices or availability at a specific hotel — use jalan:list-hotel-plans instead. Do NOT use for full details of a known hotel — use jalan:get-hotel instead. Prices are the minimum JPY amounts displayed by Jalan and are not booking guarantees. Returns hotels (up to 30) and pagination. |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
