#rakutenapi

Thank you for using Rakuten Web Service Center.

We are pleased to announce the release of new versions for the Rakuten Travel APIs as of July 21, 2026.

Announcement Date & New Version Release: 2026-07-21

Endpoint Abolishment Date: 2027-01-18

1. New Version Introduction:

We are pleased to announce the release of new versions for the following APIs as of July 21, 2026:

Travel/SimpleHotelSearch/20260731

Travel/HotelDetailSearch/20260731

Travel/KeywordHotelSearch/20260731

Background of the Update:

Previously, the Travel API provided a single aggregated mealScore field, which combined breakfast and dinner ratings. To provide more granular data and align with recent updates on the Rakuten Travel hotel detail pages, we have exposed individual ratings separately. Users can now access specific scores for breakfast, dinner, and cleanliness.

XML Structure Changes:

The mealScore logic has been upgraded to expose the following individual elements:

<hotelRatingInfo>   <breakfastAverage>4.25</breakfastAverage>   <dinnerAverage>4.50</dinnerAverage   <cleanlinessAverage>4.80</cleanlinessAverage> </hotelRatingInfo>

2. Endpoint Abolishment:

Important: Abolishment Notice

Please be advised that the following older versions will be abolished on January 18, 2027. We recommend migrating to the newest versions as soon as possible:

Travel/SimpleHotelSearch/20170426

Travel/HotelDetailSearch/20170426

Travel/KeywordHotelSearch/20170426

Thank you for using Rakuten Web Service Center.

We would like to share important updates regarding the release of new versions, and the scheduled deprecation of specific API endpoints.

Announcement Date & New Version Release: 2026-07-07

Endpoint Abolishment Date: 2027-01-18

1. New Version Introduction:

We are pleased to announce the release of new versions for the following APIs as of July 7, 2026:

IchibaAttribute/Search/20260701

IchibaGenre/Search/20260701

IchibaItem/Search/20260701

What’s New: In these new versions, the XML structure for Genre data has been updated to provide a more descriptive hierarchy. This includes enhanced information regarding the target genre, its ancestors, siblings, and children.

New XML Structure Sample:

<root>   <ancestors>     <ancestor>       <genreId>211742</genreId>       <nameJa>TV・オーディオ・カメラ</nameJa>       <level>1</level>

    </ancestor>   </ancestors>   <genre>     <genreId>200225</genreId>     <nameJa>光ディスクレコーダー·プレーヤー</nameJa>     <level>2</level>   </genre>   <siblings>     <sibling>       <genreId>100212</genreId>       <nameJa>カメラ·ビデオカメラ·光学機器</nameJa>       <level>2</level>     </sibling>     <sibling>       <genreId>101739</genreId>       <nameJa>その他</nameJa>       <level>2</level>     </sibling>   </siblings>   <children>     <child>       <genreId>550932</genreId>       <nameJa>ブルーレイ·DVDレコーダー</nameJa>       <level>3</level>     </child>     <child>       <genreId>212987</genreId>       <nameJa>その他</nameJa>       <level>3</level>     </child>   </children>   <attributes>     <attribute>        <id>36</id>        <nameJa>カラー</nameJa>     </attribute>     <attribute>        <id>1</id>        <nameJa>ブランド名</nameJa>     </attribute>     <attribute>        <id>298</id>        <nameJa>原産国／製造国</nameJa>     </attribute>   </attributes> </root>

2. Endpoint Abolishment:

Important: Abolishment Notice

Please be advised that the following older versions will be abolished on January 18, 2027. We recommend migrating to the newest versions as soon as possible:

IchibaGenre/Search/20260401

IchibaItem/Search/20260401

IchibaAttribute/Search/20260401