# LiveStreamer

> 主播一段时间内的直播数据，来自直播榜或达人广场：排名、场次、观看和带货区间。

网页版：https://okdata.online/zh/docs/objects/live_streamer/

所有平台同一种结构。平台没有的字段为 null，meta.unavailable 会说明原因。用 fields= 只取需要的字段。

| 字段 | 类型 | 说明 |
|---|---|---|
| `id` | string | 主播在榜单来源里的 ID：抖音是星图达人 ID（douyin.live.streamers.metrics 用它），TikTok 是用户 ID。 |
| `url` | string \| null | 主播主页（有的话）。 |
| `username` | string \| null | 用户名（榜单给的话）。 |
| `name` | string \| null | 昵称；数据源不给时为 null（douyin.live.streamers.metrics）。 |
| `avatar_url` | string \| null | 头像图片地址。 |
| `followers` | integer \| null | 粉丝数。 |
| `rank` | integer \| null | 在榜单上的名次，从 1 开始；不是榜单时为 null。 |
| `score` | number \| null | 榜单分数：TikTok 是积分，星图是 0 到 1 之间的分。 |
| `category` | string \| null | 内容或商品类目，平台原文。 |
| `room_id` | string \| null | 主播此刻所在的直播间 ID（榜单给的话）。 |
| `days` | integer \| null | 数据覆盖的天数；榜单没说时为 null。 |
| `sessions` | integer \| null | 期间的直播场次。 |
| `avg_views` | integer \| null | 平均每场的观看次数。 |
| `avg_unique_viewers` | integer \| null | 平均每场的观看人数。 |
| `avg_viewers` | integer \| null | 平均同时在线人数。 |
| `peak_viewers` | integer \| null | 最高同时在线人数。 |
| `avg_watch_seconds` | integer \| null | 观众平均停留秒数。 |
| `new_followers` | integer \| null | 期间直播涨粉数。 |
| `engagement_rate` | Band \| null | 互动率（平台的算法），0 到 1，区间。 |
| `gmv` | Band \| null | 期间的直播销售额（元），区间。 |
| `avg_gmv` | Band \| null | 平均每场的销售额（元），区间。 |
| `gpm` | Band \| null | 千次观看成交额（GPM，元），区间。 |
| `avg_price` | Band \| null | 所卖商品的平均价格（元），区间。 |
| `products` | integer \| null | 期间直播带过的商品数。 |
| `ext` | object | 平台特有字段，只在 view=full 时返回。 |

### Band

| 字段 | 类型 | 说明 |
|---|---|---|
| `min` | number \| null | 区间下限；没有下限（如「< 400」）时为 null。 |
| `max` | number \| null | 区间上限；没有上限（如「> 0.95」）时为 null。 |

## 返回 LiveStreamer 的接口

- [抖音直播达人榜](https://okdata.online/zh/apis/douyin/live/streamers/trending/) (`douyin.live.streamers.trending`): $0.006/次 · 每页约 100 条结果
- [抖音主播直播数据](https://okdata.online/zh/apis/douyin/live/streamers/metrics/) (`douyin.live.streamers.metrics`): $0.04/次
- [TikTok 直播带货榜](https://okdata.online/zh/apis/tiktok/live/streamers/trending/) (`tiktok.live.streamers.trending`): $0.002/次 · 每页约 99 条结果

## 各 view 返回的字段

每一级 view 都包含上一级的字段。`view=compact` 最精简；`full` 会在 `ext` 里加上平台特有字段。

- compact：`id`, `url`, `username`, `name`, `followers`, `rank`, `category`, `days`, `sessions`, `avg_views`, `avg_viewers`, `new_followers`, `gmv`, `avg_gmv`, `products`
- standard：`avatar_url`, `score`, `room_id`, `avg_unique_viewers`, `peak_viewers`, `avg_watch_seconds`, `engagement_rate`, `gpm`, `avg_price`
- full：`ext`
