Audience(粉丝画像)对象

2 个平台的 3 个接口都返回 Audience(粉丝画像)对象,32 个字段名完全一样,给一个平台写的代码不用改就能读其他平台。每次调用 $0.0020 到 $0.0400。它是预览结构,之后可能调整。

预览对象 · 更新于 2026-10-17在 ChatGPT 里打开在 Claude 里打开

粉丝画像(Audience)是一位达人的粉丝都是谁,按性别、年龄、省份、城市、兴趣、手机品牌分,每一段带 0 到 1 的占比 share。星图还给每一段的粉丝数,并另按城市等级、消费人群、购买品类和每单消费金额分。

creator_id 说明是谁的粉丝:星图或蒲公英的达人编号;来自巨量算数的,则是抖音账号的数字编号(uid),不限于商业合作平台上的达人。蒲公英的画像用 measured_at 写明是哪一天的数据。

字段

平台给不了的字段不会出现在这条数据里,而是写在 meta.unavailable 里。不会用猜的数或 0 顶上。

creator_id 文本

达人编号

measured_at 时间

这份画像是哪一天的数据(按北京时间那一天的零点给)

gender 对象列表

按性别分

gender[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

gender[].share 数字

这一段占所列各段的比例,0 到 1

gender[].count 整数

这一段的粉丝数

age 对象列表

按年龄段分

age[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

age[].share 数字

这一段占所列各段的比例,0 到 1

age[].count 整数

这一段的粉丝数

province 对象列表

按省份分

province[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

province[].share 数字

这一段占所列各段的比例,0 到 1

province[].count 整数

这一段的粉丝数

city 对象列表

按城市分,只列粉丝最多的几个

city[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

city[].share 数字

这一段占所列各段的比例,0 到 1

city[].count 整数

这一段的粉丝数

interest 对象列表

按兴趣分

interest[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

interest[].share 数字

这一段占所列各段的比例,0 到 1

interest[].count 整数

这一段的粉丝数

device 对象列表

按手机品牌分

device[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

device[].share 数字

这一段占所列各段的比例,0 到 1

device[].count 整数

这一段的粉丝数

city_tier 对象列表

按城市等级分

city_tier[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

city_tier[].share 数字

这一段占所列各段的比例,0 到 1

city_tier[].count 整数

这一段的粉丝数

crowd 对象列表

按平台划分的消费人群分

crowd[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

crowd[].share 数字

这一段占所列各段的比例,0 到 1

crowd[].count 整数

这一段的粉丝数

purchase_category 对象列表

按购买的品类分

purchase_category[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

purchase_category[].share 数字

这一段占所列各段的比例,0 到 1

purchase_category[].count 整数

这一段的粉丝数

purchase_amount 对象列表

按每单的消费金额分

purchase_amount[].name 文本

这一段的名称,平台的原话(性别的两段平台给的是英文小写)

purchase_amount[].share 数字

这一段占所列各段的比例,0 到 1

purchase_amount[].count 整数

这一段的粉丝数

每个数取的是平台上的哪个数

同一个字段名,在不同平台上对应的动作不完全一样。这张表写明这个字段取的是平台自己的哪个数。

字段在那里是什么平台
gender.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
age.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
province.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
city这里列的是平台给的全部城市(两百多个),不只是粉丝最多的几个抖音
city.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
interest.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
device.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
city_tier.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
crowd.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
purchase_category.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音
purchase_amount.share平台只给各段的粉丝数;占比是这一段的粉丝数除以所列各段的合计(城市只列前十个)抖音

哪些平台给不了哪些字段

一个平台的所有接口都给不了某个字段时,它才列在那个字段后面。

字段给不了的平台
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小红书
同一个平台上,可能一个接口给不了、另一个接口能给:每个接口的页面列着它给不了的字段,每次返回也都写在 meta.unavailable 里。

返回 Audience(粉丝画像)的接口

每个平台旁边的数字,是它有几个接口返回这种对象。

接口路径价格
抖音巨量算数达人粉丝画像GET/v1/douyin/index/creators/audience/get$0.0020
抖音星图达人粉丝画像GET/v1/douyin/xingtu/creators/audience/get$0.0040
小红书蒲公英博主粉丝画像GET/v1/xiaohongshu/pgy/creators/audience/get$0.0400

示例

douyin.index.creators.audience.get 返回的一条,录制于 2026-10-13 03:25 UTC。名字、正文和编号是示例,链接也是;数字是原样。

Audience(粉丝画像) · douyin.index.creators.audience.get
{
  "creator_id": "65888655493",
  "gender": [
    { "name": "male", "share": 0.8084029405057243 },
    { "name": "female", "share": 0.1915970594942758 }
  ],
  "age": [
    { "name": "31-40", "share": 0.3573003477857061 },
    { "name": "41-50", "share": 0.2595408957167182 },
    // … 另有 3 条
  ],
  "province": [
    { "name": "广东", "share": 0.14160949971558792 },
    { "name": "江苏", "share": 0.07285886667660696 },
    // … 另有 32 条
  ],
  "city": [
    { "name": "北京", "share": 0.03281000167057653 },
    { "name": "上海", "share": 0.027333702606498388 },
    // … 另有 249 条
  ],
  "interest": [
    { "name": "随拍", "share": 0.04880862874319531 },
    { "name": "未分类(垂直度不足)", "share": 0.045695193136280836 },
    // … 另有 40 条
  ],
  "device": [
    { "name": "华为", "share": 0.30586610757827787 },
    { "name": "苹果", "share": 0.22449642440387466 },
    // … 另有 5 条
  ],
  "city_tier": [
    { "name": "三线", "share": 0.22936908477712395 },
    { "name": "新一线", "share": 0.20041213759459334 },
    // … 另有 7 条
  ]
}

完整的返回在这个接口的页面上 →

相关

其他对象