# 达人粉丝画像接口

> 2 个平台的 2 个接口，用同一个 Audience 对象返回达人粉丝画像。达人的粉丝都是谁，按达人广场给出的数据：性别、年龄、地域和兴趣分布。每次 $0.004 到 $0.04，各接口按自己的价格计费；失败的调用不扣费。

网页版：https://okdata.online/zh/roles/creators-audience-get/

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | [抖音星图达人粉丝画像](https://okdata.online/zh/apis/douyin/xingtu/creators/audience/get/) | `GET /v1/douyin/xingtu/creators/audience/get` | 1 | $0.004/次 |
| 小红书 | [小红书蒲公英达人粉丝画像](https://okdata.online/zh/apis/xiaohongshu/pgy/creators/audience/get/) | `GET /v1/xiaohongshu/pgy/creators/audience/get` | 1 | $0.04/次 |

## 返回的对象：[Audience](https://okdata.online/zh/docs/objects/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 时返回。 |

## 两个平台上的同一个调用

参数一样、翻页方式一样、返回结构一样，只换路径。

```bash
# 抖音
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'
```

## 常见用途

- 投放前确认达人的粉丝和你的目标买家对得上。
- 粉丝数差不多的两位达人，比比他们的粉丝是哪些人。

## 常见问题

### 哪些达人广场有？

只限上表列出的达人广场，其他广场的粉丝画像在这里拿不到。达人搜索和达人详情仍然能给出粉丝数、互动和内容类目。

### 粉丝画像数据从哪来？

来自达人广场，它们会把这些数据展示给找达人的品牌方。这些数字按达人广场自己的估算来理解。

### 能看自己账号的粉丝画像吗？

自己的账号，一般走平台官方工具；比如抖音开放平台就有粉丝画像数据，适用于授权过你的应用的用户。

## 其他数据类型

- [评论接口](https://okdata.online/zh/roles/posts-comments-list/)
- [热榜接口](https://okdata.online/zh/roles/trends-list/)
- [评论回复接口](https://okdata.online/zh/roles/comments-replies-list/)
- [话题内容接口](https://okdata.online/zh/roles/topics-posts-list/)
- [账号信息接口](https://okdata.online/zh/roles/accounts-get/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)
- [热门内容接口](https://okdata.online/zh/roles/posts-trending/)
- [账号搜索接口](https://okdata.online/zh/roles/accounts-search/)
- [内容数据接口](https://okdata.online/zh/roles/posts-metrics/)
- [社区帖子接口](https://okdata.online/zh/roles/communities-posts-list/)
- [广告详情接口](https://okdata.online/zh/roles/ads-get/)
- [广告主广告列表接口](https://okdata.online/zh/roles/advertisers-ads-list/)
- [广告搜索接口](https://okdata.online/zh/roles/ads-search/)
- [字幕接口](https://okdata.online/zh/roles/transcripts-get/)
- [粉丝列表接口](https://okdata.online/zh/roles/accounts-followers-list/)
- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品评价接口](https://okdata.online/zh/roles/products-reviews-list/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)
- [达人搜索接口](https://okdata.online/zh/roles/creators-search/)
- [达人详情接口](https://okdata.online/zh/roles/creators-get/)