Top > API一覧 > 楽天ジャンル検索API

楽天ジャンル検索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へアクセスすると、一定時間利用できなくなる場合がございます。テストの際にはご注意ください。

SOAPについて


SOAPを用いることで、より高度なアプリの開発が可能となります。SOAPに関しての詳細は「楽天ジャンル検索API(GenreSearch)SOAP開発用」をご覧ください。

入力パラメーター


楽天ジャンル検索API(GenreSearch) 入力パラメータ version:2007-04-11

ID 項目名 パラメーター 型(括弧内は最大バイト数) 必須 デフォルト 備考
区分:共通パラメーター
1 デベロッパーID developerId String Affiliate対応あり - デベロッパーID(こちらで確認できるアプリケーションIDのことです)
2 アフィリエイトID affiliateId String - 指定無し アフィリエイトID
3 操作 operation String Affiliate対応あり - 使用するAPIの操作名:GenreSearch
4 コールバック関数名 callBack String - 指定無し JSONPとして出力する際のコールバック関数名
(UTF-8でURLエンコードした文字列)
英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上
区分:サービス固有パラメーター
1 ジャンルID genreId int Affiliate対応あり
(*1)
- ジャンルルートは、genreId=0とする
2 バージョン version String Affiliate対応あり - 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 メンテナンス。