Service
Use official Rakuten Travel APIs to search hotels by area or keyword, check vacancy, fetch hotel details, list area and chain codes, and retrieve hotel rankings.
99.39%30-day uptimeAvg response388ms
Selecting a row opens the reference for that 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. |
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.
| 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. |
