更新日志新功能

新增 ChatGPT 卡片详情面板

ChatGPT
回答扫地机器人问题的 ChatGPT 画面，回答旁打开了 Roborock Saros 20 的详情面板，并标注为 entityDetails

在 ChatGPT 任务中开启 include.entityDetails，即可免费获得回答中每张商品、地点或品牌卡片对应的 ChatGPT 详情面板，包括正文、来源和图片。

获得的结果

  • 在 CHATGPT 任务上使用 payload.include.entityDetails: true。
  • 回答以及 followUps 中的每个回答都会附带 entityDetails：回答中的每张卡片一项，最多 20 项。
  • 每项包含 name、category（product、local_business、software、organization、brand 等）、query、status、markdown、sources、products、images 和 complete。
  • sources 列出详情面板引用的网站，包含 position、url、label、site 和 description。

工作原理

用户在 ChatGPT 回答中点击商品、地点或品牌卡片时，ChatGPT 会打开详情面板，引用它读过的网站简要介绍该对象。回答结束后，我们在同一个对话中为回答里的每张卡片请求这个面板，每次 4 张。详情步骤让每个回答多花约 10 秒。

markdown 是 ChatGPT 写出的面板原文，包含标题、列表和来源链接。complete: false 表示 ChatGPT 在写完面板前停下，已写出的正文和来源会保留。

每张卡片独立处理。失败的卡片带有 status: "failed" 和 error（ENTITY_DETAIL_FAILED 或 ENTITY_DETAIL_EMPTY），回答和其他卡片照常完成。使用 location、CN 或 HK 的任务，卡片返回 ENTITY_DETAIL_UNAVAILABLE。

include.entityDetails 用于 CHATGPT，并且不与 include.html 同时使用。发送给其他引擎或与 include.html 一起发送时，会在预留积分之前返回 422 VALIDATION_ERROR。

应用场景

  • 查看购物用户点击你的商品卡片时 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": "What is the best robot vacuum for pet hair?",
      "country": "US",
      "include": { "entityDetails": true }
    }
  }'

请求字段

taskTypestring必填
要运行的引擎，例如 CHATGPT 或 GOOGLE。
payload.promptstring必填
按用户在聊天框中输入的方式写的问题，最多 100,000 个字符。
payload.countrystring
提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。
payload.include.entityDetailsboolean
设为 true 会附带 entityDetails：ChatGPT 为回答中每张卡片打开的详情面板。用于 CHATGPT，不与 include.html 同用。默认关闭，不额外收费。
payload.followUpsarray
在第一个回答之后，于同一 ChatGPT 对话中继续的轮次，最多 4 个。每项为发送问题的 {"prompt": "…"}，或点击上一个回答中表单按钮的 {"select": {…}}。适用于 CHATGPT。
webhook.urlstring
你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。

响应

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

JSON
{
  "success": true,
  "task": {
    "id": "a81e4b26-b4c0-48eb-b20b-10efbd327f1a",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T04:40:09.819Z"
  },
  "response": {
    "text": "For most pet owners, I’d start with the **Dreame L40 Ultra Gen 2**. It offers a strong mix of pet-hair pickup, anti-tangle features, automatic dust emptying, and minimal day-to-day maintenance without necessarily requiring a flagship-level budget. …",
    "model": "gpt-6",
    "entityDetails": [
      "…",
      {
        "name": "Roborock Saros 20",
        "category": "product",
        "query": "Roborock Saros 20",
        "status": "ok",
        "markdown": "The **Roborock Saros 20** is Roborock's 2026 flagship robot vacuum and mop. It focuses on high-end automation with powerful vacuuming, dual spinning mop pads, advanced obstacle avoidance, an ultra-slim body for cleaning under furniture, and a dock that automates most maintenance tasks. …",
        "sources": [],
        "images": [],
        "complete": true
      },
      {
        "name": "MOVA P50 Pro Ultra",
        "category": "product",
        "query": "MOVA P50 Pro Ultra",
        "status": "ok",
        "markdown": "## MOVA P50 Pro Ultra\n\nThe **MOVA P50 Pro Ultra** is a premium robot vacuum and mop introduced as MOVA's 2025 flagship model. … ([RTINGS.com +1](https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com))\n\n### Key features\n\n- **19,000 Pa suction power**\n- **Dual rotating mop pads**\n…",
        "sources": [
          {
            "position": 1,
            "url": "https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
            "label": "MOVA P50 Pro Ultra Review - RTINGS.com",
            "site": "RTINGS.com"
          },
          {
            "position": 2,
            "url": "https://us.mova.tech/products/mova-p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
            "label": "MOVA P50 Pro Ultra Robot Vacuum and Mop Combo | MOVA US",
            "site": "MOVA-US"
          },
          {
            "position": 3,
            "url": "https://www.idealhome.co.uk/house-manual/floorcare/mova-p50-pro-ultra-robot-vacuum-review?utm_source=chatgpt.com",
            "label": "I've spent years telling people that robot mops aren't worth the money - the MOVA P50 Pro Ultra is the first one to change my mind",
            "site": "Ideal Home",
            "description": "The review provides a detailed assessment of the MOVA P50 Pro Ultra Robot Vacuum, marking a pivotal shift in the author's long-standing skepticism toward robot mops. …"
          },
          "…"
        ],
        "images": [],
        "complete": true
      },
      "…"
    ]
  }
}
task.statusstring
依次为 QUEUED、PROCESSING，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。
response.textstring
纯文本形式的回答。
response.entityDetailsarray
每张卡片一个详情面板，最多 20 个：name、category、query、status（ok 或 failed）、markdown、sources、products、images 和 complete。失败的卡片带有 error，回答照常完成。
response.followUpsarray
每个追问对应一个回答，按发送顺序排列。每项包含发送的 prompt、select 时点击的按钮和所选值 selection，以及与第一个回答相同的字段，如 text、markdown、sources、searchQueries 和 model。

获取结果

请求会立即返回 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"

错误

VALIDATION_ERRORHTTP 422
include.entityDetails 发送给了 CHATGPT 以外的引擎、与 include.html 一起发送，或者值不是 boolean。details 会指明 payload.include.entityDetails。
MISSING_API_KEYHTTP 401
缺少 Authorization 请求头，或密钥有误、已过期或已吊销。
INSUFFICIENT_CREDITSHTTP 402
余额低于任务价格。充值积分或升级套餐后再发送。

价格

卡片详情免费。开启 include.entityDetails 后 ChatGPT 任务价格不变：每个回答 1 积分，追问的每个回答也一样。

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅