更新情報新機能

20のECサイトの商品検索に対応しました

API
COMMERCE_SERP のチップが付いた Commerce Search と、sunscreen の検索結果カード4枚。Amazon、Walmart、Target、Sephora の1位商品と価格、評価、レビュー数

Amazon、Walmart、Coupang、Olive Young、楽天、Flipkart、Zalandoなど5か国20のECサイトで、検索語の商品ランキングを価格、評価、レビュー数とともに同じ形で受け取れます。

得られる結果

  • COMMERCE_SERP: 1つのタスクで1つのECサイトを検索します。米国、韓国、日本、インド、ドイツの20サイトから payload.site で選びます。
  • products: 検索語に対するサイトの商品ランキングを最大40件受け取れます。各商品に rank、productId、title、url が入ります。
  • price は数値で、currency とともに届きます。検索結果ページに表示されていれば rating、reviewCount、brand、imageUrl も届きます。
  • どのサイトも同じ商品フィールドを使うため、1つのパーサーで Amazon、Coupang、楽天、Zalando を同じように読めます。

対応サイト

  • 米国（US）: Amazon amazon、Walmart walmart、Target target、eBay ebay、AliExpress aliexpress、Sephora sephora、Ulta ulta
  • 韓国（KR）: Coupang coupang、Olive Young oliveyoung、11st 11st、Lotte ON lotteon、Musinsa musinsa、Kurly kurly
  • 日本（JP）: 楽天市場 rakuten、Yahoo!ショッピング yahoo_shopping、Qoo10 qoo10
  • インド（IN）: Flipkart flipkart、Myntra myntra、Nykaa nykaa
  • ドイツ（DE）: Zalando zalando

仕組み

タスクごとに、そのサイトの国で検索語に対して表示される最初の検索結果ページを読み、サイトの標準の並び順で商品を返します。Coupang 以外のすべてのサイトで広告と表示された商品を除き、残りをページの順に rank で数えます。

productId はサイト独自の商品 ID です。Amazon は ASIN、eBay は商品番号、楽天は shop:item です。price は商品自体の currency（ISO 4217）での数値で、容量ごとに価格が違う場合は最も低い価格です。rating は評価を表示するサイトで5点満点で届き、Kurly と Zalando は価格と商品名で商品を表示します。

サイトが検索を別のページに送ると、そのページの商品を受け取ります。Ulta は一部のブランド名をブランドページへ、Target は一部の検索を関連する検索語へ送り、Nykaa はカテゴリー名の検索でカテゴリーページを表示します。商品が1件も見つからない検索は失敗したタスクとして終わります。

活用例

  • Amazon、Walmart、Target でカテゴリーの検索語に対する自社商品の順位を毎日追跡します。
  • 自社商品の価格、評価、レビュー数を、近い順位の商品と比べます。
  • Olive Young、楽天、Nykaa、Zalando で、ビューティーやファッションのラインを同じリクエストの形で追います。
  • 同じ検索語のサイトのランキングを ChatGPT や Google AI Mode の回答と並べ、買い物客がそれぞれの場所でどの商品に出会うかを確かめます。

リクエストを送る

API キーを Authorization ヘッダーに入れてリクエストを送ります。

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": "target", "query": "sunscreen", "limit": 10 }
  }'

リクエストのフィールド

taskTypestring必須
実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.sitestring必須
検索する EC サイト。amazon、coupang、rakuten などを指定します。20の値はエンジンの説明にあります。
payload.querystring必須
買い物客が EC サイトの検索窓に入力するとおりに書いた検索語。1〜500文字。
payload.countrystring
EC サイトの国。amazon は US、coupang は KR です。省略するとこの値が既定値になります。
payload.limitinteger
返す商品の数、1〜40。既定値は20。
webhook.urlstring
サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

JSON
{
  "success": true,
  "task": {
    "id": "fa04f93f-babe-4d50-9549-8b7100261fee",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T00:05:55.416Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "target",
    "query": "sunscreen",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "76545827",
        "title": "La Roche Posay Anthelios Melt in Milk Sunscreen Lotion - SPF 100 - 3.0 fl oz",
        "brand": "La Roche Posay",
        "url": "https://www.target.com/p/la-roche-posay-anthelios-melt-in-milk-sunscreen-lotion-spf-100-3-0-fl-oz/-/A-76545827",
        "price": 20.99,
        "currency": "USD",
        "rating": 4.54,
        "reviewCount": 995
      },
      {
        "rank": 2,
        "productId": "80839020",
        "title": "Neutrogena Beach Defense Sunscreen Lotion - SPF 70 - 1 fl oz",
        "brand": "Neutrogena",
        "url": "https://www.target.com/p/neutrogena-beach-defense-sunscreen-lotion-spf-70-1-fl-oz/-/A-80839020",
        "price": 1.99,
        "currency": "USD",
        "rating": 4.59,
        "reviewCount": 1580
      },
      "…"
    ]
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.returnedCountinteger
products に入っている商品の数。
response.productsarray
EC サイトの順に並んだ商品。rank、productId、title、url と、検索結果ページに表示されていれば price、currency、rating、reviewCount、imageUrl、brand が入ります。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

エラー

VALIDATION_ERRORHTTP 422
site が20のサイトの外にあるか、query が空か500文字を超えるか、limit が1〜40の外にあるか、payload に別のフィールドがあります。details に該当するフィールドが入ります。
REGION_UNSUPPORTEDHTTP 422
country が EC サイトの国と異なります。例: amazon に KR。
MISSING_API_KEYHTTP 401
Authorization ヘッダーが欠けているか、キーが誤っている、期限切れ、または無効化済みです。
INSUFFICIENT_CREDITSHTTP 402
残高がタスクの料金を下回っています。クレジットを追加するかプランを上げてから、もう一度送ってください。

料金

どのサイトでも、完了した検索1件ごとに3クレジットを使います。クレジットはタスクの完了時に差し引かれます。

ほかの更新

最新情報を受け取る

製品の更新をメールでお届けします。

RSS フィード