# 创作者搜索、受众、报价与表现

用 KOL 扩展包在抖音和小红书上做明确的创作者研究。

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

## 启用并连接

在控制台为你的 Key 启用 KOL。MCP 连接地址加上 packs=kol，核心内容工具仍然可用。每次 KOL 调用单独计价，使用同一个钱包。

## 当前可用性

抖音 kol_search：因上游供给故障暂时不可用，调用不计费。其他 KOL 操作保持各自标注的可用状态。

抖音 kol_profile：因上游供给故障暂时不可用，调用不计费。其他 KOL 操作保持各自标注的可用状态。

## 选定创作者后继续

用 platform=douyin 或 xiaohongshu 和 query 调用 kol_search。把结果的 id 复制到 user，用于 kol_profile、kol_audience、kol_pricing 或 kol_performance。如需核心的 user_profile 或 user_posts，请使用返回的主页链接，不要根据昵称猜测。

搜索返回一个原生页。下一页请带上 page.cursor 并保持参数不变。小红书的稀疏页或空页仍可能有后续。动态筛选值必须来自经过核实的平台选项。

## 搜索前先查筛选值

用 platform 和 operation=kol_search 调用 capabilities，可列出可用的筛选字段；再加上 field 和可选的 query 查找选项。每个条目给出 label 和 filters，请有意识地合并到下一次 kol_search 输入中。查找免费，不会发起搜索或供应商请求。

继续查看时，用相同的 catalog_version 和 query 传入 next_offset。如果目录版本变了，从 offset 0 重新开始。响应里的 observed_at 表示这是一个已发布快照，不保证每个选项仍能匹配到创作者。付费调用前请检查 search_available。部分字典尚未映射；活动列表为空表示没有已发布的选项。

HTTP 需要 capabilities 和 kol 两个权限。MCP 还需要 packs=kol，并且该平台没有被这条连接排除。添加 URL 设置不会授予权限。

```
{
  "platform": "xiaohongshu",
  "operation": "kol_search",
  "field": "blogger.content_tag",
  "query": "美妆"
}
```

## 带着限制读受众数据

kol_audience 默认 population=followers。抖音还支持 population=audience，但源端没有说明这一人群的统计口径，不要把它理解为视频观众或触达人数。小红书只支持粉丝。

抖音返回原生分桶数量；小红书返回 0 到 1 的比例。分母和覆盖范围未说明。源数据日期保留原生精度，可能缺失；获取时间不是统计窗口。

## 读取公开的合作报价

kol_pricing 返回 profile_card，报价按内容形式放在 platform_extra.quotes 中，金额为每条内容的人民币价格。缺失、为 0 或隐藏的金额表示不可得，不是免费。抖音提供已核实的 21–60 秒和 60 秒以上字段，1–20 秒报价不可得；小红书提供图文和视频两种形式。

公开报价不保证可以预约，也不含最终税费和平台费用，报价生效日期不可得。失败调用不扣费；确认的空结果按公开价格计费。HTTP 参数相同时复用幂等键，会重放原始结果和价格。

## 读取内容表现

kol_performance 读取一位创作者在一个时间窗口内的数据：time_range_days=30（默认）或 90。小红书还接受 scope=daily|sponsored、content_type=all|image|video 和 traffic=all|organic，默认分别为 daily、all、all；抖音不接受这些筛选。每次调用发起一次供应商请求，没有翻页。

返回的 profile_card 使用固定的表现卡标题，不是创作者昵称。请结合 statistic、unit 和 source_field 读取 platform_extra.metrics。均值和中位数是不同的统计量。native_units_unspecified 的数值不是经过核实的次数、百分比或秒数，不要换算，也不要跨平台比较。缺失的指标表示不可得，不是 0。

sample_counts 描述源端的总体；小红书的 samples 只包含源端选取的笔记。返回日期使用精确到天的 published_on，只有源端标记可访问时才提供链接。窗口的确切边界和数据更新时间不可得。创作者通过请求回显绑定，业务数据中没有独立的身份确认。确认的空结果计费，失败免费。

## 研究关键词需求

keyword_index 属于 KOL 扩展包。使用 platform=xiaohongshu、query 和 mode=overview|daily|related（默认 overview）。每种模式都是一次单独计费的调用。抖音关键词数据暂不可用，返回 not_supported 且不扣费。相关词不会被自动查询。

每种模式返回一个 item，platform_extra.card_type=keyword_index。overview 提供指标和源端创作者分布；change_30d_percent 是带符号的周期对比。搜索指数不是搜索次数。数值为 0 不代表需求为 0，也不代表统计完整。创作者分桶可能重叠、合计不一定为 100%；价格带单位未经核实。

daily 的数据点保留源端日历日期和缺失值，不补空、不臆造时区。窗口由源端选择；observed_start 和 observed_end 是返回的边界，不是日期筛选。related 保留搜索前后方向和可用的源端排名。下结论前请先比较指标单位和限制。确认的空结果计费，失败免费。

```
{
  "platform": "xiaohongshu",
  "query": "coffee",
  "mode": "daily"
}
```

## API 价格

价格版本：standard-2026-09-08-12ebeeeacfa39f97。

| 平台 | 操作 | Credits | 可用性 |
|---|---|---|---|
| 小红书 | kol_search | 2.9 | 可用 |
| 小红书 | kol_profile | 2.9 | 可用 |
| 小红书 | kol_audience | 2.9 | 可用 |
| 小红书 | kol_pricing | 2.9 | 可用 |
| 小红书 | kol_performance | 2.9 | 可用 |
| 小红书 | keyword_index | 2.9 | 可用 |
| 抖音 | kol_search | 0.2 | 暂时不可用，调用不扣费 |
| 抖音 | kol_profile | 0.2 | 暂时不可用，调用不扣费 |
| 抖音 | kol_audience | 0.3 | 可用 |
| 抖音 | kol_pricing | 0.3 | 可用 |
| 抖音 | kol_performance | 0.2 | 可用 |

[下载完整 OpenAPI →](https://socialtoai.com/openapi.json)