更新日志新功能

现已支持 ChatGPT

ChatGPT
比较无线耳机的 ChatGPT 回答，以及含来源和搜索词的 JSON 结果

在你选择的市场向 ChatGPT 提问，以 JSON 获取当地真实访客看到的回答和全部引用来源。

获得的结果

  • text 和 markdown：完整回答，同时提供纯文本和保留格式的版本。
  • sources：回答引用的每个页面，按顺序列出，附带 URL 和标题。
  • searchQueries：ChatGPT 回答时执行的网页搜索，让你看到它如何研究你的问题。
  • model：该会话中作答的模型。

工作原理

每个任务都会在你设定的国家开启一个全新的 ChatGPT 会话，并按原文提出你的问题。你拿到的是该市场首次访问的用户看到的回答，因此其中推荐的品牌和引用的页面与客户实际读到的一致。

每次运行都是一次新的观测。按计划重复同样的问题并比较结果，就能看到回答、推荐品牌和引用页面随时间的变化。

应用场景

  • 确认 ChatGPT 在买家常问的问题中是否推荐你的品牌。
  • 找出 ChatGPT 在你所在品类中引用的页面，据此规划内容。
  • 按国家比较同一问题的回答。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "CHATGPT",
    "payload": {
      "prompt": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US"
    }
  }'

请求字段

taskTypestring必填
要运行的引擎，例如 CHATGPT 或 GOOGLE。
payload.promptstring必填
按用户在聊天框中输入的方式写的问题，最多 100,000 个字符。
payload.countrystring
提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。
payload.locationstring
country 内的地点，例如车站、街区或街道地址，最多 200 个字符。引擎会按身处该地点的用户作答。适用于 CHATGPT、GEMINI、GOOGLE、AIMODE 和 GOOGLE_SERP。
payload.include.markdownboolean
返回 markdown：保留标题、列表、表格和链接的回答。默认开启。
payload.include.searchQueriesboolean
返回 searchQueries：ChatGPT 为回答执行的网页搜索。默认开启。
payload.include.shoppingboolean
以 shoppingCards 返回 ChatGPT 展示的商品卡片。默认开启。
payload.include.rawResponseboolean
设为 true 会在结构化结果旁附带引擎原始输出，便于自行解析。默认关闭。
webhook.urlstring
你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。
idempotencyKeystring
你为请求设定的 ID。每个键在账户内对应一个任务，因此重试发送后仍是同一个任务。

响应

完成的任务如下所示，已截取部分内容。

JSON
{
  "success": true,
  "task": {
    "id": "8bafb0ff-3cc7-4bc4-99bf-32dbacaf7736",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.604Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "For commuting, I’d prioritize strong ANC (trains, buses, traffic) and 6+ hours of playback. These three are top picks:",
    "markdown": "| Earbuds | Noise cancellation | Battery life (ANC on) |\n|---|---|---|\n| Bose QuietComfort Ultra Earbuds (2nd Gen) | Excellent — among the strongest ANC available | ~6 hrs (24 hrs with case) … |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.wired.com/gallery/best-noise-canceling-earbuds/",
        "label": "Best Noise-Canceling Earbuds: Bose, Sony, Apple, and More | WIRED",
        "attribution": "WIRED",
        "datePublished": "March 29, 2026"
      },
      {
        "position": 2,
        "url": "https://www.tomsguide.com/audio/earbuds/best-noise-canceling-earbuds",
        "label": "Best noise-canceling earbuds in 2026: Tested and reviewed | Tom's Guide",
        "attribution": "Tom's Guide",
        "datePublished": "July 24, 2026"
      }
    ],
    "searchQueries": [
      "best wireless earbuds commuting noise cancellation battery life Sony Bose Apple"
    ]
  }
}
task.statusstring
依次为 QUEUED、PROCESSING，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。
credits.creditsChargedinteger
已完成任务扣除的积分。失败的任务为 0。
response.textstring
纯文本形式的回答。
response.markdownstring
保留格式的回答，包括标题、列表、表格和链接。
response.sourcesarray
回答引用的页面，按引擎展示的顺序排列，含 position、url 和 label。
response.searchQueriesarray
引擎为写出回答执行的网页搜索。
response.shoppingCardsarray
与回答一同展示的商品卡片：标题、价格、商店、评分和商品链接。

获取结果

请求会立即返回 status 为 QUEUED 的任务。用 GET /v1/async/task/{id} 轮询，直到 status 变为 COMPLETED 或 FAILED；或者加上 webhook.url，在服务器上接收同样的 task、credits 和 response。任务结束后，结果保留 24 小时供查询。

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

价格

每个完成的 ChatGPT 任务消耗 2 个积分。

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅