商品検索（v3）

商品検索はYahoo!ショッピングの商品検索結果を取得することが可能なAPIです。
デベロッパーは日本最大級の商品データベースからキーワードでの商品検索をはじめ、JANコード、ジャンルカテゴリID、ブランドID、ストアIDでの商品検索を行い、JSON形式で各種商品情報を取得できます。

---

リクエストURL

※JSONのみ

---

---

サンプルレスポンス

以下は、nikeという語を含む商品情報のリクエストに対するレスポンスです。

{"totalResultsAvailable":513766,"totalResultsReturned":1,"firstResultPosition":1,"request":{"query":"nike"},"hits":[{"index":1,"name":"＜NIKE（ナイキ）＞WOMENS AIR RIFT エアリフト","description":"ZOZO問い合わせ番号:53582864
ショップ:BEAUTY&YOUTH UNITED ARROWS，ビューティ&ユース ユナイテッドアローズ
ブランド:NIKE，ナイキ，BEAUTY&YOUTH UNITED ARROWS，ビューティアンドユースユナイテッドアローズ
商品名:＜NIKE（ナイキ）＞WOMENS AIR RIFT エアリフト
カテゴリ:シューズ>スニーカー
ブランド品番:18314996331
素材:-
カラー:ホワイト，ブラック
サイズ:23cm，24cm，25cm，26cm","headLine":"","url":"https:\/\/store.shopping.yahoo.co.jp\/zozo\/52582864.html","inStock":true,"code":"zozo_52582864","condition":"new","imageId":"zozo_52582864","image":{"small":"https:\/\/item-shopping.c.yimg.jp\/i\/c\/zozo_52582864","medium":"https:\/\/item-shopping.c.yimg.jp\/i\/g\/zozo_52582864"},"review":{"rate":0,"count":0,"url":"https:\/\/shopping.yahoo.co.jp\/review\/item\/list?store_id=zozo&page_key=52582864"},"affiliateRate":1,"price":10450,"premiumPrice":10450,"premiumPriceStatus":false,"premiumDiscountType":null,"premiumDiscountRate":null,"priceLabel":{"taxable":null,"defaultPrice":10450,"discountedPrice":null,"fixedPrice":null,"premiumPrice":null,"periodStart":null,"periodEnd":null},"point":{"amount":104,"times":1,"premiumAmount":104,"premiumTimes":1},"shipping":{"code":1,"name":"設定なし"},"genreCategory":{"id":23699,"name":"レディーススニーカー","depth":4},"parentGenreCategories":[{"depth":1,"id":13457,"name":"ファッション"},{"depth":2,"id":2494,"name":"レディースファッション"},{"depth":3,"id":1729,"name":"レディースシューズ"}],"brand":{"id":1319,"name":"NIKE"},"parentBrands":[{"id":1,"name":"ブランド"}],"janCode":"","releaseDate":null,"seller":{"sellerId":"zozo","name":"ZOZOTOWN","url":"https:\/\/paypaymall.yahoo.co.jp\/store\/zozo\/top\/","isBestSeller":false,"isPMallSeller":true,"payment":"1 4 16 4096","review":{"rate":4.41,"count":5855},"imageId":"zozo_1"},"delivery":{"area":"","deadLine":null,"day":null}}]}

---

エラー

商品検索はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

---

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を緩和させていただきます。（無料）
申請受付は停止中です。
1日50,000リクエストを超える場合は、アプリケーションIDを追加してご対応ください。
※古い商品検索APIで既にAPIコール数制限緩和申請を頂いているアプリケーションIDについては、
新しい商品検索APIについても、利用対象となっており、追加のご申請は不要です。
詳細は、下記のお知らせをご覧ください。
旧商品検索APIをご利用中の皆様へ

利用約款

このAPIに関する利用約款はこちら。