关注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": []
  }
}