Skip to content

Nemo2011/bilibili-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0258194 · Feb 19, 2025
Jan 23, 2023
Feb 14, 2025
Feb 19, 2025
Feb 19, 2025
Jul 14, 2022
Feb 18, 2025
Feb 10, 2025
Feb 3, 2025
Jan 11, 2023
Jan 15, 2023
Aug 28, 2024
Jan 17, 2023
Feb 12, 2025
Sep 4, 2023
Sep 10, 2022
Feb 15, 2025
Feb 10, 2025

Repository files navigation

bilibili-api logo

bilibili-api

API 数量 LICENSE Python Stable Version Pre-release Version STARS Testing

⚠️ 接口可能改动,请及时更新最新版 Stable Version

注意事项:使用此模块时请仅用于学习和测试,禁止用于非法用途及其他恶劣的社区行为如:恶意刷屏、辱骂黄暴、各种形式的滥用等,违规此模块许可证 GNU General Public License Version 3 及此条注意事项而产生的任何后果自负,模块的所有贡献者不负任何责任。

开发文档: bilibili_api 开发文档 (GitHub)

原仓库地址:https://github.com/MoyuScript/bilibili-api

Github 仓库:https://github.com/nemo2011/bilibili-api

此仓库是对原仓库 bilibili-api 的继续的维护。更多相关的信息请前往原仓库地址进行查看。

简介

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

特色

  • 范围涵盖广,基本覆盖常用的爬虫,操作。
  • 可使用代理,绕过 b 站风控策略。
  • 全面支持 BV 号(bvid),同时也兼容 AV 号(aid)。
  • 调用简便,函数命名易懂,代码注释详细。
  • 不仅仅是官方提供的 API!还附加:AV 号与 BV 号互转[2]、连接直播弹幕 Websocket 服务器、视频弹幕反查、下载弹幕、字幕文件[3]、专栏内容爬取、cookies 刷新等[4]
  • 支持采用各种手段避免触发反爬虫风控[5]
  • 全部是异步操作
  • 默认支持 aiohttp / httpx / curl_cffi

快速上手

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

# 主版本
$ pip3 install bilibili-api-python

# 开发版本
$ pip3 install bilibili-api-dev

# 最新修改会在 dev 分支
$ pip3 install git+https://github.com/Nemo2011/bilibili-api.git@dev

然后需要自行安装一个支持异步的第三方请求库,如 aiohttp / httpx / curl_cffi

# aiohttp
$ pip3 install aiohttp

# httpx
$ pip3 install httpx

# curl_cffi
$ pip3 install "curl_cffi"

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

import asyncio
from bilibili_api import video


async def main() -> None:
    # 实例化 Video 类
    v = video.Video(bvid="BV1uv411q7Mv")
    # 获取信息
    info = await v.get_info()
    # 打印信息
    print(info)


if __name__ == "__main__":
    asyncio.run(main())

输出(已格式化,已省略部分):

{
    "bvid": "BV1uv411q7Mv",
    "aid": 243922477,
    "videos": 1,
    "tid": 17,
    "tname": "单机游戏",
    "copyright": 1,
    "pic": "http://i2.hdslb.com/bfs/archive/82e52df9d0221836c260c82f2890e3761a46716b.jpg",
    "title": "爆肝98小时!在 MC 中还原糖调小镇",
    "pubdate": 1595203214,
    "ctime": 1595168654,
    ...and more
}

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

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

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

import asyncio
from bilibili_api import video, Credential

async def main() -> None:
    # 实例化 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.run(main())

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

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

异步迁移

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

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

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

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

模块使用的请求库

模块在允许的条件下,按照 curl_cffi aiohttp httpx 的优先级选择第三方请求库。

如果想要指定请求库,可以利用 select_client 进行切换。

from bilibili_api import select_client

select_client("curl_cffi") # 选择 curl_cffi
select_client("aiohttp") # 选择 aiohttp
select_client("httpx") # 选择 httpx,不支持 WebSocket

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 request_settings

request_settings.set_proxy("http://your-proxy.com") # 里头填写你的代理地址

request_settings.set_proxy("http://username:[email protected]") # 如果需要用户名、密码

Q: 我想在项目中使用这个模块,但是我的项目使用其他请求库进行网络请求(如 pycurl),想要模块也同时使用它(们),可以吗?

A: 可以,但是你可能要自己动手实现模块和具体请求库的适配。详见 自定义请求库

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

A: 你可以发 Issue 来提交你的需求,但是,最好的办法是自己写(懒)

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

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

Q: 稳定性怎么样?

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

脚注

Star History

Star History Chart