bilibili-api
开发文档: bilibili_api 开发文档 (GitHub)
简介
这是一个用 Python 写的调用 Bilibili 各种 API 的库， 范围涵盖视频、音频、直播、动态、专栏、用户、番剧等[1]。
特色
- 范围涵盖广，基本覆盖常用的爬虫，操作。
- 可使用代理，绕过 b 站风控策略。
- 全面支持 BV 号（bvid），同时也兼容 AV 号（aid）。
- 调用简便，函数命名易懂，代码注释详细。
- 不仅仅是官方提供的 API！还附加：AV 号与 BV 号互转[2]、连接直播弹幕 Websocket 服务器、视频弹幕反查[3]、专栏内容爬取等。
- 全部是异步操作。
快速上手
首先使用以下指令安装本模块：
$ pip install bilibili-api
接下来我们来获取视频的播放量等信息：
import asyncio
from bilibili_api import video
async def main():
# 实例化 Video 类
v = video.Video(bvid="BV1uv411q7Mv")
# 获取信息
info = await v.get_info()
# 打印信息
print(info)
if __name__ == '__main__':
asyncio.get_event_loop().run_until_complete(main())
输出（已格式化，已省略部分）：
{
"bvid": "BV1uv411q7Mv",
"aid": 243922477,
"videos": 1,
"tid": 17,
"tname": "单机游戏",
"copyright": 1,
"pic": "http://i2.hdslb.com/bfs/archive/82e52df9d0221836c260c82f2890e3761a46716b.jpg",
"title": "爆肝９８小时！在 MC 中还原糖调小镇",
"pubdate": 1595203214,
"ctime": 1595168654,
...and more
}
如何给这个视频点赞？我们需要登录自己的账号。
这里设计是传入一个 Credential 类，获取所需的信息参照：获取 Credential 类所需信息
下面的代码将会给视频点赞
import asyncio
from bilibili_api import video, Credential
async def main():
# 实例化 Credential 类
credential = Credential(sessdata=SESSDATA, bili_jct=BILI_JCT, buvid3=BUVID3)
# 实例化 Video 类
v = video.Video(bvid="BVxxxxxxxx", credential=credential)
info = await v.get_info()
print(info)
# 给视频点赞
await v.like(True)
if __name__ == '__main__':
asyncio.get_event_loop().run_until_complete(main())
如果没有报错，就代表调用 API 成功，你可以到视频页面确认是不是调用成功了。
!> 注意，请不要泄露这两个值给他人，否则你的账号将可能遭受盗号的风险！
异步迁移
由于从 v5 版本开始，全部改为异步，如果你不会异步，可以参考 asyncio
异步可以进行并发请求，性能更高，不过如果请求过快仍然会导致被屏蔽。
总的来说，异步比同步更有优势，所以不会的话可以去学一下，会发现新天地（误
如果你仍然想继续使用同步代码，请参考 同步执行异步代码
FA♂Q
Q: 关于 API 调用的正确姿势是什么？
A: 所有 API 调用，请尽量使用 指名方式 传参， 因为 API 较多，可能不同函数的传参顺序不一样，例子：
# 推荐
video.get_info(bvid="BV1uv411q7Mv")
# 当然也可以这样
kwargs = {
"bvid": "BV1uv411q7Mv"
}
video.get_info(**kwargs)
# 不推荐
video.get_info("BV1uv411q7Mv")
Q: 为什么会提示 412 Precondition Failed ？
A: 你的请求速度太快了。造成请求速度过快的原因可能是你写了高并发的代码。
这种情况下，你的 IP 会暂时被封禁而无法使用，你可以设置代理绕过。
from bilibili_api import settings
settings.proxy = "http://your-proxy.com" # 里头填写你的代理地址
Q: 怎么没有我想要的功能？
A: 你可以发 Issue 来提交你的需求，但是，最好的办法是自己写（懒）
Q: 我有一个大胆的想法，如何给代码库贡献？
A: 请先 clone 本仓库一份，然后从 main 分支新建一个分支，在该分支上工作。 如果你觉得已经可以了，请向项目仓库的 develop 分支发起 Pull request。 如果你不明白这些操作的话，可以百度。
Q: 稳定性怎么样？
A: 由于该模块比较特殊，是爬虫模块，如果 b 站的接口变更，可能会马上失效。因此请始终保证是最新版本。如果发现问题可以提 Issues。
脚注
- [1] 这里只列出一部分，请以实际 API 为准。
- [2] 代码来源：https://www.zhihu.com/question/381784377/answer/1099438784
- [3] 代码翻译自：https://github.com/esterTion/BiliBili_crc2mid
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bilibili-api-9.1.0.tar.gz.
File metadata
- Download URL: bilibili-api-9.1.0.tar.gz
- Upload date:
- Size: 89.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
be2e9e142c39a2deb6b74ccf0205ad3eae76c12864ddff7b1693fe52e04efa8c
|
|
| MD5 |
ac5064b51b3d5aa67bced78f582bd689
|
|
| BLAKE2b-256 |
0e1e436faba3a170451a88c83205b46d6e305ebc7fcb7f59a44463affe26dc5d
|
File details
Details for the file bilibili_api-9.1.0-py3-none-any.whl.
File metadata
- Download URL: bilibili_api-9.1.0-py3-none-any.whl
- Upload date:
- Size: 106.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9763e0c7ee05f4ade92855b8942a021e6eeb7ae4a8ba5e32ae377335738f790d
|
|
| MD5 |
80337ec56084dd8db66cbcfcb1f6d385
|
|
| BLAKE2b-256 |
94bb61215006818fec0dc0d5dd22da6ae0f553cfd00a2396df8f0b38783bcc75
|
