Commerce Search API (COMMERCE_SERP)

​

リクエスト

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_SERP", "payload": { "site": "amazon", "query": "wireless earbuds", "limit": 20 } }'

​

パラメータ

• site: 必須。下の表のストアから選びます。
• query: 必須の検索語です。1-500 文字です。
• country: 任意。デフォルトはストアの国です。ほかの国は 422 REGION_UNSUPPORTED で拒否されます。
• limit: 任意の整数、1-40。デフォルトは 20 です。

​

レスポンス例

{
  "site": "amazon",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 1,
  "products": [
    {
      "rank": 1,
      "productId": "B0CHWRXH8B",
      "title": "Wireless Earbuds, Bluetooth 5.3 Headphones",
      "url": "https://www.amazon.com/dp/B0CHWRXH8B",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.6,
      "reviewCount": 19406
    }
  ]
}

​

結果フィールド

• site、query、country はリクエストの値です。returnedCount は products の件数です。
• 各商品は rank、productId、title、url を含みます。productId はストア独自の商品 ID です（Amazon では ASIN、eBay では商品番号、楽天市場では shop:item）。rank はストアの標準の並び順です。Coupang 以外のストアでは、広告と表示された商品を除きます。
• price、rating、reviewCount、imageUrl、brand は検索結果ページに表示されている場合に含まれます。price は商品ごとの currency（ISO 4217）での数値です。Amazon は 1 回の検索で複数の通貨を表示することがあります。サイズごとに価格が異なる場合は最も低い価格を返します。Target の価格は Target の標準オンラインストアの価格です。AliExpress の価格は、ログインしていない米国の購入者に表示される販売価格です。
• rating は 5 段階評価です。Kurly と Zalando は評価を表示せず、AliExpress は評価件数なしで星の数を表示します。999+ のように省略された件数は含みません。brand は商品名とは別にブランドを表示する Target、Sephora、Ulta、Olive Young、Lotte ON、Musinsa、Yahoo!ショッピング、Qoo10、Flipkart、Myntra、Nykaa、Zalando で含まれます。
• google_shopping の productId は Google の商品 ID で、Google が商品にまとめていない出品はオファー ID です。Google のページには商品ページや販売店ページへのリンクがないため、url は商品が表示された Google ショッピングの検索結果ページの末尾に #product={productId}&title={title} を付けたものです。この url を Commerce Product に渡すと、商品の販売店、仕様、説明を読み取れます。seller は Google が最初に表示する販売店で、reviewCount は Google が正確な件数を表示する場合（1,000 件未満）のみ含まれます。
• 各検索はストアの検索結果の 1 ページ目から商品を返します。このページには Yahoo!ショッピングで最大 30 件、Myntra で 32 件、Zalando で 24 件が並びます。Flipkart は 40 枠、Nykaa は 20 枠で、広告を含みます。
• ストアが検索を別のページへ移す場合は、そのページの商品を返します。Ulta は一部のブランド名の検索をブランドページへ、Target は一部の検索を関連する検索語へ移します。Nykaa はカテゴリ名の検索でカテゴリページを表示します。
• 商品が 1 件もない検索は失敗したタスクになります。課金は完了した検索ごとです。

​

関連

• Commerce Product
• エンジン一覧
• クレジットと上限