商品検索（v3）

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

変更履歴

リクエストURL

https://shopping.yahooapis.jp/ShoppingWebService/V3/itemSearch?appid=<あなたのClient ID（アプリケーションID）>&query=nike

サンプルレスポンス

以下は、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,
        "review": {
          "rate": 4.41,
          "count": 5855
        },
        "imageId": "zozo_1"
      },
      "delivery": {
        "area": "",
        "deadLine": null,
        "day": null
      },
      "payment": "1 4 16 4096"
    }
  ]
}

エラー

商品検索から返される可能性のあるHTTPステータスコードは以下のとおりです。

また上記以外にもYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）

利用約款

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