Service
Jalan에서 일본 숙소를 검색하고, 공개 숙소 상세 정보와 날짜별 객실 플랜 가격·예약 가능 여부를 조회합니다.
94.46%30일 가동률평균 응답1084ms
행을 선택하면 해당 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. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
