更新情報新機能

Product Lookupを紹介します

Product Lookup
belif Moisturizing Eye Bomb と競合商品2件を比べた Product Lookup の結果。ChatGPT、Google AI Overview、AI Mode、Copilot での販売店の掲載数、価格、評価と、ショッピングプロンプトへの回答8件のうち各商品が表示された数

Product LookupはAIショッピングエンジンに自社商品と競合商品を尋ね、回答が表示した販売店、価格、レビューをエンジンごとに返します。

得られる結果

  • engines[]: エンジンごとに、回答が自社商品を表示したか（found）と、表示した販売店の掲載を価格、在庫、評価、レビュー数、掲載元のカタログとともに受け取ります。
  • modelSees: ChatGPT の回答モデルが掲載から受け取った商品名、説明、評価、レビュー数。モデルが商品をどんな情報で読んでいるかがわかります。
  • comparison[]: 自社商品と最大5件の競合商品をエンジンごとに並べ、掲載数、販売店数、レビューが最も多い掲載、価格帯を比べます。
  • prompts[]: 最大3件のショッピングプロンプトについて、回答が照会商品のどれを表示し、名前を挙げたかを受け取ります。
  • citedPages、summary.citedDomains: 回答が引用したページと、エンジン全体でサイトごとにまとめた引用です。

仕組み

商品名と市場を送ります。US では ChatGPT に「Buy …」と「Find the best price for …」を、Google AI Overview、Google AI Mode、Bing Copilot に商品名を尋ねます。KR では Naver AI Tab と Google AI Mode に商品名を、ChatGPT に「… 구매」と「… 최저가」を尋ねます。競合商品も同じ質問を受け、ショッピングプロンプトは書いたまま各エンジンに1回ずつ尋ねます。下の例の商品3件とショッピングプロンプト2件は約2分で完了しました。

回答の商品掲載と、ChatGPT がショッピングカードに書いた販売店と価格を読み、タイトルに商品名を含むものを残します。match.score は掲載が商品名をどれだけ含むかを示し、セット、ミニ、リフィルには variant が付きます。照会は毎回ライブの回答を読みます。同じ掲載の価格、評価、レビュー数は実行を繰り返しても変わらず、エンジンが示す販売店の顔ぶれは回答ごとに入れ替わるため、照会を繰り返して傾向を見ます。

活用例

  • エンジンごとに、自社商品を表示しているか、どの販売店と価格で表示しているかを確認します。
  • エンジンごとにレビュー数と価格を競合商品と並べて見ます。下の照会では Bing Copilot が belif のレビュー 2,942 件を、Clinique の 85,773 件、CeraVe の 117,193 件と並べて表示しました。
  • 買い物客が使うカテゴリの質問で、回答がどの商品を前に出すかを見ます。下の照会では CeraVe が8件の回答のうち5件に、belif が2件に登場しました。
  • 商品フィードや掲載を変える前と後に照会し、各エンジンの表示を比べます。

リクエストを送る

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

curl -X POST https://api.querying.ai/v1/product-lookup \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "belif Moisturizing Eye Bomb",
    "country": "US",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "idempotencyKey": "eye-bomb-us"
  }'

リクエストのフィールド

productstring必須
買い物客が検索する商品名、1〜200文字。商品ページの URL やバーコードは VALIDATION_ERROR になります。
countrystring必須
US または KR。市場によって質問するエンジンと質問の文言が決まります。
competitorsarray
競合商品の名前を最大5件。それぞれに自社商品と同じ質問をします。
promptsarray
ショッピングプロンプトを最大3件。best eye cream for puffiness のように、書いたまま各エンジンに尋ねます。
enginesarray
質問するエンジン。US の既定は CHATGPT、GOOGLE、AIMODE、BING_COPILOT、KR の既定は NAVER_AI_TAB、CHATGPT、AIMODE です。GEMINI を加えると Gemini にも尋ねます。
idempotencyKeystring
照会の ID になります。同じ値で再送すると同じ照会を返し、足りない質問だけを加えます。
webhook.urlstring
サーバーの HTTPS アドレス。質問のタスクが完了するたびに結果をここへ送ります。

レスポンス

レスポンスです。長さを抑えて抜粋しています。

JSON
{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
  },
  "summary": { "total": 23, "succeeded": 23, "failed": 0 },
  "credits": { "creditsToCharge": 40, "creditsCharged": 0 },
  "asks": [
    {
      "engine": "CHATGPT",
      "taskType": "CHATGPT",
      "role": "product",
      "prompt": "Buy belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
        "taskType": "CHATGPT",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.422Z",
        "idempotencyKey": "eye-bomb-us:CHATGPT:buy"
      }
    },
    {
      "engine": "GOOGLE",
      "taskType": "GOOGLE",
      "role": "product",
      "query": "belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "0d6d6839-8705-44c1-ac3c-c5f56cb25d08",
        "taskType": "GOOGLE",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.472Z",
        "idempotencyKey": "eye-bomb-us:GOOGLE:name"
      }
    },
    "…"
  ]
}
lookup.idstring
照会の ID。送った idempotencyKey、またはサーバーが作った値で、GET /v1/product-lookup/{id} で照会を読みます。
summaryobject
質問の集計。total、succeeded、failed。
credits.creditsToChargenumber
すべての質問に回答が返ったときに使うクレジット。商品ごとに10、ショッピングプロンプトごとに5クレジットです。
asksarray
質問ごとに1件。エンジン、尋ねた文、task が入ります。拒否された質問にはコード付きの error が入ります。

結果を受け取る

質問1件が1つのタスクとして動くため、回答が届くたびに照会が埋まっていきます。lookup.status が COMPLETED になるまで GET /v1/product-lookup/{id} で読むか、webhook.url を加えて完了した質問のタスクを1件ずつ受け取ってください。照会は質問の完了後24時間読めます。

curl "https://api.querying.ai/v1/product-lookup/$LOOKUP_ID" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

完了した照会はこのような形です。長さを詰めて表示しています。

JSON
{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "status": "COMPLETED",
    "createdAt": "2026-10-20T09:22:43.422Z",
    "completedAt": "2026-10-20T09:24:36.695Z",
    "credits": 40
  },
  "summary": {
    "foundIn": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"],
    "notFoundIn": [],
    "merchants": [
      {
        "merchant": "Ulta Beauty",
        "engines": ["CHATGPT", "BING_COPILOT"],
        "price": { "currency": "USD", "min": 48, "max": 48 }
      },
      {
        "merchant": "Amazon",
        "engines": ["CHATGPT"],
        "price": { "currency": "USD", "min": 43, "max": 43 }
      },
      "…"
    ],
    "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
    "citedDomains": [
      {
        "domain": "ulta.com",
        "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
      },
      "…"
    ],
    "credits": 10
  },
  "engines": [
    {
      "engine": "CHATGPT",
      "status": "COMPLETED",
      "found": true,
      "via": [
        {
          "taskType": "CHATGPT",
          "prompt": "Buy belif Moisturizing Eye Bomb",
          "taskId": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
          "status": "COMPLETED",
          "credits": 2
        },
        "…"
      ],
      "listings": [
        {
          "ask": 1,
          "position": 1,
          "title": "belif Moisturizing Eye Bomb Eye Cream",
          "merchant": "Ulta Beauty",
          "source": "merchant_feed",
          "price": { "value": 48, "currency": "USD", "raw": "$48.00" },
          "available": true,
          "modelSees": {
            "rating": 4.5,
            "reviewCount": 105,
            "brand": "belif"
          },
          "match": { "score": 1 }
        },
        {
          "ask": 2,
          "position": 1,
          "title": "Amazon",
          "merchant": "Amazon",
          "source": "chatgpt_widget",
          "price": { "value": 43, "currency": "USD", "raw": "$43.00" },
          "match": { "score": 1 }
        },
        "…"
      ],
      "citedPages": [
        {
          "ask": 1,
          "domain": "lgbeauty.com",
          "title": "Moisturizing Eye Bomb"
        },
        "…"
      ]
    },
    "…"
  ],
  "comparison": [
    {
      "product": "belif Moisturizing Eye Bomb",
      "role": "product",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 5,
          "mostReviewed": {
            "reviewCount": 2942,
            "rating": 4.58,
            "merchant": "Comparor"
          },
          "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
          "prompts": { "answered": 2, "appeared": 1 }
        },
        "…"
      ]
    },
    {
      "product": "CeraVe Eye Repair Cream",
      "role": "competitor",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 6,
          "mostReviewed": {
            "reviewCount": 117193,
            "rating": 4.35,
            "merchant": "Pasteur Pharmacy"
          },
          "priceRange": { "currency": "USD", "min": 15.95, "max": 38.95 },
          "prompts": { "answered": 2, "appeared": 0 }
        },
        "…"
      ]
    },
    "…"
  ],
  "prompts": [
    {
      "prompt": "best moisturizing eye cream",
      "engines": [
        {
          "engine": "GOOGLE",
          "status": "COMPLETED",
          "shown": ["CeraVe Eye Repair Cream", "Clinique All About Eyes"],
          "named": [
            "belif Moisturizing Eye Bomb",
            "CeraVe Eye Repair Cream",
            "Clinique All About Eyes"
          ]
        },
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "shown": ["belif Moisturizing Eye Bomb"],
          "named": ["belif Moisturizing Eye Bomb"]
        },
        "…"
      ]
    },
    "…"
  ]
}
lookup.statusstring
質問の実行中は QUEUED、PROCESSING。すべての質問が終わり1件でも回答があれば COMPLETED、すべて失敗したら FAILED です。
lookup.creditsnumber
これまでに回答した質問に使ったクレジット。
engines[].foundboolean
エンジンの回答が商品を表示したか。販売店の掲載か ChatGPT のショッピングカードが1件でもあれば true です。
engines[].listingsarray
商品として表示された販売店の掲載ごとに merchant、price、available、評価とレビュー数、掲載元のカタログ（source）が付き、ChatGPT では回答モデルが受け取った情報（modelSees）も付きます。
summary.merchantsarray
商品を表示した販売店ごとに、その販売店を表示したエンジンと価格帯。
comparisonarray
自社商品と競合商品をエンジンごとに並べます。found、listings、merchants、mostReviewed、priceRange と、ショッピングプロンプトの回答に出た件数が付きます。
prompts[].enginesarray
ショッピングプロンプトとエンジンごとに、回答が表示した照会商品（shown）と本文で名前を挙げた照会商品（named）。

エラー

VALIDATION_ERRORHTTP 400
フィールドが欠けているか、範囲外の値です。details に該当するフィールドが入ります。
REGION_UNSUPPORTEDHTTP 422
country が US、KR 以外の市場です。
RESOURCE_ALREADY_EXISTSHTTP 409
この idempotencyKey はすでに別の商品、競合商品、ショッピングプロンプト、または国の照会に使われています。新しいキーで送ってください。
INSUFFICIENT_CREDITSHTTP 402
残高がタスクの料金を下回っています。クレジットを追加するかプランを上げてから、もう一度送ってください。
PLAN_CONCURRENCY_LIMITHTTP 429
プランの同時実行タスクが上限に達しています。入る質問だけが入り、残りはこのコードで asks[] に返ります。Retry-After 秒後に同じリクエストを送ると残りが加わります。1件も入らないときはリクエスト全体が 429 になります。

料金

商品は自社商品も競合商品も1件につき10クレジット、ショッピングプロンプトは1件につき5クレジットで、どのエンジンに尋ねても同じです。価格はその商品の質問に分けて割り当て、回答した質問の分だけ使います。上の照会は商品3件とショッピングプロンプト2件で40クレジットです。

ほかの更新

最新情報を受け取る

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

RSS フィード