bac

关注UP直播情况

用户关注的所有UP的直播情况

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'
查看响应示例: ```json { "code": 0, "message": "0", "ttl": 1, "data": { "title": "哔哩哔哩直播 - 我的关注", "pageSize": 2, "totalPage": 26, "list": [ { "roomid": 544853, "uid": 686127, "uname": "籽岷", "title": "尝试双机位", "face": "https://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp", "live_status": 0, "record_num": 0, "recent_record_id": "", "is_attention": 1, "clipnum": 0, "fans_num": 0, "area_name": "", "area_value": "", "tags": "", "recent_record_id_v2": "", "record_num_v2": 0, "record_live_time": 1720011626, "area_name_v2": "新游推荐", "room_news": "", "switch": true, "watch_icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png", "text_small": "10.9万", "room_cover": "http://i0.hdslb.com/bfs/live/new_room_cover/6c89c41d7695a080d31ae21c128f7759a7f419e5.jpg", "parent_area_id": 6, "area_id": 889 }, { "roomid": 21686237, "uid": 456664753, "uname": "央视新闻", "title": "央视新闻的直播间", "face": "https://i1.hdslb.com/bfs/face/38a8db1c187b64a1412fafffbf350f8a3f436371.jpg", "live_status": 0, "record_num": 0, "recent_record_id": "", "is_attention": 1, "clipnum": 0, "fans_num": 0, "area_name": "", "area_value": "", "tags": "", "recent_record_id_v2": "", "record_num_v2": 0, "record_live_time": 1720001717, "area_name_v2": "社科法律心理", "room_news": "", "switch": false, "watch_icon": "https://i0.hdslb.com/bfs/live/0b265af1af0a77abc47aa3b8f1a5c0769d8bd23b.png", "text_small": "0", "room_cover": "http://i0.hdslb.com/bfs/live/d650d0e6e49397ea71d630be0a0e686679df16d8.jpg", "parent_area_id": 11, "area_id": 376 } ], "count": 52, "never_lived_count": 30, "live_count": 0, "never_lived_faces": [] } } ```

用户关注的所有UP且正在直播的列表(PC端)

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'
查看响应示例: ```json { "code": 0, "message": "0", "ttl": 1, "data": { "rooms": [ { "title": "虚拟区优质跨年直播展演", "room_id": 21496316, "uid": 441666939, "online": 2308, "live_time": 17313, "live_status": 1, "short_id": 36, "area": 6, "area_name": "生活娱乐", "area_v2_id": 744, "area_v2_name": "虚拟Singer", "area_v2_parent_name": "虚拟主播", "area_v2_parent_id": 9, "uname": "虚拟区官方频道", "face": "https://i0.hdslb.com/bfs/face/a26b52bc7837ce6867802575d300ed70d5e6f2d5.jpg", "tag_name": "", "tags": "", "cover_from_user": "https://i0.hdslb.com/bfs/live/new_room_cover/5d7a4526062cf1dc4e88e016638a856c1ac7db03.jpg", "keyframe": "https://i0.hdslb.com/bfs/live-key-frame/keyframe12311645000021496316pkuk08.jpg", "lock_till": "0000-00-00 00:00:00", "hidden_till": "0000-00-00 00:00:00", "broadcast_type": 0, "is_encrypt": false, "link": "https://live.bilibili.com/21496316?broadcast_type=0", "nickname": "虚拟区官方频道", "roomname": "虚拟区优质跨年直播展演", "roomid": 21496316, "liveTime": 1735617438 } ], "list": [ { "title": "虚拟区优质跨年直播展演", "room_id": 21496316, "uid": 441666939, "online": 2308, "live_time": 17313, "live_status": 1, "short_id": 36, "area": 6, "area_name": "生活娱乐", "area_v2_id": 744, "area_v2_name": "虚拟Singer", "area_v2_parent_name": "虚拟主播", "area_v2_parent_id": 9, "uname": "虚拟区官方频道", "face": "https://i0.hdslb.com/bfs/face/a26b52bc7837ce6867802575d300ed70d5e6f2d5.jpg", "tag_name": "", "tags": "", "cover_from_user": "https://i0.hdslb.com/bfs/live/new_room_cover/5d7a4526062cf1dc4e88e016638a856c1ac7db03.jpg", "keyframe": "https://i0.hdslb.com/bfs/live-key-frame/keyframe12311645000021496316pkuk08.jpg", "lock_till": "0000-00-00 00:00:00", "hidden_till": "0000-00-00 00:00:00", "broadcast_type": 0, "is_encrypt": false, "link": "https://live.bilibili.com/21496316?broadcast_type=0", "nickname": "虚拟区官方频道", "roomname": "虚拟区优质跨年直播展演", "roomid": 21496316, "liveTime": 1735617438 } ], "count": 1, "not_living_num": 0 } } ```