BAC Document

关注UP直播情况

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

https://api.live.bilibili.com/xlive/web-ucenter/user/following

请求方式：GET

认证方式：Cookie（SESSDATA）

URL参数：

参数名类型内容必要性备注
pagenum页码非必要默认为1
page_sizenum每页的数据数量非必要有效值1-10, 默认为10
ignoreRecordnum尚不明确
一般为1
hit_abbool尚不明确
建议用true, 不填为false

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-101：错误
messagestr错误信息
ttlnum1
dataobj信息本体

data对象：

字段类型内容备注
titlestr标题
pageSizenum每页的数据数量
totalPagenum分页数量
listobjUP直播情况列表
countnum曾直播过的UP数量
never_lived_countnum未直播过的UP数量
live_countnum正在直播的UP数量
never_lived_faceslist尚不明确

list对象：

字段类型内容备注
roomidnum房间号
uidnum主播uid
unamestr主播名
titlestr直播标题
facestr主播头像
live_statusnum是否正在直播0: 未直播
1: 正在直播
record_numnum尚不明确
一般为0
recent_record_idstr尚不明确
一般为空
is_attentionnum尚不明确
一般为1
clipnumnum尚不明确
一般为0
fans_numnum尚不明确
一般为0
area_namestr尚不明确
一般为空
area_valuestr尚不明确
一般为空
tagsstr尚不明确
一般为空
recent_record_id_v2str尚不明确
一般为空
record_num_v2num尚不明确
一般为0
record_live_timenum主播上一次直播结束的时间戳正在直播时, 值为0
area_name_v2str频道的名称
room_newsstr房间公告
switchbool尚不明确
watch_iconstr尚不明确
text_smallstr尚不明确
当主播正在直播时, 为在线人数(可能)
room_coverstr房间封面图片的URL
parent_area_idnum父分区id
area_idnum分区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'
查看响应示例：
{
  "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_abbool会影响到json回复中部分字段的值，具体的影响效果会在下表列出。非必要默认为true，不填为false

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
1：参数错误
msgstr错误信息默认为空
messagestr错误信息默认为空
dataobj信息本体

data对象：

字段类型内容备注
roomslist正在直播的房间列表受到url参数hit_ab的影响：
true时能够获取到全部正在开播的直播间列表，
false时只会获取到前10个。
listlist正在直播的房间列表疑似与rooms字段的内容相同，并且同样受到url参数hit_ab的影响，受影响的效果同rooms字段。
countnum关注列表中正在直播的人数受到url参数hit_ab的影响：hit_ab为true时为0
not_living_numnum关注列表中未开播的人数受到url参数hit_ab的影响：hit_ab为false时为0

rooms对象：

字段类型内容备注
titlenum直播间标题
room_idnum直播间真实id
uidnum目标用户mid
onlinenum观看人数受url参数hit_ab的影响，hit_ab为true时为0
live_timenum已经直播的时长（单位为秒）受url参数hit_ab的影响，hit_ab为true时为0
live_statusnum开播状态0：未开播
1：直播中
2：轮播中
short_idnum直播间短id受url参数hit_ab的影响，hit_ab为true时为0
areanum分区id受url参数hit_ab的影响，hit_ab为true时为0
area_namestr分区名称
area_v2_idnum二级分区id
area_v2_namestr二级分区名
area_v2_parent_namestr二级父分区名
area_v2_parent_idnum二级父分区id
unamestr用户名
facestr用户头像图片链接
tag_namestr标签名
tagsstr标签列表
cover_from_userstr直播间封面图片链接受url参数hit_ab的影响，hit_ab为true时为0
keyframestr关键帧图片链接用于网页端悬浮展示。受url参数hit_ab的影响，hit_ab为true时为0
lock_tillstr未知时间日期格式为：yyyy-MM-dd hh-mm-ss。
受url参数hit_ab的影响，hit_ab为true时为空字符串
hidden_tillstr未知时间日期格式为：yyyy-MM-dd hh-mm-ss。
受url参数hit_ab的影响，hit_ab为true时为空字符串
broadcast_typenum广播类型
is_encryptbool直播间是否加密
linkstr直播间链接受url参数hit_ab的影响，hit_ab为true时为空字符串
nicknamestr用户昵称受url参数hit_ab的影响，hit_ab为true时为空字符串
roomnamestr直播间名称受url参数hit_ab的影响，hit_ab为true时为空字符串
roomidnum直播间真实id受url参数hit_ab的影响，hit_ab为true时为0
liveTimenum开播时间受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'
查看响应示例：
{
    "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
    }
}