按数据类型找接口
达人详情接口
2 个平台的 2 个接口，用同一个 Creator 对象返回达人详情。某位达人在平台达人广场上的资料：粉丝数、阅读或播放中位数、互动中位数、内容标签，以及公开的合作报价。每次 $0.004 到 $0.04，各接口按自己的价格计费；失败的调用不扣费。
达人详情 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 小红书 | 小红书蒲公英达人详情 | GET /v1/xiaohongshu/pgy/creators/get | 1 | $0.04/次 |
| 抖音 | 抖音星图达人资料 | GET /v1/douyin/xingtu/creators/get | 1 | $0.004/次 |
每次 $0.004 到 $0.04，各接口按自己的价格计费。失败的调用不扣费。
返回的对象: Creator
上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。
| 字段 | 类型 | 含义 |
|---|---|---|
id | string | 达人广场里的达人 ID，其他达人广场接口用它。 |
url | string | 达人在达人广场的主页。 |
account_id | string | null | 达人在平台上的账号 ID（达人广场给出时）：抖音是 douyin.users.get 用的 sec_uid（MS4w 开头），小红书是用户 ID。 |
username | string | null | 平台上的用户名或号（有的话）。 |
name | string | 昵称。 |
avatar_url | string | null | 头像图片地址。 |
location | string | null | 达人所在地。 |
gender | string | null | 达人广场标注的性别。 |
followers | integer | null | 粉丝数。 |
categories | string[] | null | 达人广场的内容类目，平台原文。 |
engagement_rate | number | null | 近期作品的互动率，0 到 1（0.038 即 3.8%）。 |
median_views | integer | null | 近期日常作品的播放或阅读中位数。 |
median_engagements | integer | null | 近期日常作品的互动中位数（赞、评、藏、转）。 |
rates | Rate[] | null | 公开的合作报价；达人广场不展示时为 null。 |
ext | object | 平台特有字段，只在 view=full 时返回。 |
两个平台上的同一个调用
参数一样、翻页方式一样、返回结构一样，只换路径。
# 小红书
curl -G "https://api.okdata.online/v1/xiaohongshu/pgy/creators/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=5dfa1ee20000000001001cb3'
# 抖音
curl -G "https://api.okdata.online/v1/douyin/xingtu/creators/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=6763236383382306828'常见用途
- 下单前刷新候选达人的数据。
- 看达人图文和视频的报价。
常见问题
- 用哪个 ID？
- 达人广场自己的达人 ID，来自达人搜索。它和达人在平台上的账号 ID 不是一回事，后者在 account_id 里单独返回。
- 中位数是怎么算的？
- 按达人广场的口径，统计的是近期的日常作品。中位数比平均数更能代表一条普通作品的水平，平均数很容易被一条爆款拉高。
- 支持哪些达人广场？
- 接口按达人广场逐个上线，现在能调用的都列在上面的表里。达人搜索的结果里已经有大部分同样的字段。