楽天ジャンル検索APIは楽天市場のジャンル名・ジャンル構造を返すAPIです。デベロッパーはジャンルIDを指定することでこれらの情報を得ることができます。
リクエストURL（REST／JSON形式の場合）
http://api.rakuten.co.jp/rws/3.0/rest?[parameter]=[value]… http://api.rakuten.co.jp/rws/3.0/json?[parameter]=[value]…
※JSONP形式は、JSON形式で入力パラメーターにcallBackを指定することで出力されます。
たとえば、第一階層目のジャンル一覧を取得したい場合のリクエストURLは下記になります。（実際には改行せずに1行につなげてリクエストしてください。）
http://api.rakuten.co.jp/rws/3.0/rest?
developerId=[YOUR_developerID]
&operation=GenreSearch
&version=2007-04-11
&genreId=0
※短い時間の間に大量に、同一のリクエストURLへアクセスすると、一定時間利用できなくなる場合がございます。テストの際にはご注意ください。
入力パラメーター
楽天ジャンル検索API（GenreSearch) 入力パラメータ version:2007-04-11
| ID | 項目名 | パラメーター | 型(括弧内は最大バイト数) | 必須 | デフォルト | 備考 |
|---|---|---|---|---|---|---|
| 区分:共通パラメーター | ||||||
| 1 | デベロッパーID | developerId | String |  |
- | デベロッパーID（こちらで確認できるアプリケーションIDのことです） |
| 2 | アフィリエイトID | affiliateId | String | - | 指定無し | アフィリエイトID |
| 3 | 操作 | operation | String | |
- | 使用するAPIの操作名：GenreSearch |
| 4 | コールバック関数名 | callBack | String | - | 指定無し | JSONPとして出力する際のコールバック関数名 （UTF-8でURLエンコードした文字列） 英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上 |
| 区分:サービス固有パラメーター | ||||||
| 1 | ジャンルID | genreId | int | (*1) |
- | ジャンルルートは、genreId=0とする |
| 2 | バージョン | version | String | |
- | 2007-04-11 |
| 3 | ジャンルパス | genrePath | int(1) | - | 1 | 結果セットに祖先ジャンル（親ジャンルよりも上のジャンル）を含めるか否か 0：含めない 1：含める |
出力パラメーター
楽天ジャンル検索API（GenreSearch) 出力パラメーター version:2007-04-11
| ID | 分類 | 項目名 | パラメーター | 備考 |
|---|---|---|---|---|
| 区分:共通パラメーター | ||||
| 1 | Arg | ユーザーエージェント | User-Agent | Valueにはユーザのユーザエージェントが表示される |
| 2 | デベロッパーID | developerId | ValueにはデベロッパーIDが表示される | |
| 3 | アフィリエイトID | affiliateId | ValueにはアフィリエイトIDが表示される | |
| 4 | 操作 | operation | Valueにはユーザの指定した操作名が表示される | |
| 5 | バージョン | version | Valueにはユーザの指定したバージョンが表示される | |
| 6 | Status | - | Status | Success / NotFound / ServerError / ClientError / Maintenance のいずれか |
| 7 | StatusMsg | - | StatusMsg | Statusに特化したメッセージを出力 |
| 区分:サービス固有パラメーター | ||||
| 1 | 親ジャンル | 親ジャンル | parent | 入力したジャンルIDの親ジャンル 「genrePath=1」の時、更に上位階層があれば表示する |
| 2 | ジャンルID | genreId | ジャンルID | |
| 3 | ジャンル名 | genreName | ジャンル名 | |
| 4 | ジャンル階層 | genreLevel | ジャンル階層。ジャンルルートは0 | |
| 5 | 自ジャンル | 自ジャンル | current | ユーザの入力したジャンルID |
| 6 | ジャンルID | genreId | ジャンルID | |
| 7 | ジャンル名 | genreName | ジャンル名 | |
| 8 | ジャンル階層 | genreLevel | ジャンル階層 | |
| 9 | 子ジャンル | 子ジャンル | child | ユーザの入力したジャンルIDの子ジャンル 複数の子ジャンルがある場合は"<child>～ </child>"が複数生成される 入力がgenreId=0」の時はgenreLevel=1の ジャンルが<child>～</child>に表示される |
| 10 | ジャンルID | genreId | ジャンルID | |
| 11 | ジャンル名 | genreName | ジャンル名 | |
| 12 | ジャンル階層 | genreLevel | ジャンル階層 | |
エラー
エラーが起こった際は、出力中の「共通パラメーター」のStatusに下表に記載されたいずれかが表示されます。
| Statusでの表示 | 内容 |
|---|---|
| NotFound | 検索結果が存在しない。 |
| ServerError | 楽天ウェブサービス側のエラー。 |
| ClientError | デベロッパーの入力に起因するエラー。 |
| Maintenance | メンテナンス。 |