# 关注UP直播情况 | BAC Document
社区开源的第三方哔哩哔哩 API 文档

# 关注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'

查看响应示例：

    {
      "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'

查看响应示例：

    {
        "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
        }
    }