按数据类型找接口
达人粉丝画像接口
2 个平台的 2 个接口，用同一个 Audience 对象返回达人粉丝画像。达人的粉丝都是谁，按达人广场给出的数据：性别、年龄、地域和兴趣分布。每次 $0.004 到 $0.04，各接口按自己的价格计费；失败的调用不扣费。
达人粉丝画像 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | 抖音星图达人粉丝画像 | GET /v1/douyin/xingtu/creators/audience/get | 1 | $0.004/次 |
| 小红书 | 小红书蒲公英达人粉丝画像 | GET /v1/xiaohongshu/pgy/creators/audience/get | 1 | $0.04/次 |
每次 $0.004 到 $0.04，各接口按自己的价格计费。失败的调用不扣费。
返回的对象: Audience
上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。
| 字段 | 类型 | 含义 |
|---|---|---|
creator_id | string | 所查的达人 ID。 |
measured_at | string | null | 数据所属日期，写成中国时间当天零点。 |
gender | AudienceSegment[] | null | 按性别。 |
age | AudienceSegment[] | null | 按年龄段。 |
province | AudienceSegment[] | null | 按省份。 |
city | AudienceSegment[] | null | 按城市，只列占比最高的。 |
interest | AudienceSegment[] | null | 按兴趣。 |
device | AudienceSegment[] | null | 按手机品牌。 |
city_tier | AudienceSegment[] | null | 按城市等级。 |
crowd | AudienceSegment[] | null | 按平台划分的消费人群。 |
purchase_category | AudienceSegment[] | null | 按购买的商品类目。 |
purchase_amount | AudienceSegment[] | null | 按客单价。 |
ext | object | 平台特有字段，只在 view=full 时返回。 |
两个平台上的同一个调用
参数一样、翻页方式一样、返回结构一样，只换路径。
# 抖音
curl -G "https://api.okdata.online/v1/douyin/xingtu/creators/audience/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=6763236383382306828'
# 小红书
curl -G "https://api.okdata.online/v1/xiaohongshu/pgy/creators/audience/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=591662306a6a6967b63e7f16'常见用途
- 投放前确认达人的粉丝和你的目标买家对得上。
- 粉丝数差不多的两位达人，比比他们的粉丝是哪些人。
常见问题
- 哪些达人广场有？
- 只限上表列出的达人广场，其他广场的粉丝画像在这里拿不到。达人搜索和达人详情仍然能给出粉丝数、互动和内容类目。
- 粉丝画像数据从哪来？
- 来自达人广场，它们会把这些数据展示给找达人的品牌方。这些数字按达人广场自己的估算来理解。
- 能看自己账号的粉丝画像吗？
- 自己的账号，一般走平台官方工具；比如抖音开放平台就有粉丝画像数据，适用于授权过你的应用的用户。