LOGO

bilibili-api

API数量 STARS LICENSE Python Testing

开发文档: bilibili-api 开发文档 (GitHub)

简介

这是一个用 Python 写的调用 Bilibili 各种 API 的库， 范围涵盖视频、音频、直播、动态、专栏、用户、番剧等[1]。

特色

  • 范围涵盖广，基本覆盖常用的爬虫，操作。
  • 可使用代理，绕过b站风控策略。
  • 全面支持 BV 号（bvid），同时也兼容 AV 号（aid）。
  • 调用简便，函数命名易懂，代码注释详细。
  • 不仅仅是官方提供的 API！还附加：AV 号与 BV 号互转[2]、连接直播弹幕 Websocket 服务器、视频弹幕反查[3]、专栏内容爬取等。
  • 全部是异步操作。

快速上手

首先使用以下指令安装本模块：

  1. $ pip install bilibili-api

接下来我们来获取视频的播放量等信息：

  1. import asyncio
  2. from bilibili_api import video
  4. async def main():
  5.     # 实例化 Video 类
  6.     v = video.Video(bvid="BV1uv411q7Mv")
  7.     # 获取信息
  8.     info = await v.get_info()
  9.     # 打印信息
  10.     print(info)
  12. if __name__ == '__main__':
  13.     asyncio.get_event_loop().run_until_complete(main())

输出（已格式化，已省略部分）：

  1. {
  2.     "bvid": "BV1uv411q7Mv",
  3.     "aid": 243922477,
  4.     "videos": 1,
  5.     "tid": 17,
  6.     "tname": "单机游戏",
  7.     "copyright": 1,
  8.     "pic": "http://i2.hdslb.com/bfs/archive/82e52df9d0221836c260c82f2890e3761a46716b.jpg",
  9.     "title": "爆肝９８小时！在MC中还原糖调小镇",
  10.     "pubdate": 1595203214,
  11.     "ctime": 1595168654,
  12.     ...and more
  13. }

如何给这个视频点赞？我们需要登录自己的账号。

这里设计是传入一个 Credential 类，获取所需的信息参照：获取 Credential 类所需信息

下面的代码将会给视频点赞

  1. import asyncio
  2. from bilibili_api import video, Credential
  4. async def main():
  5.     # 实例化 Credential 类
  6.     credential = Credential(sessdata=SESSDATA, bili_jct=BILI_JCT, buvid3=BUVID3)
  7.     # 实例化 Video 类
  8.     v = video.Video(bvid="BVxxxxxxxx", credential=credential)
  9.     info = await v.get_info()
  10.     print(info)
  11.     # 给视频点赞
  12.     await v.like(True)
  14. if __name__ == '__main__':
  15.     asyncio.get_event_loop().run_until_complete(main())

如果没有报错，就代表调用 API 成功，你可以到视频页面确认是不是调用成功了。

!> 注意，请不要泄露这两个值给他人，否则你的账号将可能遭受盗号的风险！

异步迁移

由于从 v5 版本开始，全部改为异步，如果你不会异步，可以参考 asyncio

异步可以进行并发请求，性能更高，不过如果请求过快仍然会导致被屏蔽。

总的来说，异步比同步更有优势，所以不会的话可以去学一下，会发现新天地（误

如果你仍然想继续使用同步代码，请参考 同步执行异步代码

FA♂Q

Q: 关于 API 调用的正确姿势是什么？

A: 所有 API 调用，请尽量使用 指名方式 传参， 因为 API 较多，可能不同函数的传参顺序不一样，例子：

  1. # 推荐
  2. video.get_info(bvid="BV1uv411q7Mv")
  4. # 当然也可以这样
  5. kwargs = {
  6.     "bvid": "BV1uv411q7Mv"
  7. }
  8. video.get_info(**kwargs)
  10. # 不推荐
  11. video.get_info("BV1uv411q7Mv")

Q: 为什么会提示 412 Precondition Failed ？

A: 你的请求速度太快了。造成请求速度过快的原因可能是你写了高并发的代码。

这种情况下，你的 IP 会暂时被封禁而无法使用，你可以设置代理绕过。

  1. from bilibili_api import settings
  3. settings.proxy = "http://your-proxy.com" # 里头填写你的代理地址

Q: 怎么没有我想要的功能？

A: 你可以发 Issue 来提交你的需求，但是，最好的办法是自己写（懒）

Q: 我有一个大胆的想法，如何给代码库贡献？

A: 请先 clone 本仓库一份，然后从 main 分支新建一个分支，在该分支上工作。 如果你觉得已经可以了，请向项目仓库的 develop 分支发起 Pull request。 如果你不明白这些操作的话，可以百度。

Q: 稳定性怎么样？

A: 由于该模块比较特殊，是爬虫模块，如果b站的接口变更，可能会马上失效。因此请始终保证是最新版本。如果发现问题可以提 Issues。

脚注