# 达人粉丝画像 API

2 个平台的 2 个接口返回同一种 Audience（粉丝画像）对象。一个达人的粉丝构成：性别、年龄、地域、兴趣各占多少。每次调用 $0.0040 到 $0.0400，按接口各自的标价；失败不收费。

## 各平台的达人粉丝画像接口

| 平台 | 接口 | 路径 | 一页 | 返回 | 价格 |
| --- | --- | --- | --- | --- | --- |
| 抖音 | [抖音星图达人粉丝画像](https://dataxapi.com/zh/apis/douyin/xingtu/creators/audience/get.md) | `GET /v1/douyin/xingtu/creators/audience/get` | 1 | 粉丝画像 | $0.0040 / 次 |
| 小红书 | [小红书蒲公英博主粉丝画像](https://dataxapi.com/zh/apis/xiaohongshu/pgy/creators/audience/get.md) | `GET /v1/xiaohongshu/pgy/creators/audience/get` | 1 | 粉丝画像 | $0.0400 / 次 |

价格是现行价格。失败和结果不确定的调用不收费。

## Audience（粉丝画像）对象

上面每个接口返回的都是这些字段，名字和类型都一样。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `creator_id` | 文本 | 达人编号 |
| `measured_at` | 时间 | 这份画像是哪一天的数据（按北京时间那一天的零点给） |
| `gender[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `gender[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `gender[].count` | 整数 | 这一段的粉丝数 |
| `age[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `age[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `age[].count` | 整数 | 这一段的粉丝数 |
| `province[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `province[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `province[].count` | 整数 | 这一段的粉丝数 |
| `city[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `city[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `city[].count` | 整数 | 这一段的粉丝数 |
| `interest[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `interest[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `interest[].count` | 整数 | 这一段的粉丝数 |
| `device[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `device[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `device[].count` | 整数 | 这一段的粉丝数 |
| `city_tier[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `city_tier[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `city_tier[].count` | 整数 | 这一段的粉丝数 |
| `crowd[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `crowd[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `crowd[].count` | 整数 | 这一段的粉丝数 |
| `purchase_category[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `purchase_category[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `purchase_category[].count` | 整数 | 这一段的粉丝数 |
| `purchase_amount[].name` | 文本 | 这一段的名称，平台的原话（性别的两段平台给的是英文小写） |
| `purchase_amount[].share` | 数字 | 这一段占所列各段的比例，0 到 1 |
| `purchase_amount[].count` | 整数 | 这一段的粉丝数 |

[看这个对象的页面 →](https://dataxapi.com/zh/docs/objects/audience/)

### 哪个平台有哪个字段

接口给不了的字段，每次返回都会写在 `meta.unavailable` 里，所以缺字段不会是意外。

| 平台 | `measured_at` | `gender[].count` | `age[].count` | `province[].count` | `city[].count` | `interest[].count` | `device[].count` | `city_tier[].name` | `city_tier[].share` | `city_tier[].count` | `crowd[].name` | `crowd[].share` | `crowd[].count` | `purchase_category[].name` | `purchase_category[].share` | `purchase_category[].count` | `purchase_amount[].name` | `purchase_amount[].share` | `purchase_amount[].count` |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 抖音 | 给不了 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 |
| 小红书 | 有 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 |

## 同一次调用，换一个平台

同样的参数名，同样的翻页，同样的返回。变的只有路径。

```bash
# 抖音
curl -G "https://api.dataxapi.com/v1/douyin/xingtu/creators/audience/get" \
  --data-urlencode "id=6763236383382306828" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

# 小红书：同样的调用，换成它自己的路径
curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/creators/audience/get" \
  --data-urlencode "id=5c0017ef6b58b740c92463fb" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

### 200 · application/json

抖音星图达人粉丝画像：取自 2026-10-12 21:49 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

```jsonc
{
  "code": "ok",
  "request_id": "25005e75-4c98-42d9-a6dd-afe2a7b8a879",
  "data": {
    "item": {
      "creator_id": "66673485511",
      "gender": [
        { "name": "male", "share": 0.8084018682929753, "count": 20914248 },
        { "name": "female", "share": 0.19159813170702464, "count": 4956855 }
      ],
      "age": [
        { "name": "18-23", "share": 0.02613169810130031, "count": 669976 },
        { "name": "24-30", "share": 0.11262389160089727, "count": 2887501 },
        // … 另有 3 条
      ],
      "province": [
        { "name": "福建", "share": 0.034598226662216194, "count": 845507 },
        { "name": "香港", "share": 0.001540805252634323, "count": 37654 },
        // … 另有 32 条
      ],
      "city": [
        { "name": "北京", "share": 0.14657726964471665, "count": 751515 },
        { "name": "上海", "share": 0.12174096383309756, "count": 624177 },
        // … 另有 8 条
      ],
      "interest": [
        { "name": "二次元", "share": 0.022866163075920397, "count": 471117 },
        { "name": "随拍", "share": 0.5770495394947144, "count": 11889089 },
        // … 另有 6 条
      ],
      "device": [
        { "name": "其他", "share": 0.1350657086683392, "count": 3500022 },
        { "name": "华为", "share": 0.24915854592413617, "count": 6456564 },
        // … 另有 6 条
      ],
      "city_tier": [
        { "name": "二线", "share": 0.18540551970015773, "count": 4530677 },
        { "name": "五线", "share": 0.10928394606430417, "count": 2670526 },
        // … 另有 3 条
      ],
      "crowd": [
        { "name": "Z世代", "share": 0.015066702484682015, "count": 328216 },
        { "name": "资深中产", "share": 0.16493764562162405, "count": 3593034 },
        // … 另有 6 条
      ],
      "purchase_category": [
        { "name": "其他", "share": 0.35668521581357804, "count": 3854685 },
        { "name": "服饰内衣", "share": 0.20722439582025148, "count": 2239467 },
        // … 另有 4 条
      ],
      "purchase_amount": [
        { "name": "50-100", "share": 0.23128677093645555, "count": 2497497 },
        { "name": "0-50", "share": 0.3880473446209439, "count": 4190240 },
        // … 另有 3 条
      ]
    }
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.xingtu.creators.audience.get",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:49:33.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": { "measured_at": "capability" },
    "billing": {
      "amount": "0.004",
      "currency": "USD",
      "balance_after": "9.996"
    }
  }
}
```

## 返回的是什么

- [Audience（粉丝画像）对象](https://dataxapi.com/zh/docs/objects/audience/): 字段 32, 返回它的接口 3, 平台 2

## 关于 达人粉丝画像 API 的常见问题

### 多少钱？

抖音每次 $0.0040；小红书每次 $0.0400。拿到数据才扣费，失败不收。没有订阅，没有月最低消费。

### 每个平台的字段都全吗？

不全。32 个字段里有 19 个至少在一个平台上拿不到，本页的对照表写明是哪些。接口给不了的字段，每次返回都写在 `meta.unavailable` 里，不会用猜的数顶上。

### 需要平台账号吗？

不需要。一把 DataXAPI 的 Key 读这 2 个平台，不用任何平台的账号，也不用 Cookie。

## 其他数据类型

[评论回复 API](https://dataxapi.com/zh/roles/comments-replies-list/)、[话题下的内容 API](https://dataxapi.com/zh/roles/topics-posts-list/)、[热榜 API](https://dataxapi.com/zh/roles/trends-list/)、[账号资料 API](https://dataxapi.com/zh/roles/accounts-get/)、[账号作品列表 API](https://dataxapi.com/zh/roles/accounts-posts-list/)、[评论 API](https://dataxapi.com/zh/roles/posts-comments-list/)、[内容详情 API](https://dataxapi.com/zh/roles/posts-get/)、[内容搜索 API](https://dataxapi.com/zh/roles/posts-search/)、[热门内容榜 API](https://dataxapi.com/zh/roles/posts-trending/)、[账号搜索 API](https://dataxapi.com/zh/roles/accounts-search/)、[内容互动数据 API](https://dataxapi.com/zh/roles/posts-metrics/)、[社区帖子 API](https://dataxapi.com/zh/roles/communities-posts-list/)、[广告详情 API](https://dataxapi.com/zh/roles/ads-get/)、[广告主的广告 API](https://dataxapi.com/zh/roles/advertisers-ads-list/)、[广告主搜索 API](https://dataxapi.com/zh/roles/advertisers-search/)、[广告库搜索 API](https://dataxapi.com/zh/roles/ads-search/)、[视频转文字 API](https://dataxapi.com/zh/roles/transcripts-get/)、[粉丝列表 API](https://dataxapi.com/zh/roles/accounts-followers-list/)、[社区资料 API](https://dataxapi.com/zh/roles/communities-get/)、[商品详情 API](https://dataxapi.com/zh/roles/products-get/)、[商品评价 API](https://dataxapi.com/zh/roles/products-reviews-list/)、[商品搜索 API](https://dataxapi.com/zh/roles/products-search/)、[达人搜索 API](https://dataxapi.com/zh/roles/creators-search/)、[达人资料 API](https://dataxapi.com/zh/roles/creators-get/)、[达人数据表现 API](https://dataxapi.com/zh/roles/creators-metrics/)、[达人作品 API](https://dataxapi.com/zh/roles/creators-posts-list/)、[全部 21 个平台 →](https://dataxapi.com/zh/apis/)

---

最后核对于 2026-10-21 11:10 UTC。目录修订号 c48ce454ae6c4c65。 [网页版](https://dataxapi.com/zh/roles/creators-audience-get/)
