# 品牌口碑（brand_buzz）

POST /v1/tools/brand_buzz 运行品牌口碑：一个现成工具，返回各平台上大家怎么评价一个品牌或产品：态度占比、提到最多的事、互动最高的帖子，每条都带来源链接。目前可读 16 个平台，16 积分起。带上 max_cost_credits，超出时会被免费拒绝，并返回报价。什么都没取到，不扣。

- 页面：https://socialtoai.com/zh/docs/tools/brand-buzz/
- 最近更新：2026-10-17

- POST: `https://api.socialtoai.com/v1/tools/brand_buzz`

想在网站上填写，或看看结果长什么样，打开[品牌口碑](https://socialtoai.com/zh/tools/brand-buzz.md)。

## 请求

请求体是 JSON，放这个工具自己的输入。Key 和其他调用一样，放在 `Authorization` 请求头里。

| 名称 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `brand` | string | 是 | 品牌、产品或话题的名字。 |
| `about` | string | 否 | 一句话说明它是什么，用来排除同名的东西。 |
| `compare_with` | string[] | 否 | 竞品名，最多 2 个；每个按同样的计划单独计价。 |
| `platforms` | string[] | 否 | 1 到 5 个平台。不填时按名字的语言取常用的三个（以当时开放的为准），返回里写明取了哪些。 |
| `window` | string | 否 | 看最近多久。取值：`7d`、`30d`、`90d`（默认 `30d`）. |
| `scale` | string | 否 | small 每平台至多 40 帖、不读评论；medium 约 100 帖加 6 帖各 2 页评论；large 约 200 帖加 15 帖各 3 页评论。取值：`small`、`medium`、`large`（默认 `small`）. |
| `max_cost_credits` | integer | 否 | 这次最多花多少积分；超出则免费拒绝并返回报价。 |
| `confirm` | boolean | 否 | true：不论多少积分都直接运行。false：只返回计划和报价，不运行。不填：价格高的和要在后台运行的先返回报价，其余直接运行。 |

**cURL**

```
curl https://api.socialtoai.com/v1/tools/brand_buzz \
  -H "Authorization: Bearer $SOCIALTOAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": "Notion",
    "platforms": ["tiktok"],
    "window": "30d",
    "scale": "small"
  }'
```

**Python**

```
import os
import requests

response = requests.post(
    "https://api.socialtoai.com/v1/tools/brand_buzz",
    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},
    json={
        "brand": "Notion",
        "platforms": ["tiktok"],
        "window": "30d",
        "scale": "small",
    },
)
print(response.json())
```

## 档位与积分

`scale` 选档位。同一档位在每个平台上是一个固定价格，运行前就会给出。

| 档位 | scale | 读多少 | 几积分起 | 怎么运行 | 用赠送的 100 积分 |
| --- | --- | --- | --- | --- | --- |
| 快速 | `small` | 每个平台至多 40 帖，不读评论。 | 16 | 当场出结果 | 可以 |
| 中 | `medium` | 每个平台约 100 帖，另读其中 6 帖各 2 页评论。 | 76 | 当场出结果 | 部分平台可以（6/13） |
| 大 | `large` | 每个平台约 200 帖，另读其中 15 帖各 3 页评论。 | 210 | 部分平台在后台运行 | 购买后可用 |

## 各平台的积分

下表是一个名字、一个平台的积分。选了几个平台就加起来；每多对比一个名字，再加一份。

| 平台 | 快速 | 中 | 大 |
| --- | --- | --- | --- |
| TikTok | 16 | 140 | 440 |
| Instagram | 16 | 92 | 254 |
| X | 16 | 124 | 368 |
| Reddit | 20 | 76 | 210 |
| YouTube | 16 | 100 | 284 |
| LinkedIn | 20 | — | — |
| Threads | 16 | — | — |
| Pinterest | 16 | — | — |
| 小红书 | 36 | 258 | 780 |
| 抖音 | 60 | 180 | 420 |
| 微博 | 20 | 100 | 282 |
| 公众号 | 36 | 270 | 834 |
| B 站 | 16 | 100 | 284 |
| 知乎 | 18 | 90 | 234 |
| 快手 | 60 | 210 | 540 |
| 视频号 | 60 | 306 | 906 |

## 结果里有什么

| 部分 | 内容 |
| --- | --- |
| 各平台的态度占比 | 每个平台上正面、中性、负面帖子的占比，以及读了多少帖。 |
| 提到最多的事 | 大家提得最多的几件事，各自占帖子的比例，并附原话。 |
| 互动最高的帖子 | 互动最高的帖子，带各项数字和来源链接。 |
| 主要数字 | 相关帖子条数 |

## 先报价还是直接运行：confirm

同一个请求，要么直接运行，要么先返回报价。和工具输入放在一起的布尔参数 `confirm` 决定走哪一种：

| confirm | 返回什么 |
| --- | --- |
| `false` | 总是返回报价。免费：不占用、不取数、不扣积分。 |
| 不带 | 价格不超过 100 积分、并且能在这次请求里答完时，直接运行。超过这个数，或者计划要在后台运行（`quote.mode` 是 `background`）时，先返回报价。 |
| `true` | 直接运行，最多扣报价里写的积分。跑不了的运行会被免费拒绝（`not_supported`），不会用一份你没要的报价来代替。 |

运行的返回里带一个 `handle`：24 小时内可以凭它免费重读完整结果，细节见[结果与句柄](https://socialtoai.com/zh/docs/api/results.md)。带着同一个 `Idempotency-Key` 再发同样的请求，返回的是第一次运行的结果，不再扣费。

## 报价

报价是这一次请求的完整计划，以及运行它最多扣多少。报价本身不占用、不取数、不扣积分，`status` 是 `quote`。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `request_id` | string | 这次请求的编号。 |
| `schema_version` | "v1" | 返回格式的版本。 |
| `tool` | string | 报价对应的工具。 |
| `scale` | "small" \| "medium" \| "large" \| null | 报价对应的档位；按行计价的工具为 `null`。 |
| `status` | "quote" | `quote`：没有占用、没有取数、没有扣积分。 |
| `quote.credits` | integer | 这次运行最多扣多少积分。 |
| `quote.parts.data_first` | integer | 取数价格的前半段。 |
| `quote.parts.data_second` | integer | 取数价格的后半段。读到的不到计划的一半时不扣。 |
| `quote.parts.analysis` | integer | AI 分析的价格。交付的内容里至少九成分析成功才扣。 |
| `quote.mode` | "sync" \| "background" | `sync`：在这次请求里返回结果。`background`：先返回句柄，在后台分批运行。 |
| `quote.waves` | integer | 后台运行分几波；在请求里直接返回的为 1。 |
| `quote.estimated_seconds` | integer | 预计耗时（秒）。 |
| `quote.free_tier.runnable` | boolean | 还没买过积分的账户能不能跑。 |
| `quote.free_tier.reasons` | string[] | 不能跑时的原因：`cost`、`duration` 或 `paid_only`。 |
| `quote.plan` | array | 按运行顺序列出每一步：平台、动作、多少个目标和多少页，或多少批分析，以及这一步的积分。 |
| `quote.price_version` | string | 报价所依据的价格版本。 |
| `billing` | object | 和每个返回里的一样，见[积分与计费](https://socialtoai.com/zh/docs/credits-and-billing.md)。 |

## 运行怎么扣费

- **先看到价格**：运行前就给出总价，内容再多也不会涨。
- **什么都没取到，不扣**：什么都没取到，这次不扣积分。中途停下，只按完成的部分扣。
- **每档一个价**：同一档位在同一平台价格固定，内容比预想的少也不会减。先用小档，需要读得更多再加。
- 什么都没取到，不扣。取到了内容但被你设的条件筛光，只扣取数的前半段。中途停下只按完成的部分扣。
- 工具会用读到的部分继续跑，结果里写明读到了计划的多少。价格分三段：两段取数，一段 AI 分析。读到的不到计划的一半时，取数的后半段不扣；交付的内容里至少九成分析成功，分析那一段才扣。结果不确定的调用，我们不会自动重试。

## 通过 MCP

MCP 工具是 `brand_buzz`。输入和积分都一样。[工具列表](https://socialtoai.com/zh/docs/mcp/tools.md) 里有你的 AI 拿到的描述。