对象
LiveStreamer 对象
主播一段时间内的直播数据,来自直播榜或达人广场:排名、场次、观看和带货区间。 所有平台字段一致。平台不展示的字段为 null,meta.unavailable 会列出它和原因。
| 字段 | 类型 | 起始 view | 说明 |
|---|---|---|---|
id | string | compact | 主播在榜单来源里的 ID:抖音是星图达人 ID(douyin.live.streamers.metrics 用它),TikTok 是用户 ID。 |
url | string | null | compact | 主播主页(有的话)。 |
username | string | null | compact | 用户名(榜单给的话)。 |
name | string | null | compact | 昵称;数据源不给时为 null(douyin.live.streamers.metrics)。 |
avatar_url | string | null | standard | 头像图片地址。 |
followers | integer | null | compact | 粉丝数。 |
rank | integer | null | compact | 在榜单上的名次,从 1 开始;不是榜单时为 null。 |
score | number | null | standard | 榜单分数:TikTok 是积分,星图是 0 到 1 之间的分。 |
category | string | null | compact | 内容或商品类目,平台原文。 |
room_id | string | null | standard | 主播此刻所在的直播间 ID(榜单给的话)。 |
days | integer | null | compact | 数据覆盖的天数;榜单没说时为 null。 |
sessions | integer | null | compact | 期间的直播场次。 |
avg_views | integer | null | compact | 平均每场的观看次数。 |
avg_unique_viewers | integer | null | standard | 平均每场的观看人数。 |
avg_viewers | integer | null | compact | 平均同时在线人数。 |
peak_viewers | integer | null | standard | 最高同时在线人数。 |
avg_watch_seconds | integer | null | standard | 观众平均停留秒数。 |
new_followers | integer | null | compact | 期间直播涨粉数。 |
engagement_rate | Band | null | standard | 互动率(平台的算法),0 到 1,区间。 |
gmv | Band | null | compact | 期间的直播销售额(元),区间。 |
avg_gmv | Band | null | compact | 平均每场的销售额(元),区间。 |
gpm | Band | null | standard | 千次观看成交额(GPM,元),区间。 |
avg_price | Band | null | standard | 所卖商品的平均价格(元),区间。 |
products | integer | null | compact | 期间直播带过的商品数。 |
ext | object | full | 平台特有字段,只在 view=full 时返回。 · 仅 view=full |
Band
| 字段 | 类型 | 说明 |
|---|---|---|
min | number | null | 区间下限;没有下限(如「< 400」)时为 null。 |
max | number | null | 区间上限;没有上限(如「> 0.95」)时为 null。 |