Service
공식 라쿠텐 트래블 API로 지역 또는 키워드 호텔 검색, 공실 확인, 호텔 상세 조회, 지역 코드와 체인 코드 목록 조회, 호텔 랭킹 조회를 수행합니다.
99.39%30일 가동률평균 응답390ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/rakuten-travel/get-area-classes | Search Rakuten Travel leaf area tokens (for example japan/tokyo/tokyo/F) that can be passed directly as area to rakuten-travel:search-hotels-simple or rakuten-travel:search-vacant-hotels, optionally filtered by query against the token or its label. Use when the user names a region, prefecture, or city and an area token is needed before hotel search. Do NOT use to search hotels themselves — use rakuten-travel:search-hotels-by-keyword instead. Returns areas with area and label. | |
| POST | /v1/rakuten-travel/get-hotel-details | Fetch details for one Rakuten Travel hotel by hotel_id and return normalized access, parking, telephone, review, and location fields. Use when a hotel_id is already known from a search or ranking result. Do NOT use to find hotels — use rakuten-travel:search-hotels-by-keyword or rakuten-travel:search-hotels-simple instead. Returns hotel with address, latitude, longitude, min_charge, review_average, review_count, telephone, access, parking, and nearest_station. | |
| POST | /v1/rakuten-travel/get-hotel-rankings | Retrieve Rakuten Travel hotel rankings for a genre (all, onsen, or premium). Use when the user wants popular hotels for travel inspiration rather than hotels in a chosen area or on chosen dates. Do NOT use for hotels in a specific area — use rakuten-travel:search-hotels-simple instead. Facilities delisted from Rakuten Travel are removed, so the result may be empty. Surviving rows retain Rakuten's original rank values, so gaps such as 1 then 3 are expected. Returns rankings with rank plus normalized hotel fields. | |
| POST | /v1/rakuten-travel/list-hotel-chains | List Rakuten Travel hotel chain codes and names. Use when the user wants to restrict an area search to a specific hotel chain; pass the returned chain_code to rakuten-travel:search-hotels-simple. Do NOT use to search hotels directly — use rakuten-travel:search-hotels-simple or rakuten-travel:search-hotels-by-keyword instead. Takes no input parameters. Returns hotel_chains with chain_code and name. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/rakuten-travel/search-hotels-by-keyword | Search Rakuten Travel hotels by free-text keyword and return normalized hotel rows. Use when the user gives a place, station, landmark, or hotel name and no area token is available. Rakuten Travel matches only Japanese or romaji keywords; Korean (Hangul) keywords return no results, so use Japanese place or hotel names such as 新宿 or Shinjuku. Do NOT use for vacancy on specific dates — use rakuten-travel:search-vacant-hotels instead; do NOT use when an area token is already selected — use rakuten-travel:search-hotels-simple instead. Returns hotels and a pagination summary. |
| POST | /v1/rakuten-travel/search-hotels-simple | Search Rakuten Travel hotels within an area token, optionally filtered by a chain_code from rakuten-travel:list-hotel-chains, and return normalized hotel summary rows. Use when the user already has an area token from rakuten-travel:get-area-classes and does not need availability for specific dates. Do NOT use for free-text place, station, or hotel names — use rakuten-travel:search-hotels-by-keyword instead; do NOT use for vacancy on specific dates — use rakuten-travel:search-vacant-hotels instead. Returns hotels (hotel_id, name, url, address, min_charge, review_average, review_count, image_url) and a pagination summary. |
| POST | /v1/rakuten-travel/search-vacant-hotels | Search Rakuten Travel hotels with vacancy in an area token for a stay, optionally narrowed by a query keyword and by adult_count and room_count. Use when the user needs rooms available on specific dates. Provide checkin_date and checkout_date together, or omit both to default to a one-night stay starting 14 days from today. Do NOT use for general hotel browsing without dates — use rakuten-travel:search-hotels-simple instead; do NOT use without an area token — get one from rakuten-travel:get-area-classes first. Returns hotels and a pagination summary; an empty hotels list means no vacancy for the requested dates. |
