https://api.live.bilibili.com/xlive/web-ucenter/user/following
请求方式:GET
认证方式:Cookie(SESSDATA)
URL参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| page | num | 页码 | 非必要 | 默认为1 |
| page_size | num | 每页的数据数量 | 非必要 | 有效值1-10, 默认为10 |
| ignoreRecord | num | 尚不明确 一般为 1 |
||
| hit_ab | bool | 尚不明确 建议用 true, 不填为false |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功-101:错误 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|———|—–|——|—————–|
| title | str | 标题 | |
| pageSize | num | 每页的数据数量 | |
| totalPage | num | 分页数量 | |
| list | obj | UP直播情况列表 | |
| count | num | 曾直播过的UP数量 | |
| never_lived_count | num | 未直播过的UP数量 | |
| live_count | num | 正在直播的UP数量 | |
| never_lived_faces | list | | 尚不明确 |
list对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| roomid | num | 房间号 | |
| uid | num | 主播uid | |
| uname | str | 主播名 | |
| title | str | 直播标题 | |
| face | str | 主播头像 | |
| live_status | num | 是否正在直播 | 0: 未直播1: 正在直播 |
| record_num | num | 尚不明确 一般为0 |
|
| recent_record_id | str | 尚不明确 一般为空 |
|
| is_attention | num | 尚不明确 一般为1 |
|
| clipnum | num | 尚不明确 一般为0 |
|
| fans_num | num | 尚不明确 一般为0 |
|
| area_name | str | 尚不明确 一般为空 |
|
| area_value | str | 尚不明确 一般为空 |
|
| tags | str | 尚不明确 一般为空 |
|
| recent_record_id_v2 | str | 尚不明确 一般为空 |
|
| record_num_v2 | num | 尚不明确 一般为0 |
|
| record_live_time | num | 主播上一次直播结束的时间戳 | 正在直播时, 值为0 |
| area_name_v2 | str | 频道的名称 | |
| room_news | str | 房间公告 | |
| switch | bool | 尚不明确 | |
| watch_icon | str | 尚不明确 | |
| text_small | str | 尚不明确 当主播正在直播时, 为在线人数(可能) |
|
| room_cover | str | 房间封面图片的URL | |
| parent_area_id | num | 父分区id | |
| area_id | num | 分区id |
示例:
curl -G 'https://api.live.bilibili.com/xlive/web-ucenter/user/following' \
-b 'SESSDATA=xxx' \
--data-urlencode 'page=1' \
--data-urlencode 'page_size=2' \
--data-urlencode 'ignoreRecord=1' \
--data-urlencode 'hit_ab=true'
https://api.live.bilibili.com/xlive/web-ucenter/v1/xfetter/GetWebList
请求方式:GET
认证方式:Cookie(SESSDATA)
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| hit_ab | bool | 会影响到json回复中部分字段的值,具体的影响效果会在下表列出。 | 非必要 | 默认为true,不填为false |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 1:参数错误 |
| msg | str | 错误信息 | 默认为空 |
| message | str | 错误信息 | 默认为空 |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| rooms | list | 正在直播的房间列表 | 受到url参数hit_ab的影响: true时能够获取到全部正在开播的直播间列表, false时只会获取到前10个。 |
| list | list | 正在直播的房间列表 | 疑似与rooms字段的内容相同,并且同样受到url参数hit_ab的影响,受影响的效果同rooms字段。 |
| count | num | 关注列表中正在直播的人数 | 受到url参数hit_ab的影响:hit_ab为true时为0 |
| not_living_num | num | 关注列表中未开播的人数 | 受到url参数hit_ab的影响:hit_ab为false时为0 |
rooms对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| title | num | 直播间标题 | |
| room_id | num | 直播间真实id | |
| uid | num | 目标用户mid | |
| online | num | 观看人数 | 受url参数hit_ab的影响,hit_ab为true时为0 |
| live_time | num | 已经直播的时长(单位为秒) | 受url参数hit_ab的影响,hit_ab为true时为0 |
| live_status | num | 开播状态 | 0:未开播 1:直播中 2:轮播中 |
| short_id | num | 直播间短id | 受url参数hit_ab的影响,hit_ab为true时为0 |
| area | num | 分区id | 受url参数hit_ab的影响,hit_ab为true时为0 |
| area_name | str | 分区名称 | |
| area_v2_id | num | 二级分区id | |
| area_v2_name | str | 二级分区名 | |
| area_v2_parent_name | str | 二级父分区名 | |
| area_v2_parent_id | num | 二级父分区id | |
| uname | str | 用户名 | |
| face | str | 用户头像图片链接 | |
| tag_name | str | 标签名 | |
| tags | str | 标签列表 | |
| cover_from_user | str | 直播间封面图片链接 | 受url参数hit_ab的影响,hit_ab为true时为0 |
| keyframe | str | 关键帧图片链接 | 用于网页端悬浮展示。受url参数hit_ab的影响,hit_ab为true时为0 |
| lock_till | str | 未知 | 时间日期格式为:yyyy-MM-dd hh-mm-ss。 受url参数hit_ab的影响,hit_ab为true时为空字符串 |
| hidden_till | str | 未知 | 时间日期格式为:yyyy-MM-dd hh-mm-ss。 受url参数hit_ab的影响,hit_ab为true时为空字符串 |
| broadcast_type | num | 广播类型 | |
| is_encrypt | bool | 直播间是否加密 | |
| link | str | 直播间链接 | 受url参数hit_ab的影响,hit_ab为true时为空字符串 |
| nickname | str | 用户昵称 | 受url参数hit_ab的影响,hit_ab为true时为空字符串 |
| roomname | str | 直播间名称 | 受url参数hit_ab的影响,hit_ab为true时为空字符串 |
| roomid | num | 直播间真实id | 受url参数hit_ab的影响,hit_ab为true时为0 |
| liveTime | num | 开播时间 | 受url参数hit_ab的影响,hit_ab为true时为0 |
示例:
curl -G 'https://api.live.bilibili.com/xlive/web-ucenter/v1/xfetter/GetWebList' \
--header 'Cookie: SESSDATA=xxx' \
--data-urlencode 'hit_ab=false'