【楽天ウェブサービス】RAKUTEN WEBSERVICE

・	オンラインドキュメント
・	楽天ウェブサービス規約
・	FAQ
・	クレジット表示
・	ウェブサービスチームブログ
・	旧ブログ
・	デベロッパーズ・コミュニティ

・	楽天商品検索API
・	楽天ジャンル検索API
・	楽天商品コード検索API
・	楽天カタログ検索API
・	楽天商品ランキングAPI

・	楽天ブックス総合検索API
・	楽天ブックス書籍API
・	楽天ブックスCD検索API
・	楽天ブックスDVD/Blu-ray検索API
・	楽天ブックス洋書検索API
・	楽天ブックス雑誌検索API
・	楽天ブックスゲーム検索API
・	楽天ブックスソフトウェア検索API
・	楽天ブックスジャンル検索API

・	楽天オークション商品検索API
・	楽天オークション商品コード検索API

・	楽天トラベル施設検索API【NEW】
・	楽天トラベル施設情報API
・	楽天トラベル空室検索API【NEW】
・	楽天トラベル地区コードAPI
・	楽天トラベルキーワード検索API【NEW】
・	楽天トラベルホテルチェーンAPI
・	楽天トラベルランキングAPI
	>> 楽天トラベル系APIサンプル集
・	楽天トラベル施設リンク一括作成ツール

・	楽天ダイナミックアドAPI
・	楽天ダイナミックアドAPI トラベル

楽天ジャンル検索API (version:2007-04-11)

楽天ジャンル検索APIとは

楽天ジャンル検索APIは楽天市場のジャンル名・ジャンル構造を返すAPIです。デベロッパーはジャンルIDを指定することでこれらの情報を得ることができます。

アカウント情報
・	デベロッパーIDの確認
・	アフィリエイトIDの確認

・リクエストURL
・SOAPについて
・入力パラメーター
・出力パラメーター
・エラー
・過去のバージョン

■リクエストURL（REST／JSON形式の場合）

http://api.rakuten.co.jp/rws/2.0/rest?[parameter]=[value]...
http://api.rakuten.co.jp/rws/2.0/json?[parameter]=[value]…

※JSONP形式は、JSON形式で入力パラメーターにcallBackを指定することで出力されます。

たとえば、第一階層目のジャンル一覧を取得したい場合のリクエストURLは下記になります。（実際には改行せずに1行につなげてリクエストしてください。）

http://api.rakuten.co.jp/rws/2.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	○	---	デベロッパーID
	2	アフィリエイトID	affiliateId	String	-	指定無し	アフィリエイトID
	3	操作	operation	String	○	---	使用するAPIの操作名：GenreSearch
	4	コールバック関数名	callBack	String	-	指定無し	JSONPとして出力する際のコールバック関数名（UTF-8でURLエンコードした文字列）英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上
サ \| ビス固有パラメ \| タ \|	1	ジャンルID	genreId	int	○	---	ジャンルルートは、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		---	developerId	ValueにはデベロッパーIDが表示される
	3		---	operation	Valueにはユーザの指定した操作名が表示される
	4		---	version	Valueにはユーザの指定した操作のバージョンが表示される
	5	Status	---	Status	Success/NotFound/ServerError/ ClientError /Maintenance のいづれか
	6	StatusMsg	---	StatusMsg	Statusに特化したメッセージを出力
サ \| ビス固有パラメ \| タ \|	1	親ジャンル		parent	入力したジャンルIDの親ジャンル「genrePath=1」の時、更に上位階層があれば、表示する
	2		ジャンルID	genreId	ジャンルID
	3		ジャンル名	genreName	ジャンル名
	4		ジャンル階層	genreLevel	ジャンル階層ジャンルルートは0
	5	自ジャンル		current	ユーザの入力したジャンルID
	6		ジャンルID	genreId
	7		ジャンル名	genreName
	8		ジャンル階層	genreLevel
	9	子ジャンル		child	ユーザの入力したジャンルIDの子ジャンル複数の子ジャンルがある場合は<child>～ </child>が複数生成される入力がgenreId=0」の時はgenreLevel=1のジャンルが<child>～</child>に表示される
	10		ジャンルID	genreId
	11		ジャンル名	genreName
	12		ジャンル階層	genreLevel

▲上へ

■エラー

エラーが起こった際は、出力中の「共通パラメーター」のStatusに下表に記載されたいずれかが表示されます。

Statusでの表示	内容
NotFound	検索結果が存在しない。
ServerError	楽天ウェブサービス側のエラー。
ClientError	デベロッパーの入力に起因するエラー。
Maintenance	メンテナンス。

▲上へ

■過去のバージョン

本APIの過去のバージョンは下記からご覧いただけます。

・楽天ジャンル検索API（2006-12-26）

・楽天ジャンル検索API（2007-03-28）

▲上へ