更新日志改进

查看品牌在 AI 回答中掉队的环节

Citation Analysis
Citation Analysis 结果：Coway 第 1，目标品牌 Blueair 第 2，Levoit 第 3，以及两项行动：改进 Blueair 自有页面和它在 Target 的商品页

Citation Analysis 现在会展示 AI 回答参考了哪些页面、你的品牌处在什么位置，以及从自有网站开始的行动建议。

更新内容

  • queries：引擎执行的搜索，以及每次搜索找到的页面。
  • sources：引擎检索到的每个页面。用 cited 区分是否被引用，并附搜索 position、引擎报告引用的段落、页面提到的品牌，以及说明页面由谁掌控的 channel（自有网站、其他品牌、媒体、电商、评测平台、社区、视频、社交、博客平台、百科）。
  • brands：你的品牌、竞品以及回答提到的所有品牌，按回答中出现的顺序排列，并关联提到它们的引用页面和检索页面。
  • visibility：你的品牌到达的阶段，从在回答中被提到，到我们读取的页面中都没有出现。
  • actions：按你能掌控的程度排列：先是自有页面，其次是你能发布内容的平台，最后是联系媒体。每条都附具体的 steps 和依据的页面。
  • insights：被引用页面的共同点（渠道、形式、时效、比较标准）以及你的品牌所处位置，并标明依据的页面和链接。

POST /v1/citation-analysis 的响应现在包含 version: 4 和以上新字段。links 结构不变，每条洞察在 linkIds 之外新增依据页面 sourceIds。此前保存的结果保持保存时的结构。产品现更名为 Citation Analysis。/v1/source-influence 和 /v1/geo-audit、taskType SOURCE_INFLUENCE 和 GEO_AUDIT，以及 include.sourceInfluence 和 include.geoAudit 仍可使用，响应中使用 /v1/citation-analysis、CITATION_ANALYSIS 和 citationAnalysis。

工作原理

发送 taskId 时，如果引擎公开了搜索词和检索页面（ChatGPT、Google AI Overview），会直接从回答任务中读取。你也可以通过 queries 和 cited: false 的 citations 自行提交。其他引擎只包含被引用的页面。

推荐大多来自第三方页面。在我们研究的 ChatGPT 回答中，引擎检索页面的中位数为 20 个、引用 3 个，被推荐品牌的官网只有 16% 被检索到、6.8% 被引用。行动建议沿着这条路径，从你能直接做的事开始排列：

  • improve_page：被检索到却被略过的自有页面，或被引用但回答没有提到你品牌的自有页面。说明要补充什么，才能像被引用页面一样回答这个问题。
  • publish_page：针对没有自有页面被引用的搜索，以被引用页面为范本的新页面方案，包括页面类型、标题模式、栏目、要展示的依据和日期。
  • post_on_platform：出现竞品的电商、评测平台、社区、视频或社交页面，附完善商品信息、邀请真实客户评价、以品牌代表身份回答等步骤。
  • pitch_publisher：只有媒体自己能修改的被引用文章，说明要向媒体发送什么。

每个对应关系都标明哪个页面写了回答中的内容，每条行动都准确指向依据的页面。not_found 表示我们读取的页面中没有出现你的品牌。发送 brand 即可获得 visibility 和 actions，再加上 brandDomains 和 brandAliases，自有页面和其他名称也会计入。

应用场景

  • 先从自有网站做起：修改被引擎略过的页面，或以被引用页面为范本策划新页面。
  • 把出现竞品的商品页和社区帖子交给电商和社区团队。
  • 以回答采用的页面和段落为依据，向媒体提出建议。

发送请求

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

curl -X POST https://api.querying.ai/v1/citation-analysis \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "…",
    "brand": "Blueair",
    "competitors": ["Coway", "Levoit"],
    "brandDomains": ["blueair.com"]
  }'

请求字段

taskIdstring必填
你已完成的回答任务 ID。其回答和引用页面会作为 answer 和 citations。
brandstring
你的品牌名称。发送后结果会增加 visibility 和 actions。
competitorsarray
要在回答及其页面中追踪的竞品名称。
brandDomainsarray
你自有网站的主机名，最多 10 个，例如 coway.com。其页面会标记为 own。
brandAliasesarray
品牌的其他名称，最多 10 个，例如产品线或本地拼写。
citations[].citedboolean
默认 true。引擎检索到但未引用的页面发送 false，如有可附上 position 和 query。
countrystring
读取引用页面所用的国家。默认 US。
webhook.urlstring
你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。
idempotencyKeystring
你为请求设定的 ID。每个键在账户内对应一个任务，因此重试发送后仍是同一个任务。

响应

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

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "CITATION_ANALYSIS",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": "…", "creditsCharged": "…" },
  "response": {
    "version": 4,
    "answer": "The best-reviewed air purifiers depend on whether you …",
    "queries": [
      {
        "id": "q0",
        "text": "best air purifiers 2026 reviews independent testing …",
        "sourceIds": ["s0", "s1", "s2", "…", "s20"]
      }
    ],
    "sources": [
      {
        "id": "s13",
        "url": "https://www.blueair.com/products/blue-pure-211i-max",
        "domain": "blueair.com",
        "channel": "own",
        "cited": false,
        "position": 14,
        "queryIds": ["q0"],
        "publishedAt": null,
        "citedText": [],
        "brandIds": ["b0"],
        "own": true,
        "paragraphs": []
      },
      {
        "id": "s14",
        "url": "https://www.target.com/p/levoit-core-300-air-…",
        "domain": "target.com",
        "channel": "retailer",
        "cited": true,
        "position": 15,
        "queryIds": ["q0"],
        "publishedAt": null,
        "citedText": [
          "A compact, straightforward option with a 4.6/5 rating …"
        ],
        "brandIds": ["b2"],
        "own": false,
        "paragraphs": [
          {
            "id": "s14p1",
            "text": "Levoit Core 300 Air Purifier White … $99.99 …"
          }
        ]
      },
      "…"
    ],
    "brands": [
      {
        "id": "b0",
        "name": "Blueair",
        "role": "target",
        "rank": 2,
        "answerRanges": ["…"],
        "citedSourceIds": ["s1", "s3", "s11"],
        "retrievedSourceIds": ["s5", "s6", "s8", "s9", "s13"],
        "ownSourceIds": ["s11", "s13"]
      },
      {
        "id": "b1",
        "name": "Coway",
        "role": "competitor",
        "rank": 1,
        "answerRanges": ["…"],
        "citedSourceIds": ["s1", "s3", "s4", "s7"],
        "retrievedSourceIds": ["s0", "s5", "s6", "s9", "s10", "s18"],
        "ownSourceIds": []
      },
      {
        "id": "b2",
        "name": "Levoit",
        "role": "competitor",
        "rank": 3,
        "answerRanges": ["…"],
        "citedSourceIds": ["s3", "s7", "s14"],
        "retrievedSourceIds": ["s6", "s15", "s16"],
        "ownSourceIds": []
      },
      "…"
    ],
    "links": [
      {
        "id": "l40",
        "paragraphId": "s14p1",
        "answerRanges": ["…"],
        "explanation": "Lists the Levoit Core 300 at $99.99, …"
      },
      "…"
    ],
    "visibility": {
      "brandId": "b0",
      "stage": "mentioned",
      "rank": 2,
      "answerBrands": 5
    },
    "actions": [
      {
        "id": "a0",
        "type": "improve_page",
        "control": "owned",
        "priority": 1,
        "summary": "Update Blueair’s site with a current, …",
        "steps": [
          "Add a page on best air purifiers in 2026 that covers …",
          "Include Blueair models in direct comparisons using published …",
          "…"
        ],
        "sourceIds": ["s13"],
        "brandIds": ["b0"],
        "queryIds": ["q0"],
        "linkIds": []
      },
      {
        "id": "a1",
        "type": "post_on_platform",
        "control": "platform",
        "priority": 2,
        "summary": "Improve Blueair’s Target product listing with …",
        "steps": [
          "Ensure the Blueair listing clearly states the model, current …",
          "…",
          "Keep product details current and invite genuine purchasers to …"
        ],
        "sourceIds": ["s14"],
        "brandIds": ["b2"],
        "queryIds": ["q0"],
        "linkIds": ["l40"]
      },
      "…"
    ],
    "insights": [
      {
        "summary": "Blueair’s second-place position is reflected in …",
        "sourceIds": ["s1", "s3", "s11"],
        "linkIds": ["l1", "l12", "l36"]
      },
      "…"
    ]
  }
}
task.statusstring
依次为 QUEUED、PROCESSING，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。
credits.creditsChargedinteger
已完成任务扣除的积分。失败的任务为 0。
response.versionnumber
结果格式。包含搜索词、检索页面、品牌和行动建议的分析为 4。
response.answerstring
你提交的回答原文。区间是这段文本的 UTF-16 偏移量。
response.queriesarray
引擎执行的搜索，每条含 id、搜索词 text 以及由它找到的 sourceIds。
response.sourcesarray
引擎检索到的每个页面。用 cited 区分是否被引用，channel 说明页面由谁掌控（own、brand、editorial、retailer、review_platform、community、video、social、blog_platform 或 reference）。另附 position、queryIds、citedText、brandIds 和 own。被引用的页面带有 paragraphs。
response.brandsarray
你的品牌、竞品以及回答提到的品牌，每个含 role、在回答中的 rank、answerRanges，以及提到它的引用页面和检索页面。
response.linksarray
每个链接把一个段落与其对应的 answerRanges 以及一句话的 explanation 配对。
response.visibilityobject
你的品牌走到了哪一步：stage 为 mentioned、on_cited_page、on_retrieved_page 或 not_found，并附 rank 和 answerBrands。未发送 brand 时为 null。
response.actionsarray
按 priority 排列的行动：先是在自有网站上完成的 owned（improve_page、publish_page），其次是在平台上发布的 platform（post_on_platform），最后是联系媒体的 outreach（pitch_publisher）。每条含 control、summary、1 到 5 条 steps，以及依据的来源、品牌、搜索词和链接。未发送 brand 时为空。
response.insightsarray
对被引用页面的共同点和你的品牌所处位置的简短解读，最多 4 条，各用 sourceIds 标明依据的页面、用 linkIds 标明依据的链接。

获取结果

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

价格

价格保持不变：分析开始时预留积分，完成时结算。

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅