bilibili-API-collect/docs/live/follow_up_live.md

5.8 KiB
Raw Permalink Blame History

关注UP直播情况

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

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

请求方式GET

认证方式CookieSESSDATA

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