接口调用地址
说明:直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成,通过IP接口地址调用,如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击,平台可能不定期更换。
说明:域名接口会自动分发请求到普通集群服务器均衡负载,该域名TTL值为60秒,表示你的请求会每60秒实现自动轮换负载服务器,但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障,也可能会造成个别地区存在一定时间的故障期。
说明:VIP专线在普通集群组的基础上额外增加独享大带宽集群组,每次请求自动均衡负载,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!最低30¥/月,彩钻以上会员专属,登录后购买。注:VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等,并非收费接口包月使用。
请求示例
[GET]请求示例:(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例:(请根据开发语言自行POST,参考【GET/POST教程】,或下载【超级客户端】调试。)
请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。参数内容较大的必须用POST,不能GET。
提示:如发现接口有BUG,可加服务QQ群及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
提示:如发现接口有BUG,可加服务QQ群及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
| 父分区ID | fid | 是 | 父分区ID,可通过【B站获取直播父分区ID,子分区ID列表】接口获取。例:fid=2 |
| 子分区ID | zid | 是 | 子分区ID,可通过【B站获取直播父分区ID,子分区ID列表】接口获取。如果传0则默认查询所有子分区。例:zid=2 |
| 页码 | page | 否 | 默认第一页,例:page=1 |
| cookie | ck | 否 | 在获取失败的情况下可尝试传递COOKIE,例:ck=cookie |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功,400错误。 |
| 信息提示 | msg | 信息提示。 |
| 当前页码 | page | 当前页码。 |
| 网页列表地址 | url | 网页列表地址,如果获取失败,可以尝试浏览器打开该地址,取出cookie,然后重新调用接口并传递ck参数。 |
| 列表数据集 | datas | 列表数据集。该页码会有10分钟的缓存。 |
| 房间号 | datas.roomid | 房间号。 |
| 主播ID | datas.uid | 主播ID。 |
| 标题 | datas.title | 标题。 |
| 昵称 | datas.uname | 昵称。 |
| 封面 | datas.cover | 封面。 |
| 头像 | datas.face | 头像。 |
| 父分区ID | datas.fid | 父分区ID。 |
| 父分区名称 | datas.fname | 父分区名称。 |
| 子分区ID | datas.zid | 子分区ID。 |
| 子分区名称 | datas.zname | 子分区名称。 |
| 认证名称 | datas.verify | 认证名称。 |
| 观看人数 | datas.num | 观看人数。 |
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
"code": 200,
"page": 1,
"url": "https://api.live.bilibili.com/xlive/web-interface/v1/second/getList?platform=web&parent_area_id=2&area_id=0&sort_type=sort_type_2221&page=1&web_location=444.253&w_webid=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzcG1faWQiOiI0NDQuMjUzIiwidXNlcl9hZ2VudCI6Ik1vemlsbGEvNS4wIChXaW5kb3dzIE5UIDEwLjA7IFdpbjY0OyB4NjQpIEFwcGxlV2ViS2l0LzUzNy4zNiAoS0hUTUwsIGxpa2UgR2Vja28pIENocm9tZS8xMTYuMC41ODQ1Ljk3IFNhZmFyaS81MzcuMzYgQ29yZS8xLjExNi40NjAuNDAwIFFRQnJvd3Nlci8xMy4zLjYxNjcuNDAwIiwiY3JlYXRlZF9hdCI6MTc3NDg3MjA3MCwidHRsIjo4NjQwMCwidXJsIjoibGl2ZS5iaWxpYmlsaS5jb20vcC9lZGVuL2FyZWEtdGFncz9wYXJlbnRBcmVhSWQ9NiIsInJlc3VsdCI6Im5vcm1hbCIsImlzcyI6ImdhaWEiLCJpYXQiOjE3NzQ4NzIwNzB9.YbkkCvHOqR59Rd3xoU4TdkujRWZG0cMByi3VHKmZ2gbQoCDvXzrs5CfHAqOt_sb_LNT4Rb4XjvA7Ok_dO6y8f_g7o_nHq0TWuw53qnuzN2gsEfqPpbM0TVCDg5Xoqr-LZ1viuLrPkg7cTnFXKBDAGAJecMqvvcpe0aEKSA-7R9h0fRxUdv44A7TlNVMNajikRBddvSX3vqJDGp8hzTH3ib2NhcVTs_oInZiR8uNKantKEFDGp_ghLdsxNF42mVCOhTyR1Ta-v_jOaL0ZW7wv-irbZ3bQbUfp30B31L0IqbcQQ-SG7Uq_BfkVAKiwZw5Zm6Q8fEpt7Uyhchqy08YGng&wts=1774874817&w_rid=9e8f0f59b33da14d0863e5de30556c0b",
"datas": [
{
"roomid": 23438368,
"uid": 403637371,
"title": "逐帧分析喷火兵撤离失败原因",
"uname": "老飞宇66",
"cover": "https://i0.hdslb.com/bfs/live/new_room_cover/a41aa690714e7bfdd9e5653117fe289978e6e20d.jpg",
"face": "https://i1.hdslb.com/bfs/face/25d6b747d51cd07f6ae01a1145225f9be7fbdc5d.jpg",
"fid": 2,
"fname": "网游",
"zid": 878,
"zname": "三角洲行动",
"verify": "2025百大UP主、2025年度黑马UP主、2025年度巅峰主播",
"num": 131468
},
{
"roomid": 545068,
"uid": 8739477,
"title": "德云色 解说沙特杯 JK 天回归!",
"uname": "老实憨厚的笑笑",
"cover": "https://i0.hdslb.com/bfs/live/71ad865301cc62b5fdb544799a6abbdbea6b24fa.jpg",
"face": "https://i0.hdslb.com/bfs/face/59da329a536b148b0e8d19143b686d2da06dad93.jpg",
"fid": 2,
"fname": "网游",
"zid": 86,
"zname": "英雄联盟",
"verify": "bilibili 2022百大UP主、2022直播年度弹幕人气奖UP主、职业游戏解说孙亚龙",
"num": 382887
},
{
"roomid": 24678311,
"uid": 277827884,
"title": "解说TES AL!",
"uname": "楚钧艾克",
"cover": "https://i0.hdslb.com/bfs/live/new_room_cover/043ece6d5a3121bd6de3ef4740831958a85bac36.jpg",
"face": "https://i2.hdslb.com/bfs/face/f963e71ee3e14487cf6c907d095c44b5794af60c.jpg",
"fid": 2,
"fname": "网游",
"zid": 86,
"zname": "英雄联盟",
"verify": "bilibili 知名游戏UP主",
"num": 308923
},
{
"roomid": 1919216529,
"uid": 139006416,
"title": "乌兹杯BO5打宁王",
"uname": "waywardzz",
"cover": "https://i0.hdslb.com/bfs/live/new_room_cover/d7b1e8148d88f6779e742882f8b6c44d458384b4.jpg",
"face": "https://i0.hdslb.com/bfs/face/d87765e030eb8d2ba1075a3309e126ebf5c07fe6.jpg",
"fid": 2,
"fname": "网游",
"zid": 86,
"zname": "英雄联盟",
"verify": "",
"num": 40057
},
{
"roomid": 5236391,
"uid": 179877838,
"title": "天梯暴力炸",
"uname": "大东彦",
"cover": "https://i0.hdslb.com/bfs/live/new_room_cover/f4338972ed679fbc296dd53069e281aff218a871.jpg",
"face": "https://i1.hdslb.com/bfs/face/442b895d10bbce6a5cd5746fc383f27fb06207e0.jpg",
"fid": 2,
"fname": "网游",
"zid": 329,
"zname": "无畏契约",
"verify": "bilibili 知名游戏UP主",
"num": 70098
},
{
"roomid": 1733394496,
"uid": 3493269266762688,
"title": "顶级瞄准",
"uname": "天才美少女卡莎",
"cover": "https://i0.hdslb.com/bfs/live/new_room_cover/5dd4d5d38c273bb5957e3eb60cebd9ab97ca1b64.jpg",
"face": "https://i0.hdslb.com/bfs/face/f7c77a775f4857bb57a6a516c107ef880b915ccc.jpg",
"fid": 2,
"fname": "网游",
"zid": 240,
"zname": "APEX英雄",
"verify": "",
"num": 67695
},
{
"roomid": 768756,
"uid": 4591661,
"title": "7点ALGS训练赛OB解说",
"uname": "快乐滋崩在这里",
"cover": "https://i0.hdslb.com/bfs/live/new_room_cover/c84e7a056c11de0ba658b494880e827ba095114e.jpg",
"face": "https://i2.hdslb.com/bfs/face/25a655a3a5a95ec47838da8235bfa030ce1a4416.jpg",
"fid": 2,
"fname": "网游",
"zid": 240,
"zname": "APEX英雄",
"verify": "bilibili 知名游戏UP主、直播高能主播",
"num": 42554
},
{
"roomid": 6750632,
"uid": 233592835,
"title": "七点doinb办的pubg比赛",
"uname": "夏夏大魔王_Axx",
"cover": "https://i0.hdslb.com/bfs/live/ee4d0bf79d2d336756fc206d48eb9c7ea383fe26.jpg",
"face": "https://i1.hdslb.com/bfs/face/3db07ad574d4587f492d9e7b7fccc248def4aa91.jpg",
"fid": 2,
"fname": "网游",
"zid": 80,
"zname": "吃鸡行动",
"verify": "bilibili 直播高能主播",
"num": 28927
},
{
"roomid": 7734200,
"uid": 50329118,
"title": "【预告】4月4日15点TES vs IG",
"uname": "哔哩哔哩英雄联盟赛事",
"cover": "https://i0.hdslb.com/bfs/live/69e3ccd50b2d3026cbee6c334ecd2900b1c87e47.png",
"face": "https://i2.hdslb.com/bfs/face/544c89e68f2b1f12ffcbb8b3c062a3328e8692d9.jpg",
"fid": 13,
"fname": "赛事",
"zid": 561,
"zname": "游戏赛事",
"verify": "哔哩哔哩英雄联盟赛事直播官方账号",
"num": 217987
},
{
"roomid": 23197314,
"uid": 51628309,
"title": "玩会二次元套狗晚上和卡哥团建",
"uname": "飞天狙想要努力变胖",
"cover": "https://i0.hdslb.com/bfs/live/new_room_cover/3c66fd624bdb1b374861cf7c95f22cff52611a68.jpg",
"face": "https://i1.hdslb.com/bfs/face/5eaa06a437d53169962994a0fbdb8e3a91cb5487.jpg",
"fid": 2,
"fname": "网游",
"zid": 240,
"zname": "APEX英雄",
"verify": "bilibili 知名游戏UP主、直播高能主播",
"num": 62581
},
{
"roomid": 99783,
"uid": 7005369,
"title": "32进16小组单败淘汰赛",
"uname": "剑网3",
"cover": "https://i0.hdslb.com/bfs/live/new_room_cover/ca2ed3d1ec6fd735aa85394c345a2db98957ee5a.jpg",
"face": "https://i0.hdslb.com/bfs/face/3fec696613aaf70b1d0ee986632b0d0ef993d1df.jpg",
"fid": 2,
"fname": "网游",
"zid": 82,
"zname": "剑网3",
"verify": "剑网3官方视频账号",
"num": 9932
}
]
}
更新记录