Product Lookup：AI 购物答案中的商品曝光查询 API
发送商品名称，即可知道 ChatGPT、Google AI Overviews、AI Mode、Copilot 和 Naver AI Tab 中哪些引擎展示了该商品。通过 API 获取各引擎的商家与价格、答案引用的页面，以及与竞品的对比。
Copilot哪些引擎展示了你的商品
发送商品名称和国家（US 或 KR）。每个引擎的 found 表示答案是否展示了该商品，otherListings 列出一同展示的其他商品。summary.foundIn 和 summary.notFoundIn 把引擎分成两个列表。
商家、价格与评价
答案展示的每条商品记录都带有商家、价格和来源目录；引擎提供时，还带有库存、评分、评价数和目录 ID。ChatGPT 的 modelSees 是回答模型收到的商品信息，chatgpt_widget 记录则是 ChatGPT 在小组件卡片中写出的商家和价格。
答案引用的页面
citedPages 是每个答案引用的页面。summary.citedDomains 按网站归类并标出引用它的引擎，summary.merchants 列出每个商家、展示它的引擎及价格区间。
与竞品并排比较
最多添加 5 个竞品。竞品与你的商品收到相同的提问，comparison[] 按引擎把所有商品并排列出。
- found：各引擎是否展示了每个商品。
- listings、merchants：每个商品获得的记录数和商家数。
- mostReviewed、priceRange：评价最多的记录，以及引擎展示的价格区间。
- prompts：引擎回答的购物提示词数，以及其中展示或提到该商品的答案数。
购物提示词答案中的商品
最多添加 3 个购物提示词，例如“best eye cream for puffiness”。每个引擎按原文回答每个提示词，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 提问“{商品} 구매”和“{商品} 최저가”。
- 在 engines 中列出 Gemini 即会向它提问；在 KR，Google AI Overviews 和 Copilot 也通过 engines 加入。
提交到 POST /v1/product-lookup
发送商品、最多 5 个竞品和最多 3 个购物提示词。下面的查询向 4 个引擎询问 3 个商品和 2 个提示词，共 23 次提问，40 积分。idempotencyKey 即查询 ID。
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"
}'每次提问都是一个任务
响应列出每次提问及其任务，credits.creditsToCharge 汇总其价格。提问像普通任务一样执行、计费并发送 Webhook。用同一 ID 重新发送时，返回已有提问，只补充缺少的提问。
{
"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"
}
},
"…"
]
}用 GET /v1/product-lookup/:id 读取
用查询 ID 轮询，直到 lookup.status 为 COMPLETED，或在每次收到提问的 Webhook 时读取。请在提问完成后 24 小时内读取并保存结果。
curl https://api.querying.ai/v1/product-lookup/eye-bomb-us \
-H "Authorization: Bearer $QUERYING_API_KEY"费用
每个商品 10 积分，每个购物提示词 5 积分，向哪些引擎提问都一样。你的商品和每个竞品各算一个商品，因此上面的查询为 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 结合两次提问和小组件卡片，在美国 24 次和韩国 20 次运行中都展示了商品。
- 重复运行时，同一商家记录的价格、评分和评价数在 316 个值中有 307 个保持一致。展示哪些记录每次运行都会变化，因此请用多次查询判断趋势。
