Product Lookup: AI ショッピング回答の商品露出を調べる API

商品名を送ると、ChatGPT、Google AI Overviews、AI Mode、Copilot、Naver AI Tab のどのエンジンがその商品を表示するかを返します。エンジン別の販売店と価格、回答が引用したページ、競合商品との比較を API で受け取ります。

01

どのエンジンが商品を表示するか

商品名と国(US または KR)を送ります。エンジンごとに found が回答に商品が表示されたかを示し、otherListings には一緒に表示された他の商品が入ります。summary.foundIn と summary.notFoundIn がエンジンを 2 つのリストに分けます。

02

販売店、価格、レビュー

回答が表示した商品レコードごとに販売店、価格、出典カタログが付き、エンジンが提供する場合は在庫、評価、レビュー数、カタログ ID も付きます。ChatGPT の modelSees には回答モデルが受け取った商品情報が、chatgpt_widget のレコードには ChatGPT がウィジェットカードに書いた販売店と価格が入ります。

03

回答が引用したページ

citedPages は回答ごとに引用したページです。summary.citedDomains はそれをサイト別にまとめて引用したエンジンを付け、summary.merchants は販売店ごとに表示したエンジンと価格帯を返します。

競合商品と並べて比較

競合商品を最大 5 個まで追加します。競合商品も自社商品と同じ質問を受け、comparison[] がすべての商品をエンジンごとに並べます。

  • found: 各エンジンがそれぞれの商品を表示したか。
  • listings、merchants: 商品ごとのレコード数と販売店数。
  • mostReviewed、priceRange: レビューが最も多いレコードと、エンジンが表示した価格帯。
  • prompts: エンジンが答えたショッピングプロンプトの数と、そのうち商品を表示した、または名前を挙げた回答の数。

ショッピングプロンプトの回答に出る商品

「best eye cream for puffiness」のようなショッピングプロンプトを最大 3 個まで追加します。各エンジンに書いたとおりに質問し、prompts[] が、回答がレコードで表示した商品(shown)と本文で名前を挙げた商品(named)を返します。

市場ごとのエンジンと質問

市場ごとに、その市場で商品レコードを表示するエンジンに質問します。engines でエンジンを選びます。

  • US: ChatGPT には「Buy {商品}」と「Find the best price for {商品}」を、Google AI Overviews、AI Mode、Copilot には商品名を送ります。
  • KR: Naver AI Tab と AI Mode には商品名を、ChatGPT には「{商品} 구매」と「{商品} 최저가」を送ります。
  • Gemini は engines に入れると質問します。KR では Google AI Overviews と Copilot も engines に入れて質問します。
ステップ 1

POST /v1/product-lookup に送信する

商品と最大 5 個の競合商品、最大 3 個のショッピングプロンプトを送ります。この照会は 4 つのエンジンに商品 3 個とショッピングプロンプト 2 個を尋ね、質問 23 件で 40 クレジットです。idempotencyKey が照会 ID になります。

cURL
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"
}'
ステップ 2

質問 1 件がタスク 1 件

レスポンスは質問ごとのタスクを返し、credits.creditsToCharge がその料金を合計します。質問は通常のタスクと同じく実行、課金され、Webhook を送ります。同じ ID で再送すると既存の質問を返し、欠けている質問だけを追加します。

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-…",
        "taskType": "CHATGPT",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.422Z",
        "idempotencyKey": "eye-bomb-us:CHATGPT:buy"
      }
    },
    "…"
  ]
}
ステップ 3

GET /v1/product-lookup/:id で読む

lookup.status が COMPLETED になるまで照会 ID でポーリングするか、質問の Webhook が届くたびに読みます。結果は質問の完了後 24 時間以内に読んで保存してください。

cURL
curl https://api.querying.ai/v1/product-lookup/eye-bomb-us \
  -H "Authorization: Bearer $QUERYING_API_KEY"

料金

商品 1 個は 10 クレジット、ショッピングプロンプト 1 個は 5 クレジットで、どのエンジンに質問しても同じです。自社商品と各競合商品をそれぞれ商品 1 個と数えるため、上の照会は 40 クレジットです。商品の料金はその商品の質問に分けて付き、失敗した質問のクレジットは残高に戻り、再送では追加した質問だけが課金されます。

料金を見る →
プラン別の商品照会料金
プラン1,000 商品
Basic≈ $25.00
Max≈ $10.00

月間クレジットをすべて使った場合の換算料金です。

50 商品で測定した結果

2026-10-20 に本番 API で米国の商品 25 個と韓国の商品 25 個を照会しました。

  • US: Copilot は 25 個すべて、Google AI Overviews と AI Mode は 23 個を表示しました。
  • KR: Naver AI Tab は 25 個すべて、AI Mode は 13 個を表示しました。
  • ChatGPT は 2 つの質問とウィジェットカードを合わせ、米国 24 回、韓国 20 回の実行すべてで商品を表示しました。
  • 繰り返し実行では、同じ販売店レコードの価格、評価、レビュー数が 316 値中 307 値で同じでした。どのレコードが出るかは実行ごとに変わるため、傾向は複数回の照会で読みます。

関連機能

無料クレジット500で始める

Playgroundで最初のタスクを実行するか、APIキーですぐに呼び出せます。