# 内容趋势、品牌与创作者对比

以明确的时间窗口、身份和价格研究抖音源端指数。

规范地址: https://socialtoai.com/zh/docs/index/

## 启用指数研究

为你的 Key 启用 Index，MCP 加上 packs=index。三个工具目前都支持抖音。每种模式都是一次明确调用；日期查找、身份查找和翻页都不会暗中产生额外调用。

## 找到分类和可用日期

content_trends 的模式：categories、dates、keywords、keyword_items、topics、publish、interaction 和 consumption。先用 categories 和 dates，再把返回值用于研究。关键词和话题的周期为 1、3 或 7 天，7 天周期必须以周日结束。topics 接受 rank=index|rise。

趋势窗口包含首尾两天，跨度为 1–90 个自然日，不能是未来日期。缺失的日期和数值保持缺失。源端比率序列保留 native_units_unspecified，不是受众人数，也不是标准化百分比。

```
{
  "platform": "douyin",
  "mode": "categories"
}
```

## 先找到品牌，再查看窗口

brand_radar 的模式：discover、availability、radar、trend、cycle 和 weekly_rank。请使用 discover 返回的准确品牌名；availability 会返回源端支持的日期（如有）。其他模式需要 start_date 和 end_date。weekly_rank 需要恰好 7 天且以周六结束。

品牌指数保留 native_index 单位。周排名是该品牌在类目中的位置，不是完整榜单。原生比率可能为负。不同单位和窗口不能合并成一个分数。

## 使用同一个公开创作者身份

creator_comparison 的 discover 接受 query 和 count=1–20（默认 5）。返回的每个 id 都是公开的抖音 sec_uid，可继续用于 compare、metrics、user_profile 或 user_posts。无法解析的候选会被省略并附带 warning；无法继续使用的源端标识不会作为公开 ID 提供。

compare 接受 2–5 个不同的用户，每个为 sec_uid 或标准的 https://www.douyin.com/user/<sec_uid> 链接，days=7|30（默认 7）。它会先读取每个公开主页一次，再发起一次对比请求。2/3/4/5 人整次分别收费 0.5/0.6/0.8/0.9 credit。返回窗口汇总，不是逐日曲线。源端窗口变化和均值可能为负，累计数不会为负。

metrics 接受一个用户，同时返回源端的周均、月均和比率；没有 days 参数，含一次主页查询共 0.3 credit。compare 和 metrics 所有步骤共享 25 秒时限；discover 为 8 秒、0.2 credit。流程失败全部免费。超时不代表可以自动重试已经发出的请求。

## API 调用价格

每种模式计费一次，包含文档所列的身份查询。重放复用原始结果和价格。Index 权限不包含单独的核心用户工具，那些需要各自授权。

| 平台 | 操作 | Credits | 可用性 |
|---|---|---|---|
| 抖音 | content_trends | 0.2 | 可用 |
| 抖音 | brand_radar | 0.2 | 可用 |
| 抖音 | creator_comparison | discover: 0.2; metrics: 0.3; compare:2: 0.5; compare:3: 0.6; compare:4: 0.8; compare:5: 0.9 | 可用 |

[完整输入 schema →](https://socialtoai.com/openapi.json)