Top > API一覧 > 楽天オークション商品検索API

楽天オークション商品検索APIは、楽天オークションの商品情報を取得することが可能なAPIです。デベロッパーはキーワードでの商品検索をはじめ、ジャンル別や商品の状態などの絞り込み検索も可能となります。

リクエスト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行につなげてリクエストしてください。)

http://api.rakuten.co.jp/rws/3.0/rest?
developerId=[YOUR_developerID]
&operation=AuctionItemSearch
&version=2012-02-02
&keyword=%E7%A6%8F%E8%A2%8B
&sort=%2BbidCount

※短い時間の間に大量に、同一のリクエストURLへアクセスすると、一定時間利用できなくなる場合がございます。テストの際にはご注意ください。

入力パラメーター


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

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

ID 大分類 分類 項目名 パラメーター 備考
区分:共通パラメーター
1 ARG - User-Agent Valueにはユーザのユーザエージェントが表示される
2 - developerId ValueにはデベロッパーIDが表示される
3 - affiliateId ValueにはアフィリエイトIDが表示される
4 - operation Valueにはユーザの指定した操作名が表示される
5 - version Valueにはユーザの指定したバージョンが表示される
6 Status - Status Success / NotFound / ServerError / ClientError / Maintenance のいずれか
7 StatusMsg - StatusMsg Statusに特化したメッセージを出力
区分:サービス固有パラメーター
1 全体情報 検索数 count 検索結果の総商品数
2 ページ番号 page 現在のページ番号
3 ページ内商品始追番 first 検索結果の何件目からか
4 ページ内商品終追番 last 検索結果の何件目までか
5 ヒット件数 hits 1度に返却する商品数
6 キャリア情報 carrier PC=0 or mobile=1
7 総ページ数 pageCount 最大100
8 商品情報
(全体:<Items> ~ </Items> 、個別商品:<Item> ~ </Item>)
出品商品情報詳細 商品名 itemName 従来の商品名を表示させたい場合は、「catchcopy+itemName」で表示してください。
9 キャッチコピー catchcopy
10 オークション商品コード itemCode  
11 出品商品現在価格 itemPrice  
12 最低入札価格 minPrice  
13 商品説明文 itemCaption  
14 商品URL itemUrl  
15 アフィリエイトURL affiliateUrl (入力パラメーターにアフィリエイトIDが含まれていた時のみ)
※carrierパラメーターの指定に関わらずPC/mobile両対応のURLを返却
16 商品画像有無フラグ imageFlag 0:商品画像無し
1:商品画像有り
17 商品画像 64x64URL smallImageUrl (画像サイズ 64px*64px)
18 商品画像 128x128URL mediumImageUrl (画像サイズ 128px*128px)
19 即落フラグ blowFlag 0:通常のオークション商品
1:即落商品
20 即落価格 blowPrice 即落商品だった場合のみ表示
21 結果フラグ resultFlag 0:取引中の場合
1:取引が終了した場合
22 入札件数 bidCount  
23 消費税フラグ taxFlag >0:税別
1:税込
2:税なし
3:非課税
24 送料フラグ postageFlag 0:送料込
1:送料別
25 配送タイプ deliveryType 0:条件なし
1:送料無料で配送
2:匿名配送
3:匿名配送かつ送料無料で配送
26 クレジットカード利用可能フラグ creditCardFlag 0:カード利用不可
1:カード利用可
27 アフィリエイト利用利率 affiliateRate  
28 入札開始時間 startTime  
29 入札終了時間 endTime  
30 注目のオークション設定金額 【NEW】 searchwordcost  
31 出品者情報 出品者名 shopName  
32 出品者種別フラグ shopStatusFlag 1:個人 2:楽天市場店舗 3:楽オク事業者
33 ジャンル情報 楽天オークションジャンルID auctionGenreId  
34 ジャンルごとの商品数
(全体:<GenreInformation>
~ </GenreInformation> 、
個別ジャンル:<parent> ~ </parent>
もしくは<current> ~ </current>
もしくは<child> ~ </child>)
親ジャンル - parent 入力したジャンルIDの親ジャンル
35 楽天オークションジャンルID auctionGenreId  
36 楽天オークションジャンル名 auctionGenreName  
37 ジャンル階層 genreLevel  
38 自ジャンル - current ユーザの入力したジャンルID
39 楽天オークションジャンルID auctionGenreId  
40 楽天オークションジャンル名 auctionGenreName  
41 ジャンルに紐づく商品数 itemCount  
42 ジャンル階層 genreLevel  
43 子ジャンル - child ユーザの入力したジャンルIDの子ジャンル
複数の子ジャンルがある場合は<child> ~ </child>が複数生成される
入力が「auctionGenreId=000」の時はgenreLevel=1のジャンルが<child> ~ </child>に表示される
44 楽天オークションジャンルID auctionGenreId  
45 楽天オークションジャンル名 auctionGenreName  
46 ジャンルに紐づく商品数 itemCount  
47 ジャンル階層 genreLevel  

アフィリエイトに関して


デベロッパーは、楽天オークション商品検索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に下表に記載されたいずれかが表示されます。

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

過去のバージョン


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

楽天オークション商品検索API (2010-09-15)
楽天オークション商品検索API (2011-04-20)