品牌口碑（brand_buzz）

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

想在网站上填写，或看看结果长什么样，打开品牌口碑。

请求

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

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"  }'

import osimport requestsresponse = 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 选档位。同一档位在每个平台上是一个固定价格，运行前就会给出。

各平台的积分

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

结果里有什么

先报价还是直接运行：confirm

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

运行的返回里带一个 handle：24 小时内可以凭它免费重读完整结果，细节见结果与句柄。带着同一个 Idempotency-Key 再发同样的请求，返回的是第一次运行的结果，不再扣费。

报价

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

运行怎么扣费

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

通过 MCP

MCP 工具是 brand_buzz。输入和积分都一样。工具列表 里有你的 AI 拿到的描述。

最近更新：2026-10-17