楽天グループのウェブサービス/API/商品データベース。アフィリエイトにも対応
楽天ウェブサービス 楽天ウェブサービス

BETA

my Rakuten | 楽天市場へ
ウェブサービス規約 | ヘルプ
ウェブサービストップ 楽天市場 RMSパートナー 楽天アフィリエイトを利用
トップ > 楽天商品コード検索API(SOAP開発用)
楽天ウェブサービス
オンラインドキュメント
楽天ウェブサービス規約
FAQ
APIステータス
クレジット表示
ウェブサービスチームブログ
旧ブログ
楽天市場系API
楽天商品検索API
楽天ジャンル検索API
楽天商品コード検索API
楽天商品ランキングAPI
楽天プロダクト製品検索API
楽天プロダクト製品詳細API
楽天プロダクトジャンル情報API
楽天プロダクトメーカー情報API
楽天ブックス系API
楽天ブックス総合検索API
楽天ブックス書籍API
楽天ブックスCD検索API
楽天ブックスDVD/Blu-ray検索API
楽天ブックス洋書検索API
楽天ブックス雑誌検索API
楽天ブックスゲーム検索API
楽天ブックスソフトウェア検索API
楽天ブックスジャンル検索API
楽天オークション系API
楽天オークション商品検索API
楽天オークション商品コード検索API
楽天オークションジャンル検索API
楽天トラベル系API
楽天トラベル施設検索API
楽天トラベル施設情報API
楽天トラベル空室検索API
楽天トラベル地区コードAPI
楽天トラベルキーワード検索API
楽天トラベルホテルチェーンAPI
楽天トラベルランキングAPI
>> 楽天トラベル系APIサンプル集
その他のAPI
楽天GORAゴルフ場検索API
楽天GORAゴルフ場詳細API
楽天GORAプラン検索API
楽天ダイナミックアドAPI
楽天ダイナミックアドAPI トラベル
楽天アフィリエイト高料率ショップAPI

提供API
楽天商品コード検索API(SOAP開発用) (version:2007-04-11)
 
アカウント情報
デベロッパーIDの確認ヘルプ
アフィリエイトIDの確認ヘルプ
■リクエストURL
http://api.rakuten.co.jp/rws/soap/ItemCodeSearch/2007-04-11
リクエストURLは取得するデータ種別にかかわらず、すべて同じです。
■インターフェース仕様
SOAPでは、インタフェース仕様はWSDLによって定義されます。下記のWSDLを参照してください。
http://api.rakuten.co.jp/rws/soap/ItemCodeSearch/2007-04-11?wsdl
■入力パラメーター
楽天商品コード検索API(ItemCodeSearch) SOAP用入力パラメーター version:2007-04-11
区分 ID 項目名 フィールド名 必須 デフォルト 備考





|

|
1 デベロッパID developerId String --- デベロッパーID
2 アフィリエイトID affiliateId String - 指定無し アフィリエイトID

|







|

|
1 商品コード itemCode String --- 商品コード
楽天商品検索API(ItemSearch)の出力に含まれる
2 バージョン apiVersion String --- 1.11
3 キャリア carrier String - 0 PC用の情報を返すのか、モバイル用の情報を返すのかを選択
PC: 0
mobile: 1
■出力パラメーター
楽天商品コード検索API(ItemCodeSearch) SOAP用出力パラメーター version:2007-04-11
区分 ID 大分類 分類 項目名 フィールド名 備考





|

|
1 arg --- String User-Agent Valueにはユーザのユーザエージェントが表示される
2 --- String developerId ValueにはデベロッパーIDが表示される
3 --- String operation Valueにはユーザの指定した操作名が表示される
4 --- String version Valueにはユーザの指定した操作のバージョンが表示される
5 --- String apiVersion Valueにはユーザの指定した楽天ウェブサービスのバージョンが表示される
6 status --- String status Success / NotFound / ServerError / ClientError / Maintenance のいずれか
7 statusMsg --- String statusMsg Statusに特化したメッセージを出力

|







|

|
1 全体情報 キャリア情報 int carrier PC=0 or mobile=1
2 商品情報 商品名 String itemName  
3 商品コード String itemCode  
4 商品価格 long itemPrice  
5 商品説明文 String itemCaption  
6 商品URL String itemUrl  
7 アフィリエイトURL String affiliateUrl (入力パラメーターにアフィリエイトIDが含まれていた時のみ)
8 商品画像有無フラグ int imageFlag 0:商品画像無し
1:商品画像有り
9 商品画像64x64URL String smallImageUrl (画像サイズ64px*64px)
10 商品画像128x128URL String mediumImageUrl (画像サイズ128px*128px)
11 販売可能フラグ int availability 0:販売不可能
1:販売可能
12 消費税フラグ int taxFlag 0:税込
1:税別
13 送料フラグ int postageFlag 0:送料込
1:送料別
14 クレジットカード利用可能フラグ int creditCardFlag 0:カード利用不可
1:カード利用可
15 ショップオブザイヤーフラグ int shopOfTheYearFlag 1:ショップオブザイヤー受賞店舗
16 アフィリエイト利用利率 double affiliateRate  
17 販売開始時刻 String startTime タイムセールが設定されている場合のみ(YYYY-MM-DD HH:MM形式)
18 販売終了時刻 String endTime タイムセールが設定されている場合のみ(YYYY-MM-DD HH:MM形式)
19 レビュー件数 long reviewCount  
20 レビュー平均 double reviewAverage  
21 店舗情報 店舗名 String shopName  
22 店舗コード String shopCode 店舗ごとのURL(http://www.rakuten.co.jp/[xyz])におけるxyzのこと
23 店舗URL String shopUrl httpからはじまる店舗ごとのURL
24 ジャンル情報 ジャンルID String genreId  
■アフィリエイトに関して
デベロッパーは、楽天商品コード検索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 メンテナンス。

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