リクエスト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を指定することで出力されます。

フィールド名keyword, sortに対応する[value]はUTF-8でURLエンコードされている必要があります。
（リクエストURL全体をエンコードするのではなく、[value]部分を個別にエンコードしてください。）
たとえば、「福袋」という検索キーワードで検索し、結果を価格が安い順に並べたい（sort=+itemPrice）場合のリクエストURLは下記になります。（実際には改行せずに1行につなげてリクエストしてください。)

SOAPについて

SOAPを用いることで、より高度なアプリの開発が可能となります。SOAPに関しての詳細は「楽天商品検索API（ItemSearch）SOAP開発用」をご覧ください。※version:2010-09-15は、現在SOAP未対応です。

入力パラメーター

楽天商品検索API（ItemSearch) 入力パラメーター version:2010-09-15

ID	項目名	パラメーター	型(括弧内は最大バイト数)	必須	デフォルト	備考
区分:共通パラメーター
1	デベロッパID	developerId	String		-	デベロッパーID（こちらで確認できるアプリケーションIDのことです）
2	アフィリエイトID	affiliateId	String	-	指定無し	アフィリエイトID
3	操作	operation	String		-	使用するAPIの操作名：ItemSearch
4	コールバック関数名	callBack	String	-	指定無し	JSONPとして出力する際のコールバック関数名 （UTF-8でURLエンコードした文字列） 英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上
区分:サービス固有パラメーター
1	検索キーワード	keyword	String	(*1)	-	UTF-8でURLエンコードした文字列 (*1)検索キーワード、ジャンルIDのいずれかが指定されていることが必須です。
2	バージョン	version	String		-	2010-09-15
3	ショップコード	shopCode	String	-	指定無し	ショップごとのURL （http:// www.rakuten.co.jp/[xyz]）におけるxyzのこと
4	ジャンルID	genreId	long	(*1)	0	楽天市場におけるジャンルを特定するためのID ジャンル名、ジャンルの親子関係を調べたい場合は、「楽天ジャンル検索API(GenreSearch)」をご利用ください (*1)検索キーワード、ジャンルIDのいずれかが指定されていることが必須です。
5	1ページあたりの取得件数	hits	int	-	30	1から30までの整数
6	取得ページ	page	int	-	1	1から100までの整数
7	ソート	sort	String	-	standard	+affiliateRate： アフィリエイト料率順（昇順） -affiliateRate： アフィリエイト料率順（降順） +reviewCount： レビュー件数順（昇順） -reviewCount： レビュー件数順（降順） +reviewAverage： レビュー平均順（昇順）【NEW】 -reviewAverage： レビュー平均順（降順）【NEW】 +itemPrice： 価格順（昇順） -itemPrice： 価格順（降順） +updateTimestamp： 商品更新日時順（昇順） -updateTimestamp： 商品更新日時順（降順） standard： 楽天標準ソート順 ※UTF-8でURLエンコードされている必要があります。
8	最小価格	minPrice	long	-	指定無し	0以上の整数
9	最大価格	maxPrice	long	-	指定無し	0以上の整数 maxPriceはminPriceより大きい必要がある
10	販売可能	availability	int(1)	-	1	0：すべての商品 1：販売可能な商品のみ
11	検索フィールド	field	int(1)	-	1	0：検索対象が広い（同じ検索キーワードでも多くの検索結果が得られる） 1：検索対象範囲が限定される（同じ検索キーワードでも少ない検索結果が得られる）
12	キャリア	carrier	int(1)	-	0	PC用の情報を返すのか、モバイル用の情報を返すのかを選択 PC: 0 mobile: 1
13	商品画像有無フラグ	imageFlag	int(1)	-	0	0 : すべての商品を検索対象とする 1 : 商品画像ありの商品のみを検索対象とする
14	OR検索フラグ	orFlag	int(1)	-	0	複数キーワードが設定された場合に、AND検索、OR検索のいずれかが選択可能。 0:AND検索 1:OR検索 ※ただし、(A and B) or Cといった複雑な検索条件設定は指定不可。
15	除外キーワード	NGKeyword	String	-	指定無し	検索結果から除外したいキーワード UTF-8でURLエンコードした文字列
16	ジャンルごとの商品数取得フラグ	genreInformationFlag	int(1)	-	0	0 :ジャンルごとの商品数の情報を取得しない 1 :ジャンルごとの商品数の情報を取得する
17	購入種別	purchaseType	int(1)	-	0	商品を購入方法別に検索する事が可能 0：通常購入 1：定期購入(定期購入とは、お客様の欲しい商品が欲しいサイクルで買えるサービスです。) 2：頒布会購入(頒布会購入とは、ショップがセレクトした商品を、ショップが決めた回数でお届けするサービスです。)
18	海外配送フラグ	shipOverseasFlag	int(1)	-	0	0 :すべての商品 1 :海外配送可能な商品のみ
19	海外配送対象地域	shipOverseasArea	String	-	ALL	配送可能地域での絞込みが可能 配送地域コードについては別途「海外配送対象地域 コード一覧」を参照してください ※海外配送フラグで「1」が指定されたときのみ利用可能
20	あす楽フラグ	asurakuFlag	int(1)	-	0	0 :すべての商品 1 :あす楽対応可能な商品のみ
21	あす楽配送対象地域	asurakuArea	int	-	0	配送可能地域での絞込みが可能 配送地域コードについては別途「あす楽配送対象地域 コード一覧」を参照してください ※あす楽フラグで「1」が指定されたときのみ利用可能
22	ポイント倍付けフラグ【NEW】	pointRateFlag	int(1)	-	0	0 :すべての商品 1 :ポイント倍付け商品のみ
23	商品別ポイント倍付け【NEW】	pointRate	int	-	指定なし	2から10までの整数　例）5 →ポイント5倍 商品別ポイント倍付けについてはこちらをご確認ください。 ※ポイント倍付け商品フラグに「1」が指定されたときのみ利用可能
24	送料フラグ【NEW】	postageFlag	int(1)	-	0	0 :すべての商品 1 :送料込み／送料無料の商品のみ
25	クレジットカード利用可能フラグ【NEW】	creditCardFlag	int(1)	-	0	0 :すべての商品 1 :クレジットカード利用可能な商品のみ

出力パラメーター

楽天商品検索API（ItemSearch) 出力パラメーター version:2010-09-15

商品別ポイント倍付けに関して

商品購入時に付与される楽天スーパーポイントは、通常、購入金額の1%ですが、ポイント倍付けが設定されている商品は、設定期間中に商品を購入すると、設定された倍率が適用されます。ポイント倍付けの詳しい仕組みは、こちらでご確認ください。

ショップが設定するポイント倍付けには、特定商品のみに適用される商品別ポイント倍付けと、特定ショップの全商品に適用されるショップ別ポイント倍付けの2種類があります。本APIでは、現在のところ、商品別ポイント倍付けの情報を提供しています。

アフィリエイトに関して

デベロッパーは、楽天商品検索APIから取得した商品情報からアフィリエイトURLを作成することが可能です。リンク先にそのアフィリエイトURLを指定することで、楽天アフィリエイト経由の成果報酬を獲得することができます。 アフィリエイトURLの作り方は2通りあります。入力パラメーターcarrierでPCが指定された場合でもモバイルが指定された場合でも同様の方法でアフィリエイトURLを作成することができます。
（1） APIの入力パラメーターに「アフィリエイトID」を含める場合： APIの出力に「アフィリエイトURL」が含まれます。

（2） デベロッパーが自ら、（APIから取得した）「商品URL」と「アフィリエイトID（β版）」から「アフィリエイトURL」を作成する場合： 「アフィリエイトURL」は以下のルールで生成可能です。ただし、「商品URL」の部分はURLエンコードされている必要があります。

http://hb.afl.rakuten.co.jp/hgc/[アフィリエイトID]/?pc=[商品URL（PC）]&m=[商品URL（モバイル）]

エラー

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

過去のバージョン

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