ショッピング
商品コード検索
Version 1
リクエストURL
XML
http://shopping.yahooapis.jp/ShoppingWebService/
PHPserialize
http://shopping.yahooapis.jp/ShoppingWebService/
JSONP
http://shopping.yahooapis.jp/ShoppingWebService/
各ストアの商品がもつユニークなコード（商品コード）をキーに個別の商品情報を取得するためのAPIです（商品コードは商品検索およびカテゴリランキングのレスポンスフィールドCodeに含まれます）。
リクエストパラメータ
「RESTリクエストの構築（GET）」をご参照ください。
| パラメータ | 値 | 説明 |
| appid （必須） |
string | アプリケーションID。詳細はこちらをご覧ください。 |
| affiliate_type | yid/vc | Yahoo! JAPANアフィリエイト（yid）とバリューコマースアフィリエイト（vc）の選択。 例：affiliate_type=yid |
| affiliate_id | string | Yahoo! JAPANアフィリエイトIDもしくは、バリューコマースアフィリエイトIDを入力。 |
| callback | string | JSONPとして出力する際のコールバック関数名を入力するためのパラメータ。UTF-8でエンコードした文字列を入力する。 |
| itemcode （必須） |
string | 商品コード（商品検索APIおよびカテゴリランキングAPIの結果リストのCodeタグに含まれる、商品固有のコード。ストアID_ストア商品コードの組み合わせ） |
| responsegroup | small/medium |
デフォルトはsmall。 取得できるデータのサイズを指定できる。smallが最小、最速です。詳細はレスポンスフィールドに記載があります。 |
サンプルリクエストURL
http://shopping.yahooapis.jp/ShoppingWebService/V1/itemLookup?
レスポンスフィールド
商品コード検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://shopping.yahooapis.jp/ShoppingWebService/V1/itemLookup.xsd
| フィールド | 説明 |
| ResultSet（small） | クエリーレスポンスのすべてを含み、次の属性を持ちます。
|
| ItemCode（small） | リクエストした商品コード |
| Hit（small） | 検索された結果
|
| Url（small） | 商品URL |
| Name（small） | 商品名 |
| Description（medium） | 商品説明 |
| Headline（small） | キャッチコピー |
| Code（medium） | 商品コード |
| JanCode（medium） | JANコード |
| Id（small） | 画像ID |
| Small（small） | 76×76サイズの画像URL |
| Medium（medium） | 146×146サイズの画像URL |
| Count（medium） | レビュー保持数 |
| Rate（medium） | レビュー平均評価 |
| Url（medium） | レビューページへのURL／アフィリエイトURL |
| Price（small） | 価格
|
| PriceLabel（small） | 表示価格
|
| FixedPrice（small） | 定価 |
| SalePrice（small） | セール価格 |
| Amount（medium） | ポイント数（ポイント倍率をかけた後の値） |
| Times（medium） | ポイント倍率 |
| Method（large） | 支払い情報 |
| Code（large） | 1＝クレジットカード、2＝銀行振込、4＝商品代引、8＝郵便振替、16＝Yahoo!ウォレット、32＝モバイルSuica、64＝コンビニ支払い、128＝ペイジー（対応する決済方法をbitwise論理和で表記） 例：クレジットカード、銀行振込、商品代引のみ可能なストアの場合、1＋2＋4＝7でエレメントには7がレスポンスされます。 |
| Name（large） | クレジットカード、銀行振込、商品代引、郵便振替、Yahoo!ウォレット登録のクレジットカード、モバイルSuica、コンビニ支払い、ペイジー |
| Code（medium） | 条件コード 1＝設定なし 2＝送料無料 3＝条件付送料無料 |
| Name（medium） | テキストで以下のいずれかの値 設定なし／送料無料／条件付送料無料 |
| Id（large） | ストアID |
| Url（large） | ストアURL |
| Name（large） | ストア名 |
| Rate（large） | ストア評価【0.0-5.0】まで0.5刻み |
| Count（large） | 評価人数 |
| Id（large） | 画像ID |
| Medium（large） | 120×30サイズの画像URL |
サンプルレスポンス
以下は、商品コード（hmv_2737935）のリクエストに対するレスポンスです。
エラー
商品コード検索Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。（無料）
まずはヘルプページのお問い合わせフォームからご相談ください。
