> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 在回答任务中添加 include.analysis，即可获得回答提到的每个品牌、回答对每个品牌的态度，以及每个引用来源是哪类网站。

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

## 请求

```bash theme={"theme":"css-variables"}
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` 时扣费。见[积分与限制](/zh/concepts/credits-and-limits.md)。

## 响应

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

```json theme={"theme":"css-variables"}
{
  "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` 由模型判定。位置、排名、名称匹配和来源类型由规则计算，因此同样的模型判定得到同样的结果。
* 你的品牌和竞争对手按名称和别名查找，规则与[监测器](/zh/monitors.md#名称如何匹配)相同：拉丁字母按整词匹配，韩文、日文、中文和泰文在任意位置匹配，不在引用链接内查找。模型还会关联它发现的其他写法。确认为品牌本身名称的写法（例如 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` 指出相应字段。 |

## 相关内容

* [Markdown 与原始响应](/zh/engines/response-options.md)
* [GEO 监测](/zh/monitors.md)：按计划运行同样的分析。
* [引擎概览](/zh/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.