楽天グループのウェブサービス/API/商品データベース。アフィリエイトにも対応
楽天ウェブサービス 楽天ウェブサービス BETA
my Rakuten | 楽天市場へ
ウェブサービス規約 | ヘルプ
ウェブサービストップ 楽天アフィリエイトを利用
トップ > 楽天書籍検索API
楽天ウェブサービス
オンラインドキュメント
楽天ウェブサービス規約
FAQ
クレジット表示
ウェブサービスチームブログ
旧ブログ
デベロッパーズ・コミュニティ
楽天市場系API
楽天商品検索API
楽天ジャンル検索API
楽天商品コード検索API
楽天カタログ検索API
楽天商品ランキングAPI【NEW】
楽天ブックス系API
楽天書籍検索API
楽天CD検索API
楽天DVD検索API
楽天オークション系API
楽天オークション商品検索API
楽天オークション商品コード検索API
楽天トラベル系API
楽天トラベル施設検索API
楽天トラベル施設情報API
楽天トラベル空室検索API
楽天トラベル地区コードAPI
楽天トラベルキーワード検索API
その他のAPI
楽天ダイナミックアドAPI
楽天ダイナミックアドAPI トラベル

提供API
楽天書籍検索API (version:2007-10-25)
楽天書籍検索APIとは
楽天書籍検索APIは、楽天ブックスで販売されている書籍の情報を取得することができるAPIです。デベロッパーはキーワードでの書籍検索をはじめ、ジャンル別の絞込み検索も可能となります。  
アカウント情報
デベロッパーIDの確認ヘルプ
アフィリエイトIDの確認ヘルプ
■リクエストURL(REST/JSON形式の場合)
http://api.rakuten.co.jp/rws/1.11/rest?[parameter]=[value]...
http://api.rakuten.co.jp/rws/1.11/json?[parameter]=[value]…

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

フィールド名keyword, sortに対応する[value]はUTF-8でURLエンコードされている必要があります。(リクエストURL全体をエンコードするのではなく、[value]部分を個別にエンコードしてください。)
たとえば、「ブログ」という検索キーワードで、「ビジネス・経済・就職(genreId=200446)」ジャンルの書籍を検索し、結果を価格が安い順に並べたい(sort=+itemPrice)場合のリクエストURLは下記になります。(実際には改行せずに1行につなげてリクエストしてください。)
http://api.rakuten.co.jp/rws/1.11/rest?
developerId=[YOUR_developerID]
&operation=BookSearch
&version=2007-10-25
&keyword=%E3%83%96%E3%83%AD%E3%82%B0
&genreId=200446
&sort=%2BitemPrice
短い時間の間に大量に、同一のリクエストURLへアクセスすると、一定時間利用できなくなる場合がございます。テストの際にはご注意ください。
■SOAPについて
SOAPを用いることで、より高度なアプリケーションの開発が可能となります。
SOAPに関しての詳細は「楽天書籍検索API(BookSearch)SOAP開発用」をご覧ください。
■入力パラメーター
楽天書籍検索API(BookSearch) 入力パラメーター version:2007-10-25
区分 ID 項目名 フィールド名
(括弧内は
最大
バイト数)
必須 デフォルト 備考





|

|
1 デベロッパID developerId String --- デベロッパーID
2 アフィリエイトID affiliateId String - 指定無し アフィリエイトID
3 操作 operation String --- 使用するAPIの操作名:
BookSearch
4 コールバック関数名 callBack String - 指定無し JSONPとして出力する際のコールバック関数名
(UTF-8でURLエンコードした文字列)
英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上

|







|

|
1 検索キーワード keyword String
(*1)
--- UTF-8でURLエンコードした文字列
(*1)検索キーワード、ジャンルIDのいずれかが指定されていることが必須です
2 バージョン version String --- 2007-10-25
3 ジャンルID genreId long
(*1)
0 楽天市場におけるジャンルを特定するためのID。
genreID=200162(本・雑誌・コミック)に所属するジャンルのみが指定できます。
ジャンル名、ジャンルの親子関係を調べたい場合は、「楽天ジャンル検索API(GenreSearch)」をご利用ください。
(*1)検索キーワード、ジャンルIDのいずれかが指定されていることが必須です。
4 1ページあたりの取得件数 hits int - 30 1から30までの整数
5 取得ページ page int - 1 1から100までの整数
6 ソート sort String - -reviewCount +affiliateRate:
アフィリエイト料率順(昇順)
-affiliateRate:
アフィリエイト料率順(降順)
+reviewCount:
レビュー件数順(昇順)
-reviewCount:
レビュー件数順(降順)
+itemPrice:
価格順(昇順)
-itemPrice:
価格順(降順)
+updateTimestamp:
商品更新日時順(昇順)
-updateTimestamp:
商品更新日時順(降順)
random:
ランダム順
※UTF-8でURLエンコードされている必要があります。
7 最小価格 minPrice long - 指定無し 0以上の整数
8 最大価格 maxPrice long - 指定無し 0以上の整数
maxPriceはminPriceより大きい必要がある
9 販売可能 availability int(1) - 1 0:すべての商品
1:販売可能な商品のみ
10 検索フィールド field int(1) - 1 0:検索対象が広い(同じ検索キーワードでも多くの検索結果が得られる)
1:検索対象範囲が限定される(同じ検索キーワードでも少ない検索結果が得られる)
11 キャリア carrier int(1) - 0 PC用の情報を返すのか、モバイル用の情報を返すのかを選択
PC: 0
mobile: 1
12 商品画像有無フラグ imageFlag int(1) - 0 0 : すべての商品を検索対象とする
1 : 商品画像ありの商品のみを検索対象とする
13 OR検索フラグ orFlag int(1) - 0 複数キーワードが設定された場合に、AND検索、OR検索のいずれかが選択可能。
0:AND検索
1:OR検索
※ただし、(A and B) or Cといった複雑な検索条件設定は指定不可。
14 除外キーワード NGKeyword String - 指定無し 検索結果から除外したいキーワード
UTF-8でURLエンコードした文字列
15 ジャンルごとの商品数取得フラグ genreInformationFlag int(1) - 0 0 :ジャンルごとの商品数の情報を取得しない
1 :ジャンルごとの商品数の情報を取得する
■出力パラメーター
楽天書籍検索API(BookSearch) 出力パラメーター version:2007-10-25
区分 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 全体情報 検索数 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  
9 商品コード itemCode  
10 商品価格 itemPrice  
11 商品説明分 itemCaption  
12 商品URL itemUrl  
13 アフィリエイトURL affiliateUrl (入力パラメーターにアフィリエイトIDが含まれていた時のみ)
14 商品画像有無フラグ imageFlag 0:商品画像無し
1:商品画像有り
15 商品画像64x64URL smallImageUrl (画像サイズ64px*64px)
16 商品画像128x128URL mediumImageUrl (画像サイズ128px*128px)
17 販売可能フラグ availability 0:販売不可能
1:販売可能
18 消費税フラグ taxFlag 0:税込
1:税別
19 送料フラグ postageFlag 0:送料込
1:送料別
20 クレジットカード利用可能フラグ creditCardFlag 0:カード利用不可
1:カード利用可
21 ショップオブザイヤーフラグ shopOfTheYearFlag 1:ショップオブザイヤー受賞店舗
22 アフィリエイト利用利率 affiliateRate  
23 販売開始時刻 startTime タイムセールが設定されている場合のみ(YYYY-MM-DD HH:MM形式)
24 販売終了時刻 endTime タイムセールが設定されている場合のみ(YYYY-MM-DD HH:MM形式)
25 レビュー件数 reviewCount  
26 レビュー平均 reviewAverage  
27 店舗情報 店舗名 shopName  
28 店舗コード shopCode 店舗ごとのURL (http://
www.rakuten.co.jp/[xyz])
におけるxyzのこと
29 店舗URL shopUrl httpからはじまる店舗ごとのURL
30 ジャンル情報 ジャンルID genreId  
31 ジャンルごとの商品数
(全体:<GenreInformation>
〜 </GenreInformation>
、個別ジャンル:<current> 〜 </current>もしくは<child> 〜 </child>)
自ジャンル --- current ユーザの入力したジャンルID
32 ジャンルID genreId  
33 ジャンル名 genreName  
34 ジャンルに紐づく商品数 itemCount  
35 ジャンル階層 genreLevel  
36 子ジャンル --- child ユーザの入力したジャンルIDの子ジャンル
複数の子ジャンルがある場合は<child> 〜 </child>が複数生成される
入力が「genreId=0」の時はgenreLevel=1の ジャンルが<child> 〜 </child>に表示される
37 ジャンルID genreId  
38 ジャンル名 genreName  
39 ジャンルに紐づく商品数 itemCount  
40 ジャンル階層 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)]
もしくは、
http://hb.afl.rakuten.co.jp/hgc/[アフィリエイトID]/?m=[商品URL(モバイル)]
■エラー
エラーが起こった際は、出力中の「共通パラメーター」のStatusに下表に記載されたいずれかが表示されます。
Statusでの表示 内容
NotFound 検索結果が存在しない。
ServerError 楽天ウェブサービス側のエラー。
ClientError デベロッパーの入力に起因するエラー。
Maintenance メンテナンス。
■過去のバージョン
本APIの過去のバージョンは下記からご覧いただけます。

個人情報保護方針
Copyright (c) 1997-2009 Rakuten, Inc. All Rights Reserved.