リクエスト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=+bidCount）場合のリクエストURLは下記になります。（実際には改行せずに1行につなげてリクエストしてください。）

入力パラメーター

楽天オークション商品検索API（AuctionItemSearch) 入力パラメーター version:2012-02-02

ID	項目名	パラメーター	型(括弧内は最大バイト数)	必須	デフォルト	備考
区分:共通パラメーター
1	デベロッパーID	developerId	String		-	デベロッパーID（こちらで確認できるアプリケーションIDのことです）
2	アフィリエイトID	affiliateId	String	-	指定無し	アフィリエイトID
3	操作	operation	String		-	使用するAPIの操作名：AuctionItemSearch
4	コールバック関数名	callBack	String	-	指定無し	JSONPとして出力する際のコールバック関数名 （UTF-8でURLエンコードした文字列） 英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上
区分:サービス固有パラメーター
1	検索キーワード	keyword	String	(*1)	-	UTF-8でURLエンコードした文字列 (*1)検索キーワード、楽天オークションジャンルIDのいずれかが指定されていることが必須です
2	バージョン	version	String		-	2012-02-02
3	楽天オークションジャンルID	auctionGenreId	long	(*1)	0	楽天オークションにおけるジャンルを特定するためのID。 ジャンル名、ジャンルの親子関係を調べたい場合は、「楽天オークションジャンル検索API(AuctionGenreSearch)」をご利用ください。 (*1)検索キーワード、楽天オークションジャンルIDのいずれかが指定されていることが必須です
4	1ページあたりの取得件数	hits	int	-	30	1から30までの整数
5	取得ページ	page	int	-	1	1から100までの整数
6	最小現在価格	minItemPrice	long	-	指定無し	0以上の整数
7	最大現在価格	maxItemPrice	long	-	指定無し	0以上の整数 maxItemPriceはminItemPriceより大きい必要がある
8	ソート 【NEW】	sort	String	-	standard	newArrivals: 新着順 +endTime: 残り時間順（昇順） -endTime: 残り時間順（降順） +itemPrice: 現在価格順（昇順） -itemPrice: 現在価格順（降順） +blowPrice: 即落価格順 (昇順) -blowPrice: 即落価格順 (昇順) +bidCount: 入札件数順（昇順） -bidCount: 入札件数順（降順） +affiliateRate: アフィリエイト料率順（昇順） -affiliateRate: アフィリエイト料率順（降順） standard: 楽天標準ソート順 (注目のオークションを加味した、残り時間降順) ※UTF-8でURLエンコードされている必要があります。
9	即落フラグ	blowFlag	int(1)	-	0	0:すべての商品を検索対象とする 1:即落商品のみ検索対象とする ※即落商品とは、オークションの入札期間終了を待たずに即落札することが可能な商品のことです。
10	最小即落価格	minBlowPrice	long	-	指定無し	0以上の整数
11	最大即落価格	maxBlowPrice	long	-	指定無し	0以上の整数 maxBlowPriceはminBlowPriceより大きい必要がある
12	対象商品識別フラグ	itemType	int(1)	-	0	0:すべての商品を検索対象とする 1:個人の出品商品のみ検索対象とする 2:楽天市場店舗の出品商品のみ検索対象とする 3:楽オク事業者の出品商品のみ検索対象とする (複数指定可)
13	商品状態フラグ	newFlag	int(1)	-	0	0:すべて 1:中古のみ 2:新品のみ
14	1円スタートフラグ	y1startFlag	int(1)	-	0	0:すべて 1:1円スタート商品のみ
15	匿名配送対応フラグ	anonymityFlag	int(1)	-	0	0:すべて 1:匿名配送に対応している商品のみ
16	送料無料フラグ	postageFreeFlag	int(1)	-	0	0:すべて 1:送料無料
17	クローズド除外フラグ	closedFlag	int(1)	-	0	0:すべて 1:クローズドを除く
18	入札状況	bidStatus	int(1)	-	0	0:すべて 1:入札あり 2:入札なし
19	検索フィールド	field	int(1)	-	1	0:検索対象が広い（同じ検索キーワードでも多くの検索結果が得られる） 1:検索対象範囲が限定される（同じ検索キーワードでも少ない検索結果が得られる）
20	キャリア	carrier	int(1)	-	0	PC用の情報を返すのか、モバイル用の情報を返すのかを選択 PC: 0 mobile: 1
21	商品画像有無フラグ	imageFlag	int(1)	-	0	0:すべての商品を検索対象とする 1:商品画像ありの商品のみを検索対象とする
22	OR検索フラグ	orFlag	int(1)	-	0	複数キーワードが設定された場合に、AND検索、OR検索のいずれかが選択可能。 0:AND検索 1:OR検索 ※ただし、(A and B) or Cといった複雑な検索条件設定は指定不可。
23	除外キーワード	NGKeyword	String	-	指定無し	検索結果から除外したいキーワード UTF-8でURLエンコードした文字列
24	ジャンルごとの商品数取得フラグ	genreInformationFlag	int(1)	-	0	0:ジャンルごとの商品数の情報を取得しない 1:ジャンルごとの商品数の情報を取得する

出力パラメーター

楽天オークション商品検索API（AuctionItemSearch) 出力パラメーター version:2012-02-02

アフィリエイトに関して

デベロッパーは、楽天オークション商品検索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の過去のバージョンは下記からご覧いただけます。