回答分析：品牌提及、排名、情感与来源类型

将 payload.include.analysis 设为 true，任务会在回答旁返回以下内容：回答按顺序提到的每个品牌，回答是否推荐每个品牌以及对它的态度，你的品牌和竞争对手是否出现，以及每个引用来源是哪类网站。无需对回答运行自己的模型，就能据此算出提及率、平均排名、情感、声量份额和来源份额。

请求

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": "best CRM for a small team",
      "country": "US",
      "include": { "analysis": true },
      "brand": "Acme CRM",
      "brandAliases": ["Acme"],
      "brandDomains": ["acme-crm.example"],
      "competitors": ["Northwind", { "name": "Contoso CRM", "aliases": ["Contoso"], "domains": ["contoso-crm.example"] }]
    }
  }'

字段	必填	说明
`include.analysis`	是	设为 `true` 以运行分析。
`brand`	否	你的品牌名，最多 200 个字符。不能是 URL：网站请放在 `brandDomains` 中。
`brandAliases`	否	品牌的其他名称，最多 20 个。只能与 `brand` 一起发送。
`brandDomains`	否	最多 20 个网站，例如 `acme-crm.example`。引用该网站或其子域名即视为你的来源。只能与 `brand` 一起发送。
`competitors`	否	最多 50 个竞争对手。每个是一个名称，或 `{ name, aliases, domains }`，别名和域名各最多 20 个。

每个名称至少需要两个字符，或带有至少两个字符的别名。不发送 brand 和 competitors 时，分析仍会列出回答提到的每个品牌。

支持的引擎

CHATGPT、GEMINI、PERPLEXITY、GOOGLE、AIMODE、NAVER_AI_BRIEF 和 NAVER_AI_TAB（及其别名）。在带有 followUps 的 CHATGPT 任务上，分析读取第一个回答。

积分

分析在引擎价格之外，每个任务另收 1 积分。任务在提交时预留这 1 积分，仅在 analysis.status 为 ok 时扣费。见积分与限制。

响应

任务的 response 会多出一个 analysis 对象。例如：

{
  "analysis": {
    "version": 1,
    "status": "ok",
    "brands": [
      { "name": "Northwind", "domain": null, "writtenAs": "Northwind", "spellings": ["Northwind"], "rank": 1, "role": "competitor", "recommended": true, "sentiment": "positive", "sentimentScore": 0.9 },
      { "name": "Acme CRM", "domain": "acme-crm.example", "writtenAs": "Acme", "spellings": ["Acme", "Acme CRM"], "rank": 2, "role": "brand", "recommended": true, "sentiment": "positive", "sentimentScore": 0.5 },
      { "name": "Fabrikam", "domain": "fabrikam.example", "writtenAs": "Fabrikam", "spellings": ["Fabrikam"], "rank": 3, "role": null, "recommended": false, "sentiment": "neutral", "sentimentScore": 0 }
    ],
    "targets": [
      { "name": "Acme CRM", "role": "brand", "mentioned": true, "rank": 2, "recommended": true, "sentiment": "positive", "sentimentScore": 0.5, "cited": true },
      { "name": "Northwind", "role": "competitor", "mentioned": true, "rank": 1, "recommended": true, "sentiment": "positive", "sentimentScore": 0.9, "cited": false },
      { "name": "Contoso CRM", "role": "competitor", "mentioned": false, "rank": null, "recommended": null, "sentiment": null, "sentimentScore": null, "cited": false }
    ],
    "sources": [
      { "position": 1, "url": "https://www.acme-crm.example/pricing", "domain": "acme-crm.example", "kind": "owned", "brand": "Acme CRM" },
      { "position": 2, "url": "https://www.g2.com/categories/crm", "domain": "g2.com", "kind": "reviews", "brand": null }
    ]
  }
}

字段	说明
`status`	`ok`、`no_answer` 或 `failed`。见状态。
`brands`	回答提到的每个品牌，按首次提及的顺序排列。产品计入其制造商，因此 “MacBook Air” 给出 Apple 的排名。`rank` 从 1 开始。你发送的品牌 `role` 为 `brand` 或 `competitor`，其余为 `null`。
`brands[].name`, `domain`, `writtenAs`, `spellings`	你发送的品牌和竞争对手，`name` 是你发送的名称。其他品牌的 `name` 在任何语言中都相同，是品牌官方的拉丁字母名称，没有时为原名。마켓컬리 和 컬리 都是 `Kurly`。`domain` 是品牌的网站：你发送的第一个域名、为该品牌找到的网站，或 `null`。`spellings` 按首次出现的顺序列出回答写出该品牌名称的每种写法，例如 Baemin 包含 배민 和 배달의민족。名称后面的产品名或说明不属于写法。`writtenAs` 是其中第一种写法。
`targets`	你发送的品牌，按你的顺序排列，各自带有 `mentioned` 和它在 `brands` 中的 `rank`。有引用落在其域名上时 `cited` 为 `true`；未发送域名时为 `false`。
`recommended`	回答推荐该品牌，或将其作为好的选择。
`sentiment`、`sentimentScore`	回答对该品牌的态度，分五级，分值为 0.9、0.5、0、-0.5 和 -0.9。对其他品牌的赞扬或批评不计入，推荐或警告比顺带的评论更重要。
`sources[].kind`	`owned` 和 `competitor` 由你发送的域名决定。已知网站按固定列表归类：`editorial`（新闻和杂志）、`review_media`（产品测试和评测媒体）、`pr_wire`、`reviews`（用户点评平台）、`commerce`、`social`（社交网络）、`blog`（博客平台）、`community`（论坛、问答和维基）、`video`、`institution`（政府和学术机构）。其他网站由模型分类一次并复用结果：`brand`（企业官网）、`content`（独立网站或个人博客），或上述类型之一。`other` 用于都不符合的网站（如搜索引擎和工具）或无法分类的网站。

判定方式

哪些名称是品牌、其中哪个是你的品牌、recommended 和 sentiment 由模型判定。位置、排名、名称匹配和来源类型由规则计算，因此同样的模型判定得到同样的结果。
你的品牌和竞争对手按名称和别名查找，规则与监测器相同：拉丁字母按整词匹配，韩文、日文、中文和泰文在任意位置匹配，不在引用链接内查找。模型还会关联它发现的其他写法。确认为品牌本身名称的写法（例如 Kurly 的 컬리）会被保存，之后的回答按规则匹配。回答中没有的名称不会被报告。
名称匹配但模型在此回答中未将其视为品牌时（常见词用于其他含义），该品牌仍会列出，recommended、sentiment 和 sentimentScore 为 null。
对于你未发送的品牌，任何回答第一次写出某种写法时，由模型确定名称，此后所有回答都沿用该名称和网站。已用被引用网站或相似写法确定名称的品牌会一并提供给模型，因此分店或其他文字的写法也会得到同一名称。无法确定名称时，品牌保留回答中的写法，domain 为 null。
一个网站对应一个品牌。以同一网站确定名称的品牌只出现一次，使用网站自身的名称(如 baemin.com 的 Baemin)，没有时使用该网站最先确定的名称，因此 아임웹 和 I’mweb 是同一品牌。在你发送的品牌的网站上找到的品牌就是该品牌。博客、社区、视频和社交平台上的帖子不会关联到你未发送的品牌，即使是该品牌自己的平台，例如 NAVER 的 blog.naver.com。
模型判断不是品牌的名称(如普通名词、地点或疗程名称)不会列出。回答写成一个名称的多个品牌(如“마켓컬리, 오아시스마켓, SSG닷컴”)按各自的品牌计算，名称后面的描述不算作名称的一部分。
模型读取回答的前 40,000 个字符。之后才首次出现的品牌不会被报告。
分析会让任务晚几秒完成。

状态

`status`	含义	是否收费
`ok`	分析已运行。	1 积分
`no_answer`	引擎完成但没有回答文本，例如没有 AI 概览的 Google 搜索。你发送的所有品牌均为未提及。	否
`failed`	分析无法运行。`error` 为 `ANALYSIS_FAILED`、`ANALYSIS_TIMEOUT` 或 `ANALYSIS_UNAVAILABLE`。任务仍会带着回答完成。	否

错误

状态码	代码	何时出现
`422`	`VALIDATION_ERROR`	`include.analysis` 不是布尔值、引擎不支持分析，或 `brand`、`brandAliases`、`brandDomains`、`competitors` 违反上述规则。`details[].field` 指出相应字段。

快速开始

核心概念

回答引擎

搜索与网页数据

请求选项

研究

GEO 监测

账户与数据

回答分析：品牌提及、排名、情感与来源类型

请求

支持的引擎

积分

响应

判定方式

状态

错误

相关内容

​请求

​支持的引擎

​积分

​响应

​判定方式

​状态

​错误

​相关内容

请求

支持的引擎

积分

响应

判定方式

状态

错误

相关内容