Struct BpiClient 

pub struct BpiClient { /* private fields */ }

Implementations

impl BpiClient

pub async fn activity_info( &self, sid: u64, bvid: Option<&str>, ) -> Result<BpiResponse<ActivityInfoData>, BpiError>

获取活动主题信息

参数

名称	类型	说明
sid	u64	活动 ID
bvid	String	来源视频号

文档

查看API文档

impl BpiClient

pub async fn activity_list( &self, plat: Option<&str>, mold: Option<i32>, http: Option<i32>, pn: Option<i32>, ps: Option<i32>, ) -> Result<BpiResponse<ActivityListData>, BpiError>

获取活动列表

参数

名称	类型	说明
plat	u32	活动平台类型，可选范围 [1,3]，以半角逗号分隔，默认 1,3
mold	u32	固定值 0 (可选)
http	u32	固定值 3 (可选)
pn	u32	目标页码 (可选，默认为 1)
ps	u32	每页条数 (可选，默认为 15)

文档

获取活动列表

pub async fn activity_list_default( &self, ) -> Result<BpiResponse<ActivityListData>, BpiError>

获取活动列表（简化版本，使用默认参数）

文档

获取活动列表

impl BpiClient

pub async fn article_like( &self, id: u64, like: bool, ) -> Result<BpiResponse<Value>, BpiError>

点赞文章

参数

名称	类型	说明
id	u64	文章 cvid (必要)
like	bool	是否点赞，true 点赞，false 取消点赞

文档

点赞文章

pub async fn article_coin( &self, aid: u64, upid: u64, multiply: u32, ) -> Result<BpiResponse<CoinResponseData>, BpiError>

投币文章

参数

名称	类型	说明
aid	i64	文章 cvid (必要)
upid	i64	文章作者 mid (必要)
multiply	u32	投币数量 (必要，上限为 2)

文档

投币文章

pub async fn article_favorite( &self, id: u64, ) -> Result<BpiResponse<Value>, BpiError>

收藏文章

参数

名称	类型	说明
id	u64	文章 cvid (必要)

文档

收藏文章

pub async fn article_unfavorite( &self, id: i64, ) -> Result<BpiResponse<Value>, BpiError>

收藏文章

参数

名称	类型	说明
id	i64	文章 cvid (必要)

文档

收藏文章

impl BpiClient

pub async fn article_articles_info( &self, id: i64, ) -> Result<BpiResponse<ArticlesData>, BpiError>

获取文集基本信息

参数

名称	类型	说明
id	i64	文集 rlid (必要)

文档

获取文集基本信息

impl BpiClient

pub async fn article_cards(&self, ids: &str) -> Result<CardResponse, BpiError>

获取专栏显示卡片信息

参数

名称	类型	说明
ids	String	被查询的 id 列表，以逗号分隔；可填视频完整 AV/BV 号、专栏 CV 号、直播间长/短 lv 号

文档

获取专栏显示卡片信息

impl BpiClient

pub async fn article_info( &self, id: i64, ) -> Result<BpiResponse<ArticleInfoData>, BpiError>

获取专栏文章基本信息

参数

名称	类型	说明
id	i64	专栏 cvid (必要)

文档

获取专栏文章基本信息

impl BpiClient

pub async fn article_view( &self, id: i64, ) -> Result<ArticleViewResponse, BpiError>

获取专栏正文内容

参数

• id - 专栏文章ID (必要)
• gaia_source - 来源，默认为“main_web“ (可选)

impl BpiClient

pub async fn audio_collection_to_fav( &self, rid: u64, add_media_ids: Option<Vec<&str>>, del_media_ids: Option<Vec<&str>>, ) -> Result<BpiResponse<PromptData>, BpiError>

收藏音频到收藏夹(同视频收藏夹)

参数

名称	类型	说明
sid	u64	音频 auid
add_media_ids	Vec<&str>	添加的合集ids
del_media_ids	Vec<&str>	从中删除的合集ids

与视频收藏几乎一样

pub async fn audio_collection_to( &self, sid: u64, cids: u64, ) -> Result<BpiResponse<bool>, BpiError>

查询音频收藏状态

参数

名称	类型	说明
sid	u64	音频 auid

返回

值	说明
true	操作成功?

pub async fn audio_collection_status( &self, sid: u64, ) -> Result<BpiResponse<bool>, BpiError>

查询音频收藏状态

参数

名称	类型	说明
sid	u64	音频 auid

返回

值	说明
true	已收藏
false	未收藏

文档

查询音频收藏状态

pub async fn audio_coin_count( &self, sid: u64, ) -> Result<BpiResponse<i32>, BpiError>

查询音频投币数

参数

名称	类型	说明
sid	u64	音频 auid

返回

投币数量，0 为未投币，上限为 2

文档

查询音频投币数

pub async fn audio_coin( &self, sid: u64, multiply: u32, ) -> Result<BpiResponse<String>, BpiError>

投币音频

参数

名称	类型	说明
sid	u64	音频 auid
multiply	i32	投币数量（最大为 2）

返回

当前投币数量

文档

投币音频

impl BpiClient

pub async fn audio_info( &self, sid: u64, ) -> Result<BpiResponse<AudioInfoData>, BpiError>

查询歌曲基本信息

参数

名称	类型	说明
sid	u64	音频 auid (必要)

文档

查询歌曲基本信息

pub async fn audio_tags( &self, sid: u64, ) -> Result<BpiResponse<Vec<AudioTag>>, BpiError>

查询歌曲 TAG

参数

名称	类型	说明
sid	u64	音频 auid (必要)

文档

查询歌曲 TAG

pub async fn audio_members( &self, sid: u64, ) -> Result<AudioMemberResponse, BpiError>

查询歌曲创作成员列表

参数

名称	类型	说明
sid	u64	音频 auid (必要)

文档

查询歌曲创作成员列表

pub async fn audio_lyric( &self, sid: u64, ) -> Result<BpiResponse<String>, BpiError>

获取歌曲歌词

参数

名称	类型	说明
sid	u64	音频 auid (必要)

文档

获取歌曲歌词

impl BpiClient

pub async fn audio_collections_list( &self, pn: u32, ps: u32, ) -> Result<BpiResponse<AudioCollectionsListData>, BpiError>

查询自己创建的歌单

参数

名称	类型	说明
pn	u32	页码
ps	u32	每页项数

文档

查询自己创建的歌单

pub async fn audio_collection_info( &self, sid: u64, ) -> Result<BpiResponse<AudioCollection>, BpiError>

查询音频收藏夹信息

参数

名称	类型	说明
sid	u64	音频收藏夹 mlid（必须为默认收藏夹 mlid）

文档

查询音频收藏夹（默认歌单）信息

pub async fn audio_hot_menu( &self, pn: u32, ps: u32, ) -> Result<BpiResponse<AudioHotMenuData>, BpiError>

查询热门歌单

参数

名称	类型	说明
pn	u32	页码
ps	u32	每页项数

文档

查询热门歌单

pub async fn audio_rank_menu( &self, pn: u32, ps: u32, ) -> Result<BpiResponse<AudioRankMenuData>, BpiError>

查询热门榜单

参数

名称	类型	说明
pn	u32	页码
ps	u32	每页项数

文档

查询热门榜单

impl BpiClient

pub async fn audio_stream_url_web( &self, sid: u64, ) -> Result<BpiResponse<AudioStreamUrlWebData>, BpiError>

获取音频流 URL (web端)

注：web端无法播放完整付费歌曲，付费歌曲为 30s 试听片段 本接口仅能获取 192K 音质的音频

参数

名称	类型	说明
sid	u64	音频 auid

文档

获取音频流URL(web端)

pub async fn audio_stream_url( &self, songid: u64, quality: AudioQuality, ) -> Result<BpiResponse<AudioStreamUrlData>, BpiError>

获取音频流 URL（可获取付费音频）

注：付费音乐需要有带大会员或音乐包的账号登录（Cookie或 APP），否则为试听片段 无损音质需要登录的用户为会员

参数

名称	类型	说明
songid	u64	音频 auid
quality	AudioQuality	音质代码

文档

获取音频流URL（可获取付费音频）

impl BpiClient

pub async fn audio_rank_period( &self, list_type: u32, ) -> Result<BpiResponse<AudioRankPeriodData>, BpiError>

获取音频榜单每期列表

参数

名称	类型	说明
list_type	u32	榜单类型 1:hot 2:origin

文档

获取音频榜单每期列表

pub async fn audio_rank_detail( &self, list_id: u64, ) -> Result<BpiResponse<AudioRankDetailData>, BpiError>

查询音频榜单单期信息

参数

名称	类型	说明
list_id	u64	榜单 id

文档

查询音频榜单单期信息

pub async fn audio_rank_music_list( &self, list_id: u64, ) -> Result<BpiResponse<AudioRankMusicListData>, BpiError>

获取音频榜单单期内容

参数

名称	类型	说明
list_id	u64	榜单 id
csrf	String	CSRF Token（可选）

文档

获取音频榜单单期内容

pub async fn audio_rank_subscribe( &self, state: u32, list_id: Option<u64>, ) -> Result<BpiResponse<Value>, BpiError>

订阅或退订榜单

参数

名称	类型	说明
state	u32	操作代码（1：订阅，2：退订）
list_id	Option	榜单 id（可选）

文档

订阅或退订榜单

impl BpiClient

pub async fn audio_status_number( &self, sid: i64, ) -> Result<BpiResponse<AudioStatusNumberData>, BpiError>

查询歌曲状态数

唯缺投币数2333333

参数

名称	类型	说明
sid	i64	音频 auid

文档

歌曲状态数

impl BpiClient

pub async fn bangumi_follow( &self, season_id: u64, ) -> Result<BpiResponse<BangumiFollowResult>, BpiError>

追番

参数

• season_id - 剧集ssid

文档

追番

pub async fn bangumi_unfollow( &self, season_id: u64, ) -> Result<BpiResponse<BangumiFollowResult>, BpiError>

取消追番

参数

• season_id - 剧集ssid

文档

取消追番

impl BpiClient

pub async fn bangumi_info( &self, media_id: u64, ) -> Result<BangumiInfoResponse, BpiError>

获取剧集基本信息（mdid方式）

参数

• media_id - 剧集mdid

文档

剧集基本信息（mdid方式）

pub async fn bangumi_detail_by_season_id( &self, season_id: u64, ) -> Result<BangumiDetailResponse, BpiError>

获取剧集明细（web端）（ssid方式）

参数

• season_id - 番剧ssid

文档

获取剧集明细（web端）（ssid/epid方式）

pub async fn bangumi_detail_by_epid( &self, ep_id: u64, ) -> Result<BangumiDetailResponse, BpiError>

获取剧集明细（web端）（epid方式）

参数

• ep_id - 剧集epid

文档

获取剧集明细（web端）（ssid/epid方式）

pub async fn bangumi_sections_by_season_id( &self, season_id: u64, ) -> Result<BpiResponse<BangumiSectionResult>, BpiError>

获取剧集分集信息

参数

• season_id - 剧集ssid

文档

获取剧集明细（web端）（ssid/epid方式）

impl BpiClient

pub async fn bangumi_timeline( &self, types: BangumiTimelineType, before: i32, after: i32, ) -> Result<BpiResponse<Vec<BangumiTimelineDay>>, BpiError>

获取番剧或影视时间线

参数

• types - 类别（1：番剧，3：电影，4：国创）
• before - 开始于前几日（0-7）
• after - 结束于后几日（0-7）

文档

获取番剧或影视时间线

impl BpiClient

pub async fn bangumi_video_stream( &self, ep_id: Option<u64>, cid: Option<u64>, qn: Option<VideoQuality>, fnval: Option<Fnval>, ) -> Result<BpiResponse<BangumiVideoStreamData>, BpiError>

获取番剧视频流 URL

参数

名称	类型	说明
ep_id	Option<u64	稿件 epid
cid	Option>	视频 cid（可选，与 ep_id 二选一）
qn	u32	视频清晰度选择
fnval	u32	视频获取方式选择

文档

获取番剧视频流URL

pub async fn bangumi_video_stream_by_epid( &self, ep_id: u64, qn: Option<VideoQuality>, fnval: Option<Fnval>, ) -> Result<BpiResponse<BangumiVideoStreamData>, BpiError>

获取番剧视频流 URL

参数

名称	类型	说明
ep_id	u64	稿件 epid
qn	u32	视频清晰度选择
fnval	u32	视频获取方式选择

文档

获取番剧视频流URL

pub async fn bangumi_video_stream_by_cid( &self, cid: u64, qn: Option<VideoQuality>, fnval: Option<Fnval>, ) -> Result<BpiResponse<BangumiVideoStreamData>, BpiError>

获取番剧视频流 URL

参数

名称	类型	说明
cid	u64	视频 cid（
qn	u32	视频清晰度选择
fnval	u32	视频获取方式选择

文档

获取番剧视频流URL

impl BpiClient

pub async fn cheese_info( &self, season_id: Option<u64>, ep_id: Option<u64>, ) -> Result<BpiResponse<CourseInfo>, BpiError>

获取课程基本信息

通过课程 season_id 或分集 ep_id 获取课程的详细信息，包括课程简介、 分集列表、UP主信息、统计数据等。

参数

名称	类型	说明
season_id	Option	课程 season_id，与 ep_id 二选一
ep_id	Option	课程分集 ep_id，与 season_id 二选一

错误

当 season_id 和 ep_id 都未提供时返回参数错误

文档

获取课程基本信息

pub async fn cheese_info_by_season_id( &self, season_id: u64, ) -> Result<BpiResponse<CourseInfo>, BpiError>

通过 season_id 获取课程基本信息

参数

名称	类型	说明
season_id	u64	课程 season_id

pub async fn cheese_info_by_ep_id( &self, ep_id: u64, ) -> Result<BpiResponse<CourseInfo>, BpiError>

通过 ep_id 获取课程基本信息

参数

名称	类型	说明
ep_id	u64	课程分集 ep_id

pub async fn cheese_ep_list( &self, season_id: u64, ps: Option<u32>, pn: Option<u32>, ) -> Result<BpiResponse<CourseEpList>, BpiError>

获取课程分集列表

获取指定课程的所有分集信息，支持分页查询。

参数

名称	类型	说明
season_id	u64	课程 season_id
ps	Option	每页数量，可选，默认值由 API 决定
pn	Option	页码，可选，默认为 1

文档

获取课程分集列表

impl BpiClient

pub async fn cheese_video_stream( &self, avid: u64, ep_id: u64, cid: u64, qn: Option<VideoQuality>, fnval: Option<Fnval>, ) -> Result<BpiResponse<CourseVideoStreamData>, BpiError>

获取课程视频流 URL

获取课程视频的播放流地址，支持多种视频质量和格式。 仅课程视频可用，与普通视频 API 不互通。

参数

名称	类型	说明
avid	u64	课程视频 avid
ep_id	u64	课程分集 ep_id
cid	u64	视频 cid
qn	Option	视频质量，可选
fnval	Option	视频格式标志，可选

注意

需要 Cookie（SESSDATA）和 Referer: https://www.bilibili.com

文档

获取课程视频流 URL

impl BpiClient

pub async fn clientinfo_ip( &self, ip: Option<&str>, ) -> Result<BpiResponse<IpInfo>, BpiError>

查询 IP 地址归属地

查询指定 IP 地址的地理位置信息，包括国家、省份、城市和 ISP 运营商。 如果不提供 IP 参数，将返回请求方 IP 的地理信息。

参数

名称	类型	说明
ip	Option<&str>	IPv4 或 IPv6 地址，可选。如果留空，返回请求方 IP 信息

文档

IP 地址归属地查询

impl BpiClient

点赞评论

pub async fn comment_add( &self, type: CommentType, oid: u64, message: &str, root: Option<u64>, parent: Option<u64>, ) -> Result<BpiResponse<CommentData>, BpiError>

发表评论

在指定评论区发表评论，支持回复根评论或父评论。

参数

名称	类型	说明
type	CommentType	评论区类型
oid	u64	对象 ID
message	&str	评论内容
root	Option	根评论 rpid，可选
parent	Option	父评论 rpid，可选

文档

发表评论

pub async fn comment_like( &self, type: CommentType, oid: u64, rpid: u64, action: u8, ) -> Result<BpiResponse<Value>, BpiError>

点赞评论

参数

名称	类型	说明
type	CommentType	评论区类型
oid	u64	对象 ID
rpid	u64	评论 rpid
action	u8	操作：0 取消，1 点赞

文档

点赞评论

pub async fn comment_dislike( &self, type: CommentType, oid: u64, rpid: u64, action: u8, ) -> Result<BpiResponse<Value>, BpiError>

点踩评论

参数

名称	类型	说明
type	CommentType	评论区类型
oid	u64	对象 ID
rpid	u64	评论 rpid
action	u8	操作：0 取消，1 点踩

文档

点踩评论

pub async fn comment_delete( &self, type: CommentType, oid: u64, rpid: u64, ) -> Result<BpiResponse<Value>, BpiError>

删除评论

参数

名称	类型	说明
type	CommentType	评论区类型
oid	u64	对象 ID
rpid	u64	评论 rpid

文档

删除评论

pub async fn comment_top( &self, type: CommentType, oid: u64, rpid: u64, action: u8, ) -> Result<BpiResponse<Value>, BpiError>

置顶评论

参数

名称	类型	说明
type	CommentType	评论区类型
oid	u64	对象 ID
rpid	u64	评论 rpid
action	u8	操作：0 取消置顶，1 置顶

文档

置顶评论

pub async fn comment_report( &self, type: CommentType, oid: u64, rpid: u64, reason: ReportReason, content: Option<&str>, ) -> Result<BpiResponse<Value>, BpiError>

举报评论

参数

名称	类型	说明
type	CommentType	评论区类型
oid	u64	对象 ID
rpid	u64	评论 rpid
reason	ReportReason	举报原因
content	Option<&str>	举报内容，可选

文档

举报评论

impl BpiClient

pub async fn comment_list( &self, type: i32, oid: i64, pn: Option<i32>, ps: Option<i32>, sort: Option<i32>, nohot: Option<i32>, ) -> Result<CommentListResponse, BpiError>

获取评论主列表

获取指定评论区的评论列表，支持分页和排序。

参数

名称	类型	说明
type	i32	评论区类型
oid	i64	对象 ID
pn	Option	页码，可选，默认为 1
ps	Option	每页条数，可选，范围 1-20
sort	Option	排序方式，可选：0 按时间，1 按点赞，2 按回复数
nohot	Option	是否不显示热评，可选：0 显示，1 不显示

文档

获取评论主列表

pub async fn comment_replies( &self, type: i32, oid: i64, root: i64, pn: Option<i32>, ps: Option<i32>, ) -> Result<CommentListResponse, BpiError>

获取某条根评论下的子评论列表

获取指定根评论下的所有子评论，支持分页。

参数

名称	类型	说明
type	i32	评论区类型
oid	i64	对象 ID
root	i64	根评论 rpid
pn	Option	页码，可选，默认为 1
ps	Option	每页条数，可选

文档

获取子评论列表

pub async fn comment_hot( &self, type: i32, oid: i64, root: i64, pn: Option<i32>, ps: Option<i32>, ) -> Result<BpiResponse<HotCommentData>, BpiError>

获取评论区热评列表

获取指定根评论下的热评列表，支持分页。

参数

名称	类型	说明
type	i32	评论区类型
oid	i64	对象 ID
root	i64	根评论 rpid
pn	Option	页码，可选，默认为 1
ps	Option	每页条数，可选

文档

获取热评列表

pub async fn comment_count( &self, type: i32, oid: i64, ) -> Result<BpiResponse<CountData>, BpiError>

获取评论区评论总数

参数

名称	类型	说明
type	i32	评论区类型
oid	i64	对象 ID

文档

获取评论总数

impl BpiClient

pub async fn dynamic_delete( &self, dyn_id: &str, ) -> Result<BpiResponse<Value>, BpiError>

删除动态

参数

名称	类型	说明
dyn_id	&str	动态 ID

文档

删除动态

pub async fn article_delete( &self, aid: u64, ) -> Result<BpiResponse<Value>, BpiError>

删除专栏

参数

名称	类型	说明
aid	u64	专栏文章 ID

文档

删除专栏

impl BpiClient

pub async fn up_electromagnetic_info( &self, ) -> Result<BpiResponse<ElectromagneticInfo>, BpiError>

获取电磁力等级

获取当前用户的电磁力等级信息，包括等级、分数、信用分等。

文档

获取电磁力等级

impl BpiClient

pub async fn season_create( &self, title: &str, desc: Option<&str>, cover: &str, season_price: Option<u32>, ) -> Result<BpiResponse<u64>, BpiError>

创建合集

创建一个新的视频合集，需要提供标题、封面等信息。

参数

名称	类型	说明
title	&str	合集标题
desc	Option<&str>	合集简介，可选
cover	&str	封面图 URL（从上传接口获取）
season_price	Option	合集价格，可选，默认 0

文档

创建合集

pub async fn season_delete( &self, season_id: u64, ) -> Result<BpiResponse<Value>, BpiError>

删除合集

删除指定的合集，需要提供合集 ID。

参数

名称	类型	说明
season_id	u64	合集 ID

文档

删除合集

pub async fn season_episodes_add( &self, section_id: u64, episodes: Vec<EpisodeAdd>, ) -> Result<BpiResponse<Value>, BpiError>

添加视频到合集

将视频添加到指定的合集小节中。

参数

名称	类型	说明
section_id	u64	合集小节 ID
episodes	Vec	视频列表

文档

添加视频到合集

impl BpiClient

pub async fn season_by_aid( &self, aid: u64, ) -> Result<BpiResponse<SeasonInfoData>, BpiError>

根据视频 aid 查询所属合集信息

通过视频 aid 查询该视频所属的合集信息。

参数

名称	类型	说明
aid	u64	视频 aid

文档

根据 aid 反查合集信息

impl BpiClient

pub async fn season_edit( &self, season: SeasonEdit, sorts: Vec<SeasonSectionSort>, ) -> Result<BpiResponse<Value>, BpiError>

编辑合集信息

编辑合集的基本信息，包括标题、封面、简介等。

参数

名称	类型	说明
season	SeasonEdit	合集信息
sorts	Vec	小节排序列表

文档

编辑合集信息

pub async fn season_section_edit( &self, section: SeasonSectionEdit, sorts: Vec<SectionSort>, ) -> Result<BpiResponse<Value>, BpiError>

编辑合集小节(需要开启小节功能)

编辑合集中的小节信息，包括小节标题和视频排序。

参数

名称	类型	说明
section	SeasonSectionEdit	小节信息
sorts	Vec	视频排序信息

文档

编辑合集小节

pub async fn season_section_episode_edit( &self, section: EpisodeEdit, sorts: Vec<EpisodeSort>, ) -> Result<BpiResponse<Value>, BpiError>

编辑小节中的章节

编辑合集中的小节信息，包括小节标题和视频排序。

参数

名称	类型	说明
section	SeasonSectionEdit	小节信息
sorts	Vec	视频排序信息

文档

编辑合集小节

pub async fn season_enable_section( &self, season_id: u64, enable: bool, ) -> Result<BpiResponse<Value>, BpiError>

切换小节/正常显示

参数

• season_id 合集id

pub async fn season_section_add_episodes( &self, section_id: u64, episodes: Vec<Episode>, ) -> Result<BpiResponse<Value>, BpiError>

添加视频到小节(需要开启小节功能)

将视频添加到指定的合集小节中。

参数

名称	类型	说明
aid	u64	视频 aid
season_id	u64	合集 ID
section_id	u64	小节 ID
title	&str	视频标题

文档

编辑投稿视频合集/小节

impl BpiClient

pub async fn season_list( &self, pn: u32, ps: u32, order: Option<&str>, sort: Option<&str>, ) -> Result<BpiResponse<SeasonListData>, BpiError>

获取合集列表

获取当前用户创建的合集列表，支持分页和排序。

参数

名称	类型	说明
pn	u32	页码，默认 1
ps	u32	每页数量，默认 30
order	Option<&str>	排序方式：ctime 或 mtime
sort	Option<&str>	升降序：asc 或 desc

文档

获取合集列表

impl BpiClient

pub async fn season_info( &self, season_id: u64, ) -> Result<BpiResponse<SeasonInfoData>, BpiError>

impl BpiClient

pub async fn season_section_episodes( &self, season_id: u64, ) -> Result<BpiResponse<SeasonSectionEpisodesData>, BpiError>

获取合集小节中的视频

获取指定合集中所有小节的视频信息。

参数

名称	类型	说明
season_id	u64	合集 ID

文档

获取合集小节中的视频

impl BpiClient

pub async fn up_stat(&self) -> Result<BpiResponse<UpStatData>, BpiError>

获取 UP 主视频状态数据

获取 UP 主的视频统计数据，包括播放、点赞、投币、收藏等数据。

文档

获取 UP 主视频状态数据

pub async fn up_archive_compare( &self, t: Option<i64>, size: Option<i64>, ) -> Result<BpiResponse<ArchiveCompareData>, BpiError>

获取 UP 主视频数据比较

获取 UP 主视频的数据对比分析，包括播放量、互动率等指标。

参数

名称	类型	说明
t	Option	时间戳，可选
size	Option	最近 N 条视频，可选，默认 5

文档

获取 UP 主视频数据比较

pub async fn up_article_stat( &self, ) -> Result<BpiResponse<UpArticleStatData>, BpiError>

获取UP主专栏状态数据

获取 UP 主专栏的统计数据，包括阅读、评论、点赞等数据。

文档

获取UP主专栏状态数据

pub async fn up_video_trend( &self, type_code: i64, ) -> Result<BpiResponse<Vec<VideoTrendItem>>, BpiError>

获取UP主视频数据增量趋势

获取 UP 主视频数据的增量趋势，支持多种数据类型。

参数

名称	类型	说明
type_code	i64	数据类型：1播放 2弹幕 3评论 4分享 5投币 6收藏 7充电 8点赞

文档

获取UP主视频数据增量趋势

pub async fn up_article_trend( &self, type_code: i64, ) -> Result<BpiResponse<Vec<ArticleTrendItem>>, BpiError>

获取UP主专栏数据增量趋势

获取 UP 主专栏数据的增量趋势，支持多种数据类型。

参数

名称	类型	说明
type_code	i64	数据类型：1阅读 2评论 3分享 4投币 5收藏 6点赞

文档

获取UP主专栏数据增量趋势

pub async fn up_viewer_data(&self) -> Result<BpiResponse<ViewerData>, BpiError>

获取播放分布情况

获取视频播放的分布情况，包括粉丝与路人的观看数据。

文档

获取播放分布情况

impl BpiClient

pub async fn upload_cover( &self, mime_type: &str, cover: impl AsRef<str>, ) -> Result<BpiResponse<UploadCoverData>, BpiError>

上传视频封面

上传视频封面图片，支持多种输入格式。

参数

名称	类型	说明
mime_type	&str	图片 MIME 类型，如 image/jpeg
cover	impl AsRef	封面数据，可以是：纯 base64、完整 data URI、文件路径

注意

文件不得超过 20M

文档

上传视频封面

impl BpiClient

pub async fn up_archives_list( &self, pn: i64, ps: Option<i64>, ) -> Result<BpiResponse<SpArchivesData>, BpiError>

获取稿件列表

获取 UP 主的稿件列表，支持分页查询。

参数

名称	类型	说明
pn	i64	页码
ps	Option	每页数量，可选

文档

获取稿件列表

pub async fn up_archive_videos( &self, aid: i64, ) -> Result<BpiResponse<ArchiveVideosData>, BpiError>

获取视频基础信息

获取指定视频的基础信息，包括分P列表等。

参数

名称	类型	说明
aid	i64	视频 av 号

文档

获取视频基础信息

impl BpiClient

pub async fn dynamic_like( &self, dyn_id_str: &str, up: u8, ) -> Result<BpiResponse<Value>, BpiError>

点赞动态 POST https://api.bilibili.com/x/dynamic/feed/dyn/thumb

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
dyn_id_str	&str	动态 ID
up	u8	点赞状态：0 切换，1 点赞，2 取消

pub async fn dynamic_remove_draft( &self, draft_id: &str, ) -> Result<BpiResponse<Value>, BpiError>

删除定时发布动态

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
draft_id	&str	定时发布动态 ID

pub async fn dynamic_set_top( &self, dyn_str: &str, ) -> Result<BpiResponse<Value>, BpiError>

设置置顶动态

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
dyn_str	&str	动态 ID

pub async fn dynamic_remove_top( &self, dyn_str: &str, ) -> Result<BpiResponse<Value>, BpiError>

取消置顶动态 POST https://api.bilibili.com/x/dynamic/feed/space/rm_top

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
dyn_str	&str	动态 ID

impl BpiClient

pub async fn dynamic_all( &self, host_mid: Option<&str>, offset: Option<&str>, update_baseline: Option<&str>, ) -> Result<BpiResponse<DynamicAllData>, BpiError>

获取全部动态列表 GET https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/all

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
host_mid	Option<&str>	UP 主 UID
offset	Option<&str>	分页偏移量
update_baseline	Option<&str>	更新基线，用于获取新动态

pub async fn dynamic_check_new( &self, update_baseline: &str, type_str: Option<&str>, ) -> Result<BpiResponse<DynamicUpdateData>, BpiError>

检测是否有新动态 GET https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/all/update

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
update_baseline	&str	上次列表返回的 update_baseline
type_str	Option<&str>	动态类型

impl BpiClient

pub async fn dynamic_feed_banner( &self, ) -> Result<BpiResponse<DynamicBannerData>, BpiError>

获取动态首页公告栏

参数

• platform - 平台，默认为 1

impl BpiClient

pub async fn dynamic_repost_detail( &self, dynamic_id: &str, offset: Option<&str>, ) -> Result<BpiResponse<RepostDetailResponseData>, BpiError>

动态转发列表

获取指定动态的转发列表。

参数

• dynamic_id - 动态ID
• offset - 偏移量，非必要 文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
dynamic_id	&str	动态 ID
offset	Option<&str>	偏移量

pub async fn dynamic_spec_item_likes( &self, dynamic_id: u64, pn: Option<u64>, ps: Option<u64>, ) -> Result<BpiResponse<SpecItemLikesResponseData>, BpiError>

动态点赞列表

获取指定动态的点赞列表。赞列表总计超过25K部分继续获取可能被限制

参数

• dynamic_id - 动态ID
• pn - 页码，非必要，默认1
• ps - 每页数量，非必要，默认20 文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
dynamic_id	u64	动态 ID
pn	Option	页码，默认 1
ps	Option	页大小，默认 20

impl BpiClient

pub async fn dynamic_live_users( &self, size: Option<u32>, ) -> Result<BpiResponse<LiveUsersData>, BpiError>

获取正在直播的已关注者

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
size	Option	每页显示数，默认 10

pub async fn dynamic_up_users( &self, teenagers_mode: Option<u8>, ) -> Result<BpiResponse<DynUpUsersData>, BpiError>

获取发布新动态的已关注者

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
teenagers_mode	Option	是否开启青少年模式：0 否，1 是

impl BpiClient

pub async fn dynamic_detail( &self, id: &str, features: Option<&str>, ) -> Result<BpiResponse<DynamicDetailData>, BpiError>

获取动态详情

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
id	&str	动态 ID
features	Option<&str>	功能特性，如 itemOpusStyle,opusBigCover,onlyfansVote...

pub async fn dynamic_reactions( &self, id: &str, offset: Option<&str>, ) -> Result<BpiResponse<DynamicReactionData>, BpiError>

获取动态点赞与转发列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
id	&str	动态 ID
offset	Option<&str>	偏移量，用于翻页

pub async fn dynamic_lottery_notice( &self, business_id: &str, ) -> Result<BpiResponse<DynamicLotteryData>, BpiError>

获取动态抽奖详情

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
business_id	&str	动态 ID

pub async fn dynamic_forwards( &self, id: &str, offset: Option<&str>, ) -> Result<BpiResponse<DynamicForwardData>, BpiError>

获取动态转发列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
id	&str	动态 ID
offset	Option<&str>	偏移量，用于翻页

pub async fn dynamic_pics( &self, id: &str, ) -> Result<BpiResponse<Vec<DynamicPic>>, BpiError>

获取动态中图片列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
id	&str	动态 ID

pub async fn dynamic_forward_item( &self, id: &str, ) -> Result<BpiResponse<DynamicForwardInfoData>, BpiError>

获取转发动态信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
id	&str	动态 ID

impl BpiClient

pub async fn dynamic_card_detail( &self, dynamic_id: &str, ) -> Result<BpiResponse<DynamicCardData>, BpiError>

获取特定动态卡片信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
dynamic_id	&str	动态 ID

pub async fn dynamic_recent_up_list( &self, ) -> Result<BpiResponse<RecentUpData>, BpiError>

获取最近更新 UP 主列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

impl BpiClient

pub async fn dynamic_nav_feed( &self, update_baseline: Option<&str>, offset: Option<&str>, ) -> Result<BpiResponse<DynamicNavData>, BpiError>

获取导航栏动态列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
update_baseline	Option<&str>	更新基线，获取新动态时使用
offset	Option<&str>	分页偏移量，翻页时使用

impl BpiClient

pub async fn dynamic_upload_pic( &self, file_path: &Path, category: Option<&str>, ) -> Result<BpiResponse<UploadPicData>, BpiError>

为图片动态上传图片

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
file_path	&Path	图片文件路径
category	Option<&str>	图片类型，可选 daily/draw/cos

pub async fn dynamic_create_text( &self, content: &str, ) -> Result<BpiResponse<CreateDynamicData>, BpiError>

发布纯文本动态

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
content	&str	动态内容

pub async fn dynamic_create_complex( &self, scene: u8, contents: Vec<DynamicContentItem>, pics: Option<Vec<DynamicPic>>, topic: Option<DynamicTopic>, ) -> Result<BpiResponse<CreateComplexDynamicData>, BpiError>

发表复杂动态

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/dynamic

参数

名称	类型	说明
scene	u8	动态类型：1 纯文本，2 带图，4 转发
contents	Vec	动态内容组件
pics	Option<Vec>	动态图片，最多 9 个
topic	Option	话题

impl BpiClient

pub async fn danmaku_send( &self, oid: u64, msg: &str, avid: Option<u64>, bvid: Option<&str>, mode: Option<u8>, typ: Option<u8>, progress: Option<u32>, color: Option<u32>, fontsize: Option<u8>, pool: Option<u8>, ) -> Result<BpiResponse<DanmakuPostData>, BpiError>

发送视频弹幕

文档: 弹幕相关

参数

名称	类型	说明
oid	u64	视频 cid
msg	&str	弹幕内容
avid	Option	稿件 aid（avid 与 bvid 二选一）
bvid	Option<&str>	稿件 bvid（avid 与 bvid 二选一）
mode	Option	弹幕模式：1 滚动，4 底端，5 顶端，7 高级，9 BAS（pool=2）
typ	Option	弹幕类型：1 视频弹幕，2 漫画弹幕
progress	Option	弹幕出现时间（毫秒）
color	Option	颜色（rgb888），如 16777215 为白色
fontsize	Option	字号，默认 25（12/16/18/25/36/45/64）
pool	Option	弹幕池：0 普通池，1 字幕池，2 特殊池（代码/BAS）

pub async fn danmaku_send_default( &self, oid: u64, msg: &str, avid: Option<u64>, bvid: Option<&str>, ) -> Result<BpiResponse<DanmakuPostData>, BpiError>

发送视频弹幕（精简参数版本）

文档: 弹幕相关

参数

名称	类型	说明
oid	u64	视频 cid
msg	&str	弹幕内容
avid	Option	稿件 aid（avid 与 bvid 二选一）
bvid	Option<&str>	稿件 bvid（avid 与 bvid 二选一）

impl BpiClient

pub async fn danmaku_recall( &self, cid: u64, dmid: u64, ) -> Result<BpiResponse<Value>, BpiError>

撤回弹幕

文档: 弹幕相关

参数

名称	类型	说明
cid	u64	视频 cid
dmid	u64	要撤回的弹幕 id（仅能撤回自己两分钟内的弹幕，每天 5 次）

返回中的 message 示例：“撤回成功，你还有{}次撤回机会”

impl BpiClient

pub async fn danmaku_buy_adv( &self, cid: u64, ) -> Result<BpiResponse<Value>, BpiError>

购买高级弹幕发送权限（一次需要 2 硬币）

文档: 弹幕相关

参数

名称	类型	说明
cid	u64	视频 cid

impl BpiClient

pub async fn danmaku_adv_state( &self, cid: u64, ) -> Result<BpiResponse<DanmakuAdvState>, BpiError>

检测高级弹幕发送权限

文档: 弹幕相关

参数

名称	类型	说明
cid	u64	视频 cid

impl BpiClient

pub async fn danmaku_thumbup( &self, oid: u64, dmid: u64, op: u8, ) -> Result<BpiResponse<Value>, BpiError>

点赞弹幕

文档: 弹幕相关

参数

名称	类型	说明
oid	u64	视频 cid
dmid	u64	弹幕 id
op	u8	1 点赞，2 取消点赞

impl BpiClient

pub async fn danmaku_report( &self, cid: u64, dmid: u64, reason: u8, content: Option<&str>, ) -> Result<BpiResponse<Value>, BpiError>

举报弹幕

文档: 弹幕相关

参数

名称	类型	说明
cid	u64	视频 cid
dmid	u64	弹幕 id
reason	u8	原因代码
content	Option<&str>	举报备注（reason=11 时有效）

impl BpiClient

pub async fn danmaku_edit_state( &self, oid: u64, dmids: &[u64], state: u8, ) -> Result<BpiResponse<Value>, BpiError>

保护或删除弹幕（仅能操作自己的稿件或具备权限的稿件）

文档: 弹幕相关

参数

名称	类型	说明
oid	u64	视频 oid/cid
dmids	&u64	弹幕 id 列表
state	u8	1 删除，2 保护，3 取消保护

impl BpiClient

pub async fn danmaku_edit_pool( &self, oid: u64, dmids: &[u64], pool: u8, ) -> Result<BpiResponse<Value>, BpiError>

修改字幕池（仅能操作自己的稿件或具备权限的稿件）

文档: 弹幕相关

参数

名称	类型	说明
oid	u64	视频 oid/cid
dmids	&u64	弹幕 id 列表
pool	u8	弹幕池：0 普通池，1 字幕池，2 特殊池

impl BpiClient

pub async fn danmaku_xml_list_so( &self, oid: i64, ) -> Result<DanmakuXml, BpiError>

获取实时弹幕（接口1）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/danmaku

参数

名称	类型	说明
oid	i64	视频 oid/cid

pub async fn danmaku_xml_list(&self, cid: i64) -> Result<DanmakuXml, BpiError>

获取实时弹幕（接口2） 使用 deflate 压缩（reqwest 会自动解压），返回 XML 文本

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/danmaku

参数

名称	类型	说明
cid	i64	视频 cid

impl BpiClient

pub async fn danmaku_history_dates( &self, oid: i64, month: &str, ) -> Result<HistoryDatesResponse, BpiError>

查询历史弹幕日期

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/danmaku

参数

名称	类型	说明
oid	i64	视频 cid
month	&str	形如 2006-01

impl BpiClient

pub async fn danmaku_snapshot( &self, aid_or_bvid: &str, ) -> Result<SnapshotResponse, BpiError>

获取弹幕快照（最近产生的若干条，最多20条）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/danmaku

参数

名称	类型	说明
aid_or_bvid	&str	可传 avid (数字) 或 bvid (如 BV...)

impl BpiClient

pub async fn danmaku_thumbup_stats( &self, oid: i64, ids: &[i64], ) -> Result<ThumbupStatsResponse, BpiError>

查询指定 dmid 的点赞状态与统计

impl BpiClient

pub async fn electric_bcoin_quick_pay( &self, bp_num: i32, is_bp_remains_prior: bool, up_mid: i64, otype: &str, oid: i64, ) -> Result<BpiResponse<BcoinQuickPayData>, BpiError>

新版本B币充电

参数

• bp_num: 贝壳数量，必须在 2-9999 之间
• is_bp_remains_prior: 是否优先扣除 B 币余额
  • true: B 币充电时请选择 true
  • false: 否则从贝壳余额中扣除
• up_mid: 充电对象用户的 mid
• otype: 充电来源
  • "up": 空间充电
  • "archive": 视频充电
• oid: 充电来源代码
  • 空间充电：传充电对象用户 mid
  • 视频充电：传稿件 avid

impl BpiClient

pub async fn electric_month_up_list( &self, up_mid: i64, ) -> Result<BpiResponse<ChargeMonthUpData>, BpiError>

获取空间充电公示列表

pub async fn electric_video_show( &self, mid: i64, aid: Option<i64>, bvid: Option<&str>, ) -> Result<BpiResponse<VideoElecShowData>, BpiError>

获取视频充电鸣谢名单

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
mid	i64	up 主 mid
aid	Option	稿件 avid
bvid	Option<&str>	稿件 bvid

pub async fn electric_recharge_list( &self, page: u64, page_size: u64, begin_time: Option<NaiveDate>, end_time: Option<NaiveDate>, ) -> Result<BpiResponse<RechargeData>, BpiError>

获取我收到的充电列表 GET https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
page	u64	页数
page_size	u64	分页大小 [1,50]
begin_time	Option	开始日期 YYYY-MM-DD
end_time	Option	结束日期 YYYY-MM-DD

pub async fn electric_rank_recent( &self, pn: Option<u64>, ps: Option<u64>, ) -> Result<BpiResponse<ElecRankData>, BpiError>

获取历史充电数据 GET https://member.bilibili.com/x/h5/elec/rank/recent

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
pn	Option	页数，默认 1
ps	Option	分页大小，默认 10，范围 [1,20]

impl BpiClient

pub async fn electric_message_send( &self, order_id: &str, message: &str, ) -> Result<BpiResponse<Value>, BpiError>

发送充电留言

注意: 此接口需要登录态 (Cookie: SESSDATA)

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
order_id	&str	留言 token
message	&str	留言内容

pub async fn electric_remark_list( &self, pn: Option<u64>, ps: Option<u64>, begin: Option<NaiveDate>, end: Option<NaiveDate>, ) -> Result<BpiResponse<ElecRemarkList>, BpiError>

查询我收到的充电留言 GET https://member.bilibili.com/x/web/elec/remark/list

注意: 此接口需要登录态 (Cookie: SESSDATA)

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
pn	Option	页数，默认 1
ps	Option	分页大小，默认 10，范围 [1,12]
begin	Option	开始日期 YYYY-MM-DD
end	Option	结束日期 YYYY-MM-DD

pub async fn electric_remark_detail( &self, id: u64, ) -> Result<BpiResponse<ElecRemarkDetail>, BpiError>

查询充电留言详情 GET https://member.bilibili.com/x/web/elec/remark/detail

注意: 此接口需要登录态 (Cookie: SESSDATA)

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
id	u64	留言 id

pub async fn electric_remark_reply( &self, id: u64, msg: &str, ) -> Result<BpiResponse<u64>, BpiError>

回复充电留言 POST https://member.bilibili.com/x/web/elec/remark/reply

注意: 此接口需要登录态 (Cookie: SESSDATA)

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
id	u64	留言 id
msg	&str	回复内容

impl BpiClient

pub async fn electric_charge_record( &self, page: u64, charge_type: u32, ) -> Result<BpiResponse<ChargeRecordData>, BpiError>

获取包月充电列表

注意: 此接口需要登录态 (Cookie: SESSDATA)

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
page	u64	页码
charge_type	u32	充电状态：1 使用中，2 已过期

pub async fn electric_upower_item_detail( &self, up_mid: u64, ) -> Result<BpiResponse<UpowerItemDetail>, BpiError>

UP主包月充电详情

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
up_mid	u64	目标用户 mid

pub async fn electric_charge_follow_info( &self, up_mid: u64, ) -> Result<BpiResponse<ChargeFollowInfo>, BpiError>

与UP主的包月充电关系

注意: 此接口需要登录态 (Cookie: SESSDATA)

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
up_mid	u64	目标用户 mid

pub async fn electric_upower_member_rank( &self, up_mid: u64, pn: u64, ps: u64, privilege_type: Option<u64>, ) -> Result<BpiResponse<MemberRankData>, BpiError>

包月充电用户排名

注意: 此接口需要登录态 (Cookie: SESSDATA)

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/electric

参数

名称	类型	说明
up_mid	u64	目标用户 mid
pn	u64	页码
ps	u64	每页项数，最大 101
privilege_type	Option	充电档位代码

impl BpiClient

pub async fn fav_folder_add( &self, title: &str, intro: Option<&str>, privacy: Option<u8>, cover: Option<&str>, ) -> Result<BpiResponse<FavFolderInfo>, BpiError>

新建收藏夹

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
title	&str	收藏夹标题
intro	Option<&str>	介绍
privacy	Option	0 公开，1 私密
cover	Option<&str>	封面 URL

pub async fn fav_folder_edit( &self, media_id: u64, title: &str, intro: Option<&str>, privacy: Option<u8>, cover: Option<&str>, ) -> Result<BpiResponse<FavFolderInfo>, BpiError>

修改收藏夹

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
media_id	u64	收藏夹 media_id
title	&str	标题
intro	Option<&str>	介绍
privacy	Option	0 公开，1 私密
cover	Option<&str>	封面 URL

pub async fn fav_folder_del( &self, media_ids: &[u64], ) -> Result<BpiResponse<i32>, BpiError>

删除收藏夹

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
media_ids	&u64	多个收藏夹 media_id

pub async fn fav_resource_copy( &self, src_media_id: u64, tar_media_id: u64, mid: u64, resources: &str, ) -> Result<BpiResponse<i32>, BpiError>

批量复制内容 resources: “{内容id}:{内容类型},…”

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
src_media_id	u64	源收藏夹 media_id
tar_media_id	u64	目标收藏夹 media_id
mid	u64	用户 mid
resources	&str	形如 “{内容id}:{内容类型},…”

pub async fn fav_resource_move( &self, src_media_id: u64, tar_media_id: u64, mid: u64, resources: &str, ) -> Result<BpiResponse<i32>, BpiError>

批量移动内容 resources: “{内容id}:{内容类型},…”

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
src_media_id	u64	源收藏夹 media_id
tar_media_id	u64	目标收藏夹 media_id
mid	u64	用户 mid
resources	&str	形如 “{内容id}:{内容类型},…”

pub async fn fav_resource_batch_del( &self, media_id: u64, resources: &str, ) -> Result<BpiResponse<i32>, BpiError>

批量删除内容 resources: “{内容id}:{内容类型},…”

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
media_id	u64	收藏夹 media_id
resources	&str	形如 “{内容id}:{内容类型},…”

pub async fn fav_resource_clean( &self, media_id: u64, ) -> Result<BpiResponse<i32>, BpiError>

清空所有失效内容

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
media_id	u64	收藏夹 media_id

impl BpiClient

pub async fn fav_folder_info( &self, media_id: u64, ) -> Result<BpiResponse<FavFolderInfo>, BpiError>

获取收藏夹元数据

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
media_id	u64	收藏夹 media_id

pub async fn fav_created_list( &self, up_mid: u64, typ: Option<u8>, rid: Option<u64>, ) -> Result<BpiResponse<CreatedFolderListData>, BpiError>

获取指定用户创建的所有收藏夹信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
up_mid	u64	用户 mid
typ	Option	类型过滤
rid	Option	关联资源 id

pub async fn fav_collected_list( &self, up_mid: u64, pn: u32, ps: u32, ) -> Result<BpiResponse<CollectedFolderListData>, BpiError>

查询用户收藏的视频收藏夹

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
up_mid	u64	用户 mid
pn	u32	页码
ps	u32	页大小

pub async fn fav_resource_infos( &self, resources: &str, ) -> Result<BpiResponse<Vec<ResourceInfoItem>>, BpiError>

批量获取指定收藏id的内容 resources: “{内容id}:{内容类型},…”

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
resources	&str	形如 “{内容id}:{内容类型},…”

impl BpiClient

pub async fn fav_list_detail( &self, media_id: u64, tid: Option<u32>, keyword: Option<&str>, order: Option<&str>, typ: Option<u8>, ps: u32, pn: Option<u32>, ) -> Result<BpiResponse<FavListDetailData>, BpiError>

获取收藏夹内容明细列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
media_id	u64	收藏夹 media_id
tid	Option	分区 tid
keyword	Option<&str>	关键词过滤
order	Option<&str>	排序，如 mtime
typ	Option	内容类型
ps	u32	每页条数
pn	Option	页码

pub async fn fav_resource_ids( &self, media_id: u64, ) -> Result<BpiResponse<Vec<FavResourceIdItem>>, BpiError>

获取收藏夹全部内容id

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/fav

参数

名称	类型	说明
media_id	u64	收藏夹 media_id

impl BpiClient

pub async fn history_list( &self, max: Option<u64>, business: Option<&str>, view_at: Option<u64>, typ: Option<&str>, ps: Option<u32>, ) -> Result<BpiResponse<HistoryListData>, BpiError>

获取历史记录列表（web端）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

参数

名称	类型	说明
max	Option	截止目标 id（0/avid/ssid/直播间 id/rlid/cvid）
business	Option<&str>	业务类型：archive/pgc/live/article-list/article
view_at	Option	时间戳
typ	Option<&str>	分类筛选：all/archive/live/article 等
ps	Option	每页项数

pub async fn history_delete( &self, kid: &str, ) -> Result<BpiResponse<Value>, BpiError>

删除历史记录

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

参数

名称	类型	说明
kid	&str	记录目标 id

pub async fn history_clear(&self) -> Result<BpiResponse<Value>, BpiError>

清空历史记录

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

pub async fn history_shadow_set( &self, switch: bool, ) -> Result<BpiResponse<Value>, BpiError>

停用历史记录

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

参数

名称	类型	说明
switch	bool	是否停用

pub async fn history_shadow_get(&self) -> Result<BpiResponse<bool>, BpiError>

查询历史记录停用状态

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

impl BpiClient

pub async fn toview_add_video( &self, aid: Option<u64>, bvid: Option<&str>, ) -> Result<BpiResponse<Value>, BpiError>

视频添加稍后再看（最多100个） avid 与 bvid 任选一个

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

参数

名称	类型	说明
aid	Option	稿件 avid
bvid	Option<&str>	稿件 bvid

pub async fn toview_list(&self) -> Result<BpiResponse<ToViewListData>, BpiError>

获取稍后再看视频列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

pub async fn toview_delete( &self, aid: Option<u64>, viewed: Option<bool>, ) -> Result<BpiResponse<Value>, BpiError>

删除稍后再看视频 aid 和 viewed 参数任选一个

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

参数

名称	类型	说明
aid	Option	稿件 avid
viewed	Option	是否删除已观看

pub async fn toview_clear(&self) -> Result<BpiResponse<Value>, BpiError>

清空稍后再看视频列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/historytoview

impl BpiClient

pub async fn live_send_danmu( &self, room_id: u64, message: &str, color: Option<u32>, font_size: Option<u32>, ) -> Result<BpiResponse<SendDanmuData>, BpiError>

发送直播间弹幕

参数

• room_id - 直播间 ID
• message - 弹幕内容
• color - 十进制颜色值，默认 16777215 (白色)
• font_size - 字体大小，默认 25

impl BpiClient

pub async fn live_emoticons( &self, room_id: i64, platform: &str, ) -> Result<EmoticonResponse, BpiError>

获取直播间的表情包

impl BpiClient

pub async fn live_follow_up_list( &self, page: Option<i32>, page_size: Option<i32>, ignore_record: Option<i32>, hit_ab: Option<bool>, ) -> Result<BpiResponse<FollowUpLiveData>, BpiError>

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

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

pub async fn live_follow_up_web_list( &self, hit_ab: Option<bool>, ) -> Result<BpiResponse<LiveWebListData>, BpiError>

获取用户关注的所有UP且正在直播的列表（PC端）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn live_room_gift_list( &self, room_id: i64, area_parent_id: Option<i32>, area_id: Option<i32>, ) -> Result<RoomGiftResponse, BpiError>

获取直播间内礼物

area_parent_id: 直播分区 area_id: 直播子分区 文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

参数

名称	类型	说明
room_id	i64	直播间 ID
area_parent_id	Option	分区 ID
area_id	Option	子分区 ID

pub async fn live_blind_gift_info( &self, gift_id: i64, ) -> Result<BlindGiftResponse, BpiError>

获取盲盒概率

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

参数

名称	类型	说明
gift_id	i64	盲盒礼物 ID

impl BpiClient

pub async fn live_guard_list( &self, room_id: i64, ruid: i64, page: Option<i32>, page_size: Option<i32>, typ: Option<i32>, ) -> Result<GuardListResponse, BpiError>

查询大航海成员

room_id: 直播间号 ruid: 主播id page: 页 page_size: 10~30 [20] typ:3,4,5 周/月/总 亲密度 文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

参数

名称	类型	说明
room_id	i64	直播间号
ruid	i64	主播 id
page	Option	页码，默认 1
page_size	Option	每页 10~30，默认 20
typ	Option	3/4/5：周/月/总 亲密度

impl BpiClient

pub async fn live_room_info( &self, room_id: i64, ) -> Result<BpiResponse<RoomInfoData>, BpiError>

获取直播间信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn live_area_list( &self, ) -> Result<BpiResponse<Vec<LiveParentArea>>, BpiError>

获取全部直播间分区列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn live_gift_types( &self, ) -> Result<BpiResponse<Vec<GiftTypeItem>>, BpiError>

获取所有礼物列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn live_replay_list( &self, page: Option<i32>, page_size: Option<i32>, ) -> Result<BpiResponse<ReplayListData>, BpiError>

获取直播回放列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn live_stream( &self, cid: i64, platform: Option<&str>, quality: Option<i32>, qn: Option<i32>, ) -> Result<BpiResponse<LiveStreamData>, BpiError>

根据真实直播间号获取直播视频流

参数

• cid - 目标真实直播间号（必要），直播间的 room_id（非短号）。

• platform - 播放平台（非必要，默认 web 即 http-flv 方式）。

  • "h5" → HLS 方式
  • "web" → HTTP-FLV 方式

• quality - 画质（非必要，与 qn 二选一）。

  • 2 → 流畅
  • 3 → 高清
  • 4 → 原画

• qn - 画质（非必要，与 quality 二选一）。

  • 80 → 流畅
  • 150 → 高清
  • 250 → 超清
  • 400 → 蓝光
  • 10000 → 原画
  • 20000 → 4K
  • 25000 → 默认
  • 30000 → 杜比 文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn live_create_room( &self, ) -> Result<BpiResponse<CreateRoomData>, BpiError>

开通直播间

pub async fn live_update_room_info( &self, room_id: u64, title: Option<&str>, area_id: Option<u64>, add_tag: Option<&str>, del_tag: Option<&str>, ) -> Result<BpiResponse<UpdateRoomData>, BpiError>

更新直播间信息

参数

• room_id - 直播间 ID
• title - 标题，可选
• area_id - 分区 ID，可选
• add_tag - 要添加的标签，可选
• del_tag - 要删除的标签，可选

pub async fn live_stop( &self, room_id: u64, platform: &str, ) -> Result<BpiResponse<StopLiveData>, BpiError>

关闭直播

参数

• room_id - 直播间 ID
• platform - 直播平台，如 “pc_link”

pub async fn live_update_pre_live_info( &self, title: Option<&str>, cover: Option<&str>, ) -> Result<BpiResponse<UpdatePreLiveInfoData>, BpiError>

预更新直播间信息

参数

• title - 标题，可选
• cover - 封面 URL，可选

pub async fn live_update_room_news( &self, room_id: u64, uid: u64, content: &str, ) -> Result<BpiResponse<Value>, BpiError>

更新直播间公告

参数

• room_id - 直播间 ID
• uid - 用户ID
• content - 公告内容

pub async fn live_version( &self, ) -> Result<BpiResponse<PcLiveVersionData>, BpiError>

获取 PC 直播姬版本号

impl BpiClient

pub async fn live_recommend( &self, ) -> Result<BpiResponse<RecommendData>, BpiError>

主页获取直播推荐

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn live_lottery_info( &self, room_id: i64, ) -> Result<LotteryInfoResponse, BpiError>

获取指定直播间的红包信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

参数

名称	类型	说明
room_id	i64	直播间 ID

impl BpiClient

pub async fn live_web_heart_beat( &self, room_id: i64, next_interval: Option<i32>, platform: Option<&str>, ) -> Result<HeartBeatResponse, BpiError>

直播心跳 (Web端)

对应: https://live-trace.bilibili.com/xlive/rdata-interface/v1/heartbeat/webHeartBeat 文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn live_add_silent_user( &self, room_id: i64, tuid: i64, hour: i32, ) -> Result<BpiResponse<Value>, BpiError>

禁言观众 tuid: 用户uid hour: -1永久 0本场直播

pub async fn live_list_silent_users( &self, room_id: i64, ps: i32, ) -> Result<BpiResponse<SilentUserListData>, BpiError>

查询直播间禁言列表

pub async fn live_del_block_user( &self, roomid: i64, id: i64, ) -> Result<BpiResponse<Value>, BpiError>

解除禁言

impl BpiClient

pub async fn live_my_medals( &self, page: i32, page_size: i32, ) -> Result<MyMedalsResponse, BpiError>

获取自己持有的粉丝勋章信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/live

impl BpiClient

pub async fn logout_web( &self, gourl: Option<&str>, ) -> Result<BpiResponse<LogoutData>, BpiError>

退出登录 (Web端)

参数

• gourl：成功后跳转的 URL，可选，默认 javascript:history.go(-1)

impl BpiClient

pub async fn login_generate_captcha(&self) -> Result<GenerateCaptcha, BpiError>

impl BpiClient

pub async fn login_send_qrcode( &self, ) -> Result<BpiResponse<GenerateQrCodeData>, BpiError>

发送二维码请求

pub async fn login_check_qrcode_status( &self, qrcode_key: &str, ) -> Result<BpiResponse<CheckQrCodeStatusData>, BpiError>

检查二维码状态

impl BpiClient

pub async fn login_send_sms_code( &self, cid: u32, tel: u32, source: &str, token: &str, challenge: &str, validate: &str, seccode: &str, ) -> Result<BpiResponse<SMSSendData>, BpiError>

发送短信验证码（Web端）

参数

• cid - 国际冠字码
• tel - 手机号码
• source - 登录来源 “main_web” 或 “main_mini”
• token - 登录 API token
• challenge - 极验 challenge
• validate - 极验 result
• seccode - 极验 result + “|jordan”

pub async fn login_with_sms( &self, cid: u32, tel: u32, captcha_key: &str, code: &str, ) -> Result<(), String>

短信登录

• cid - 国际冠字码
• tel - 手机号码
• captcha_key - 短信登录 token(基于login_send_sms_code)
• code - 短信验证码 5min过期

impl BpiClient

pub async fn login_info_coin(&self) -> Result<BpiResponse<CoinInfo>, BpiError>

获取账号硬币数

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/login

impl BpiClient

pub async fn login_info_nav_info( &self, ) -> Result<BpiResponse<NavData>, BpiError>

获取导航栏用户信息

pub async fn is_logged_in(&self) -> bool

检查是否已登录

pub async fn login_info_user_info(&self) -> Result<User, BpiError>

获取用户基本信息

impl BpiClient

pub async fn login_info_user_stat( &self, ) -> Result<BpiResponse<UserStat>, BpiError>

获取登录用户状态数（关注/粉丝/动态）

impl BpiClient

pub async fn login_notice( &self, mid: u64, buvid: Option<&str>, ) -> Result<BpiResponse<LoginNoticeData>, BpiError>

查询指定登录记录。

参数

• mid - 用户mid，必须是自己的mid。
• buvid - 可选的设备虚拟ID（web端为buvid3）。

pub async fn login_log(&self) -> Result<BpiResponse<LoginLogData>, BpiError>

查询最近一周的登录情况。

参数

无。该接口自动使用当前登录用户的Session。

impl BpiClient

pub async fn member_center_account_info( &self, ) -> Result<BpiResponse<AccountInfo>, BpiError>

获取我的账号信息 文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/login

impl BpiClient

pub async fn member_center_today_coin_exp( &self, ) -> Result<BpiResponse<u32>, BpiError>

查询每日投币获得经验数

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/login

impl BpiClient

pub async fn member_center_daily_reward( &self, ) -> Result<BpiResponse<DailyReward>, BpiError>

查询每日奖励状态

impl BpiClient

pub async fn member_center_update_user_sign( &self, user_sign: &str, ) -> Result<BpiResponse<Value>, BpiError>

修改个人签名

参数

• user_sign - 要设置的签名内容，最多70个字符。留空表示删除签名

impl BpiClient

pub async fn member_center_vip_info( &self, ) -> Result<BpiResponse<VipInfo>, BpiError>

查询大会员状态

pub async fn is_vip(&self) -> bool

impl BpiClient

pub async fn manga_share_comic(&self) -> Result<ShareComicResponse, BpiError>

分享漫画获取积分

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

impl BpiClient

pub async fn manga_clock_in(&self) -> Result<BpiResponse<Value>, BpiError>

漫画签到

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

pub async fn manga_clock_in_makeup( &self, date: &str, ) -> Result<BpiResponse<Value>, BpiError>

漫画补签

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

参数

名称	类型	说明
date	&str	补签日期，YYYY-MM-DD

pub async fn manga_clock_in_info(&self) -> Result<ClockInInfoResponse, BpiError>

获取漫画签到信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

impl BpiClient

pub async fn manga_buy_episode( &self, request: BuyEpisodeRequest, ) -> Result<BpiResponse<Value>, BpiError>

购买漫画章节

对应: https://manga.bilibili.com/twirp/comic.v1.Comic/BuyEpisode

pub async fn manga_buy_episode_with_coupon( &self, ep_id: i32, coupon_id: i32, ) -> Result<BpiResponse<Value>, BpiError>

使用漫读券购买漫画章节

对应: https://manga.bilibili.com/twirp/comic.v1.Comic/BuyEpisode

pub async fn manga_buy_episode_with_free( &self, comic_id: i32, ep_id: i32, ) -> Result<BpiResponse<Value>, BpiError>

使用新人等免购买漫画章节

对应: https://manga.bilibili.com/twirp/comic.v1.Comic/BuyEpisode

pub async fn manga_buy_episode_with_general_coupon( &self, ep_id: i32, pay_amount: i32, ) -> Result<BpiResponse<Value>, BpiError>

使用通用券购买漫画章节

对应: https://manga.bilibili.com/twirp/comic.v1.Comic/BuyEpisode

impl BpiClient

pub async fn manga_user_point(&self) -> Result<UserPointResponse, BpiError>

获取当前持有点数

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

pub async fn manga_point_products( &self, ) -> Result<ProductListResponse, BpiError>

获取兑换奖品列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

pub async fn manga_point_exchange( &self, product_id: i64, product_num: i32, point: i32, ) -> Result<ExchangeResponse, BpiError>

兑换物品

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

参数

名称	类型	说明
product_id	i64	物品 ID
product_num	i32	兑换数量
point	i32	现价所需点数

impl BpiClient

pub async fn manga_season_info(&self) -> Result<SeasonInfoResponse, BpiError>

获取漫画赛季信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

impl BpiClient

pub async fn manga_coupons( &self, page_num: i32, page_size: i32, ) -> Result<BpiResponse<CouponsData>, BpiError>

获取拥有的漫读券列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/manga

参数

名称	类型	说明
page_num	i32	页码
page_size	i32	分页大小，默认 20，[1,100]

impl BpiClient

pub async fn message_unread_count( &self, ) -> Result<BpiResponse<UnreadCountData>, BpiError>

获取未读消息数。

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/message

pub async fn message_reply_feed( &self, start_id: Option<u64>, start_time: Option<u64>, ) -> Result<BpiResponse<ReplyFeedData>, BpiError>

获取“回复我的“信息列表。

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/message

参数

名称	类型	说明
start_id	Option	起始 ID（上次返回的 cursor.id）
start_time	Option	起始时间戳（上次返回的 cursor.time）

impl BpiClient

pub async fn message_single_unread( &self, unread_type: Option<u32>, show_unfollow_list: Option<u32>, show_dustbin: Option<u32>, ) -> Result<BpiResponse<SingleUnreadData>, BpiError>

获取未读私信数。

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/message

参数

名称	类型	说明
unread_type	Option	未读类型（默认 All）
show_unfollow_list	Option	是否返回未关注推送消息数
show_dustbin	Option	是否返回被拦截私信数

备注：若 unread_type 为 Blocked，show_dustbin 必须为 true。

pub async fn message_send( &self, receiver_id: u64, receiver_type: u32, message_type: MessageType, ) -> Result<BpiResponse<SendMsgData>, BpiError>

发送私信。

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/message

参数

名称	类型	说明
receiver_id	u64	接收者 ID
receiver_type	u32	接收者类型：1 用户，2 粉丝团
message_type	MessageType	消息类型（文本/图片）

impl BpiClient

pub async fn misc_b23_short_link( &self, aid: u64, ) -> Result<BpiResponse<ShortLinkData>, BpiError>

根据视频 aid 生成 b23.tv 短链

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/misc

参数

名称	类型	说明
aid	u64	稿件 avid

impl BpiClient

pub async fn misc_buvid3(&self) -> Result<BpiResponse<Buvid3Data>, BpiError>

获取 buvid3

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/misc

impl BpiClient

pub async fn misc_buvid(&self) -> Result<BpiResponse<BuvidData>, BpiError>

获取 buvid3 / buvid4

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/misc

impl BpiClient

pub async fn misc_sign_bili_ticket( &self, ) -> Result<BpiResponse<TicketData>, BpiError>

生成 bili_ticket

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/misc

pub async fn misc_sign_bili_ticket_string(&self) -> Result<String, BpiError>

仅获取 bili_ticket 字符串

impl BpiClient

pub fn _usage_example()

使用示例：

use your_crate::{Bpi, BpiResult};

async fn example() -> BpiResult<()> {
    let bpi = BpiClient::new();

    // 方法1: 获取完整信息
    let ticket_response = bpi.generate_bili_ticket(None).await?;
    tracing::info!("bili_ticket: {}", ticket_data.ticket);
    tracing::info!("有效期: {} 秒", ticket_data.ttl);

    // 方法2: 仅获取 ticket 字符串
    let ticket = bpi.get_bili_ticket_string(None).await?;
    tracing::info!("bili_ticket: {}", ticket);

    // 方法3: 带 CSRF token
    let ticket_with_csrf = bpi.generate_bili_ticket(Some("your_bili_jct")).await?;

    Ok(())
}

impl BpiClient

pub async fn note_add( &self, oid: u64, title: &str, summary: &str, content: &str, note_id: Option<&str>, tags: Option<&str>, publish: Option<bool>, auto_comment: Option<bool>, ) -> Result<BpiResponse<NoteAddResponseData>, BpiError>

保存视频笔记

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

参数

名称	类型	说明
oid	u64	目标 ID（视频 avid）
title	&str	笔记标题
summary	&str	笔记预览文本
content	&str	笔记正文
note_id	Option<&str>	笔记 ID（创建时可省略）
tags	Option<&str>	跳转标签列表
publish	Option	是否公开：false 不公开，true 公开
auto_comment	Option	是否添加到评论区

pub async fn note_add_simple( &self, oid: u64, title: &str, summary: &str, content: &str, note_id: Option<&str>, ) -> Result<BpiResponse<NoteAddResponseData>, BpiError>

保存视频笔记（精简参数）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

参数

名称	类型	说明
oid	u64	目标 ID（视频 avid）
title	&str	笔记标题
summary	&str	笔记预览文本
content	&str	笔记正文
note_id	Option<&str>	笔记 ID（创建时可省略）

pub async fn note_del( &self, oid: u64, note_id: Option<String>, ) -> Result<BpiResponse<Value>, BpiError>

删除视频笔记

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

参数

名称	类型	说明
oid	u64	目标 ID（视频 avid）
note_id	Option	笔记 ID

impl BpiClient

pub async fn note_is_forbid( &self, aid: u64, ) -> Result<BpiResponse<NoteIsForbidData>, BpiError>

查询该稿件是否禁止笔记

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

• aid: 稿件 avid

pub async fn note_get_private_info( &self, oid: u64, note_id: u64, ) -> Result<BpiResponse<PrivateNoteInfoData>, BpiError>

查询私有笔记内容

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

参数

名称	类型	说明
oid	u64	稿件 avid
note_id	u64	笔记 ID

pub async fn note_get_public_info( &self, cvid: u64, ) -> Result<BpiResponse<PublicNoteInfoData>, BpiError>

查询公开笔记内容

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

• cvid: 公开笔记 cvid

impl BpiClient

pub async fn note_list_archive( &self, oid: u64, ) -> Result<BpiResponse<NoteListArchiveData>, BpiError>

查询稿件私有笔记

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

参数

• oid: 稿件 avid

pub async fn note_list_user_private( &self, pn: u32, ps: u32, ) -> Result<BpiResponse<PrivateNoteListData>, BpiError>

查询用户私有笔记

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

参数

名称	类型	说明
pn	u32	页码
ps	u32	每页数量

pub async fn note_list_public_archive( &self, oid: u64, pn: u32, ps: u32, ) -> Result<BpiResponse<PublicNoteListArchiveData>, BpiError>

查询稿件公开笔记

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

参数

名称	类型	说明
oid	u64	稿件 avid
pn	u32	页码
ps	u32	每页数量

pub async fn note_list_public_user( &self, pn: u32, ps: u32, ) -> Result<BpiResponse<PublicNoteListUserData>, BpiError>

查询用户公开笔记

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/note

参数

名称	类型	说明
pn	u32	页码
ps	u32	每页数量

impl BpiClient

pub async fn opus_space_feed( &self, mid: u64, page: Option<u32>, offset: Option<&str>, typ: Option<&str>, ) -> Result<BpiResponse<SpaceData>, BpiError>

获取用户空间图文

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/opus

参数

名称	类型	说明
mid	u64	用户 UID
page	Option	页码，默认 0
offset	Option<&str>	下一页偏移量
typ	Option<&str>	类型：all/article/dynamic，默认 all

impl BpiClient

pub async fn search_default( &self, ) -> Result<BpiResponse<DefaultSearchData>, BpiError>

获取默认搜索内容（web端）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

pub async fn search_hotwords( &self, ) -> Result<BpiResponse<HotWordDataResponse>, BpiError>

获取热搜列表（web端）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

• 无参数

impl BpiClient

pub async fn search_suggest( &self, term: &str, ) -> Result<BpiResponse<SearchSuggest>, BpiError>

获取搜索建议关键词

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

• term: 搜索关键词

impl BpiClient

pub async fn search_article( &self, keyword: &str, order: Option<SearchOrder>, category_id: Option<CategoryId>, page: Option<i32>, ) -> Result<BpiResponse<SearchData<Vec<Article>>>, BpiError>

搜索专栏

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

名称	类型	说明
keyword	&str	搜索关键词
order	Option	排序方式
category_id	Option	专栏分区
page	Option	页码（默认1）

pub async fn search_bangumi( &self, keyword: &str, page: Option<i32>, ) -> Result<BpiResponse<SearchData<Vec<Bangumi>>>, BpiError>

搜索番剧

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

名称	类型	说明
keyword	&str	搜索关键词
page	Option	页码（默认1）

pub async fn search_bili_user( &self, keyword: &str, order_sort: Option<OrderSort>, user_type: Option<UserType>, page: Option<i32>, ) -> Result<BpiResponse<SearchData<Vec<BiliUser>>>, BpiError>

搜索用户

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

名称	类型	说明
keyword	&str	搜索关键词
order_sort	Option	排序方向：降序/升序
user_type	Option	用户类型筛选
page	Option	页码（默认1）

pub async fn search_live( &self, keyword: &str, page: Option<i32>, ) -> Result<BpiResponse<SearchData<LiveData>>, BpiError>

搜索直播间及主播

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

名称	类型	说明
keyword	&str	搜索关键词
page	Option	页码（默认1）

pub async fn search_live_room( &self, keyword: &str, order: Option<SearchOrder>, page: Option<i32>, ) -> Result<BpiResponse<SearchData<Vec<LiveRoom>>>, BpiError>

搜索直播间

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

名称	类型	说明
keyword	&str	搜索关键词
order	Option	排序方式（默认 online）
page	Option	页码（默认1）

pub async fn search_live_user( &self, keyword: &str, order_sort: Option<OrderSort>, user_type: Option<UserType>, page: Option<i32>, ) -> Result<BpiResponse<SearchData<Vec<LiveUser>>>, BpiError>

搜索主播

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

名称	类型	说明
keyword	&str	搜索关键词
order_sort	Option	排序方向
user_type	Option	主播类型筛选
page	Option	页码（默认1）

pub async fn search_movie( &self, keyword: &str, page: Option<i32>, ) -> Result<BpiResponse<SearchData<Vec<Movie>>>, BpiError>

搜索影视

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

名称	类型	说明
keyword	&str	搜索关键词
page	Option	页码（默认1）

pub async fn search_video( &self, keyword: &str, order: Option<SearchOrder>, duration: Option<Duration>, tids: Option<u32>, page: Option<i32>, ) -> Result<BpiResponse<SearchData<Vec<Video>>>, BpiError>

搜索视频

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/search

参数

名称	类型	说明
keyword	&str	搜索关键词
order	Option	排序方式
duration	Option	时长筛选
tids	Option	分区 ID
page	Option	页码（默认1）

impl BpiClient

pub async fn user_name_to_uid( &self, names: &[&str], ) -> Result<BpiResponse<NameToUidData>, BpiError>

批量查询用户名对应的 UID

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

• names: 用户名列表，多个用户名以逗号分隔

impl BpiClient

pub async fn user_space_info( &self, mid: u64, ) -> Result<BpiResponse<UserSpaceInfo>, BpiError>

获取用户空间详细信息 需要 Wbi 签名认证

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

• mid: 用户 UID

pub async fn user_card_info( &self, mid: u64, photo: Option<bool>, ) -> Result<BpiResponse<UserCardInfo>, BpiError>

获取用户名片信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
mid	u64	用户 UID
photo	Option	是否包含主页头图

pub async fn user_card_info_with_photo( &self, mid: u64, ) -> Result<BpiResponse<UserCardInfo>, BpiError>

获取用户名片信息（包含主页头图）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

• mid: 用户 UID

pub async fn user_card_info_without_photo( &self, mid: u64, ) -> Result<BpiResponse<UserCardInfo>, BpiError>

获取用户名片信息（不包含主页头图）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

• mid: 用户 UID

pub async fn user_cards( &self, mids: &[u64], ) -> Result<BpiResponse<Vec<UserCard>>, BpiError>

批量获取用户卡片（精简信息）

pub async fn user_infos( &self, mids: &[u64], ) -> Result<BpiResponse<Vec<UserInfo>>, BpiError>

批量获取用户详细信息（带大会员/认证信息）

impl BpiClient

pub async fn user_medal_wall( &self, target_id: u64, ) -> Result<BpiResponse<MedalWallData>, BpiError>

获取指定用户的所有粉丝勋章

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

impl BpiClient

pub async fn user_followers( &self, vmid: u64, ps: Option<u32>, pn: Option<u32>, offset: Option<&str>, last_access_ts: Option<u64>, from: Option<&str>, ) -> Result<BpiResponse<FansListResponseData>, BpiError>

查询用户粉丝明细

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
vmid	u64	目标用户 mid
ps	Option	每页项数，默认50
pn	Option	页码，默认1
offset	Option<&str>	偏移量，翻页用
last_access_ts	Option	上次访问时间戳，秒
from	Option<&str>	请求来源，部分场景传“main“

impl BpiClient

pub async fn user_followings( &self, vmid: u64, order_type: Option<&str>, ps: Option<u32>, pn: Option<u32>, ) -> Result<BpiResponse<FollowingListResponseData>, BpiError>

查询用户关注明细

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
vmid	u64	目标用户 mid
order_type	Option<&str>	排序方式，可选
ps	Option	每页项数，默认50
pn	Option	页码，默认1

impl BpiClient

pub async fn user_follow_tags( &self, ) -> Result<BpiResponse<Vec<FollowTag>>, BpiError>

查询关注分组列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

impl BpiClient

pub async fn user_modify_relation( &self, fid: u64, action: RelationAction, source: Option<RelationSource>, ) -> Result<BpiResponse<()>, BpiError>

操作用户关系

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
fid	u64	目标用户 mid
action	RelationAction	操作代码，见 RelationAction 枚举
source	Option	关注来源代码，可选，见 RelationSource 枚举

impl BpiClient

pub async fn user_group_create_tag( &self, group_name: &str, ) -> Result<BpiResponse<CreateTagResponseData>, BpiError>

创建分组

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user/relation/group#创建分组

参数

名称	类型	说明
group_name	&str	分组名，最长16字

pub async fn user_group_update_tag( &self, tag_id: i64, new_name: &str, ) -> Result<BpiResponse<Value>, BpiError>

重命名分组

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user/relation/group#重命名分组

参数

名称	类型	说明
tag_id	i64	分组ID
new_name	&str	新名称，最长16字

pub async fn user_group_delete_tag( &self, tag_id: i64, ) -> Result<BpiResponse<Value>, BpiError>

删除分组

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user/relation/group#删除分组

参数

名称	类型	说明
tag_id	i64	分组ID

pub async fn user_group_add_users_to_tags( &self, fids: &[u64], tagids: &[i64], ) -> Result<BpiResponse<Value>, BpiError>

修改分组成员（添加）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user/relation/group#修改分组成员

参数

名称	类型	说明
fids	&u64	目标用户 mid 列表
tagids	&i64	分组ID列表

pub async fn user_group_remove_users_( &self, fids: &[u64], ) -> Result<BpiResponse<Value>, BpiError>

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user/relation/group#修改分组成员

参数

名称	类型	说明
fids	&u64	目标用户 mid 列表

pub async fn user_group_copy_users_to_tags( &self, fids: &[u64], tagids: &[i64], ) -> Result<BpiResponse<Value>, BpiError>

复制关注到分组

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user/relation/group#复制关注到分组

参数

名称	类型	说明
fids	&u64	用户 mid 列表
tagids	&i64	目标分组ID列表

pub async fn user_group_move_users_to_tags( &self, fids: &[u64], before_tag_ids: &[i64], after_tag_ids: &[i64], ) -> Result<BpiResponse<Value>, BpiError>

移动关注到分组

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user/relation/group#移动关注到分组

参数

名称	类型	说明
fids	&u64	用户 mid 列表
before_tag_ids	&i64	原分组ID列表
after_tag_ids	&i64	新分组ID列表

impl BpiClient

pub async fn user_contributed_videos( &self, mid: u64, order: Option<&str>, tid: Option<u64>, keyword: Option<&str>, pn: Option<u32>, ps: Option<u32>, ) -> Result<BpiResponse<ContributedVideosResponseData>, BpiError>

查询用户投稿视频明细

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
mid	u64	目标用户 UID
order	Option<&str>	排序方式，默认 pubdate
tid	Option	分区筛选，默认 0
keyword	Option<&str>	关键词筛选
pn	Option	页码，默认 1
ps	Option	每页项数，默认 30

impl BpiClient

pub async fn user_space_notice( &self, mid: u64, ) -> Result<BpiResponse<SpaceNoticeResponseData>, BpiError>

获取用户空间公告

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
mid	u64	目标用户 mid

pub async fn user_space_notice_set( &self, notice: Option<&str>, ) -> Result<BpiResponse<()>, BpiError>

修改空间公告

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
notice	Option<&str>	公告内容，少于150字

pub async fn user_bangumi_follow_list( &self, mid: u64, pn: Option<u32>, ps: Option<u32>, list_type: u8, ) -> Result<BpiResponse<BangumiFollowListResponseData>, BpiError>

查询用户追番/追剧明细

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
mid	u64	目标用户 mid
pn	Option	页码，默认1
ps	Option	每页项数，默认15
list_type	u8	查询类型 1:追番 2:追剧

impl BpiClient

pub async fn user_relation_stat( &self, vmid: u64, ) -> Result<BpiResponse<RelationStatResponseData>, BpiError>

获取用户关系状态数

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
vmid	u64	目标用户 mid

pub async fn user_up_stat( &self, mid: u64, ) -> Result<BpiResponse<UpstatResponseData>, BpiError>

获取UP主状态数

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
mid	u64	目标用户 mid

pub async fn user_navnum( &self, mid: u64, ) -> Result<BpiResponse<NavnumResponseData>, BpiError>

获取用户导航栏状态数

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
mid	u64	目标用户 mid

pub async fn user_album_count( &self, uid: u64, ) -> Result<BpiResponse<AlbumCountResponseData>, BpiError>

获取相簿投稿数

文档: https://github.com/SocialSisterYi/bilibili-API-collect/tree/master/docs/user

参数

名称	类型	说明
uid	u64	目标用户 mid

impl BpiClient

pub async fn video_like( &self, aid: Option<u64>, bvid: Option<String>, like: u8, ) -> Result<BpiResponse<CoinData>, BpiError>

点赞/取消点赞

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/action.md

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option	稿件 bvid，可选
like	u8	操作方式 (1:点赞, 2:取消)

pub async fn video_coin( &self, aid: Option<u64>, bvid: Option<String>, multiply: u8, select_like: Option<u8>, ) -> Result<BpiResponse<CoinData>, BpiError>

投币视频

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/action.md

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option	稿件 bvid，可选
multiply	u8	投币数量（上限2）
select_like	Option	是否附加点赞，0:否，1:是，默认0

pub async fn video_favorite( &self, rid: u64, add_media_ids: Option<Vec<&str>>, del_media_ids: Option<Vec<&str>>, ) -> Result<FavoriteResponse, BpiError>

收藏视频

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/action.md

参数

名称	类型	说明
rid	u64	资源ID（视频avid）
add_media_ids	Option<Vec<&str>>	要添加的收藏夹ID列表，可选
del_media_ids	Option<Vec<&str>>	要删除的收藏夹ID列表，可选

impl BpiClient

pub async fn collection_create_and_add_archives( &self, mid: u64, name: &str, keywords: Option<&str>, description: Option<&str>, aids: Option<&str>, ) -> Result<BpiResponse<CreateSeriesResponseData>, BpiError>

创建视频列表并添加视频

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/collection.md

参数

名称	类型	说明
mid	u64	用户 mid
name	&str	标题
keywords	Option<&str>	关键词，可选
description	Option<&str>	简介，可选
aids	Option<&str>	视频 aid 列表，以,分隔，可选

pub async fn collection_delete_series( &self, mid: u64, series_id: u64, ) -> Result<BpiResponse<Value>, BpiError>

删除视频列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/collection.md

参数

名称	类型	说明
mid	u64	用户 mid
series_id	u64	视频列表 ID

pub async fn collection_delete_archives_from_series( &self, mid: u64, series_id: u64, aids: &str, ) -> Result<BpiResponse<Value>, BpiError>

从视频列表中删除稿件

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/collection.md

参数

名称	类型	说明
mid	u64	用户 mid
series_id	u64	视频列表 ID
aids	&str	视频 aid 列表，以,分隔

pub async fn collection_add_archives_to_series( &self, mid: u64, series_id: u64, aids: &str, ) -> Result<BpiResponse<Value>, BpiError>

添加稿件至视频列表

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/collection.md

参数

名称	类型	说明
mid	u64	用户 mid
series_id	u64	视频列表 ID
aids	&str	视频 aid 列表，以,分隔

pub async fn collection_update_series( &self, mid: u64, series_id: u64, name: &str, keywords: Option<&str>, description: Option<&str>, add_aids: Option<&str>, del_aids: Option<&str>, ) -> Result<BpiResponse<Value>, BpiError>

编辑视频列表信息

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/collection.md

参数

名称	类型	说明
mid	u64	用户 mid
series_id	u64	视频列表 ID
name	&str	标题
keywords	Option<&str>	关键词，可选
description	Option<&str>	简介，可选
add_aids	Option<&str>	要添加的视频 aid 列表，以,分隔，可选
del_aids	Option<&str>	要删除的视频 aid 列表，以,分隔，可选

impl BpiClient

pub async fn video_seasons_list( &self, mid: u64, season_id: u64, sort_reverse: Option<bool>, page_num: Option<u64>, page_size: Option<u64>, ) -> Result<BpiResponse<GetSeasonsArchivesData>, BpiError>

获取视频合集信息

此接口用于获取特定UP主某个视频合集的详细信息，包括合集内的所有视频列表和元数据。

参数

• mid - 用户 mid，必填。
• season_id - 视频合集 ID，必填。
• sort_reverse - 排序方式，可选。true: 升序排序，false: 默认排序。
• page_num - 页码索引，可选，默认为 1。
• page_size - 单页内容数量，可选，默认为 30。

pub async fn video_series_list( &self, mid: u64, page_num: u64, page_size: u64, ) -> Result<BpiResponse<GetSeasonsSeriesData>, BpiError>

只获取系列视频列表

此接口用于获取特定UP主创建的系列视频列表。

参数

• mid - 用户 mid，必填。
• page_num - 页码索引，必填。
• page_size - 单页内容数量，必填。

pub async fn video_seasons_series_list( &self, mid: u64, page_num: Option<u64>, page_size: Option<u64>, ) -> Result<BpiResponse<GetSeasonsSeriesData>, BpiError>

获取系列和合集视频列表

此接口用于获取特定UP主创建的系列和合集视频列表，返回结果包含两种类型。

参数

• mid - 用户 mid，必填。
• page_num - 页码索引，可选，默认为 1。
• page_size - 每页数量，可选，默认为 20。

pub async fn video_series_info( &self, series_id: u64, ) -> Result<BpiResponse<GetSeriesData>, BpiError>

查询指定系列信息

此接口用于获取指定系列的基本信息，如名称、描述、总视频数量等。

参数

• series_id - 系列ID，必填。

pub async fn video_series_archives( &self, mid: u64, series_id: u64, only_normal: Option<bool>, sort: Option<&str>, page_num: Option<u64>, page_size: Option<u64>, ) -> Result<BpiResponse<GetSeriesArchivesData>, BpiError>

获取指定系列视频列表

此接口用于获取指定系列内的所有视频列表，支持分页和排序。

参数

• mid - 用户 mid，必填。
• series_id - 系列ID，必填。
• only_normal - 作用尚不明确，可选，默认为 true。
• sort - 排序方式，可选。desc: 默认排序，asc: 升序排序。
• page_num - 页码索引，可选，默认为 1。
• page_size - 每页数量，可选，默认为 20。

impl BpiClient

pub async fn video_desc( &self, aid: Option<u64>, bvid: Option<&str>, ) -> Result<BpiResponse<String>, BpiError>

查询稿件简介

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/info.html#获取稿件简介

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选

两者任选一个

impl BpiClient

pub async fn video_detail( &self, aid: Option<u64>, bvid: Option<&str>, need_elec: Option<u8>, ) -> Result<VideoDetailResponse, BpiError>

获取视频超详细信息 (Web端)

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/video.html#获取视频超详细信息-web端

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选
need_elec	Option	是否获取充电信息 0否 1是，可选

aid 和 bvid 二选一

impl BpiClient

pub async fn video_pagelist( &self, aid: Option<u64>, bvid: Option<&str>, ) -> Result<BpiResponse<Vec<PageItem>>, BpiError>

查询视频分P列表 获取视频cid

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/video.html#查询视频分p列表

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选

两者任选一个

impl BpiClient

pub async fn video_info( &self, aid: Option<u64>, bvid: Option<&str>, ) -> Result<VideoInfoResponse, BpiError>

获取视频详细信息 (Web端)

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/video.html#获取视频详细信息

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选

两者任选一个

impl BpiClient

pub async fn video_interactive_video_info( &self, aid: Option<u64>, bvid: Option<&str>, graph_version: u64, edge_id: Option<u64>, ) -> Result<BpiResponse<InteractiveVideoInfoResponseData>, BpiError>

获取互动视频模块详细信息

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/interact_video.html#获取互动视频信息

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选
graph_version	u64	剧情图 ID
edge_id	Option	模块编号，0或留空为起始模块，可选

aid 和 bvid 必须提供一个。

impl BpiClient

pub async fn video_online_total( &self, aid: Option<u64>, bvid: Option<&str>, cid: u64, ) -> Result<BpiResponse<OnlineTotalResponseData>, BpiError>

获取视频在线人数（web端）

文档: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/video/online.md

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选
cid	u64	视频 cid

aid 和 bvid 必须提供一个。

impl BpiClient

pub async fn video_player_info_v2( &self, aid: Option<u64>, bvid: Option<&str>, cid: u64, season_id: Option<u64>, ep_id: Option<u64>, ) -> Result<BpiResponse<PlayerInfoResponseData>, BpiError>

获取 web 播放器信息

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/player.html#获取web播放器信息

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选
cid	u64	稿件 cid
season_id	Option	番剧 season_id，可选
ep_id	Option	剧集 ep_id，可选

aid 和 bvid 必须提供一个。

impl BpiClient

pub async fn video_related_videos( &self, aid: Option<u64>, bvid: Option<&str>, ) -> Result<BpiResponse<Vec<RelatedVideo>>, BpiError>

获取单视频推荐列表

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/recommend.html#获取单视频推荐列表

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选

aid 和 bvid 必须提供一个。

pub async fn video_homepage_recommendations( &self, ps: Option<u8>, fresh_idx: Option<u32>, fetch_row: Option<u32>, ) -> Result<BpiResponse<RcmdFeedResponseData>, BpiError>

获取首页视频推荐列表

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/recommend.html#获取首页视频推荐列表

参数

名称	类型	说明
ps	Option	单页返回的记录条数，最多30，可选
fresh_idx	Option	当前翻页号，可选，默认1
fetch_row	Option	本次抓取的最后一行行号，可选

impl BpiClient

pub async fn video_report_watch_progress( &self, aid: u64, cid: u64, progress: Option<u64>, ) -> Result<BpiResponse<Value>, BpiError>

上报视频观看进度（双端）

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/report.html#上报视频观看进度

参数

名称	类型	说明
aid	u64	稿件 avid
cid	u64	视频 cid
progress	Option	观看进度，单位为秒，可选，默认0

impl BpiClient

pub async fn video_ai_summary( &self, aid: Option<u64>, bvid: Option<&str>, cid: u64, up_mid: u64, ) -> Result<BpiResponse<AiSummaryResponseData>, BpiError>

获取视频 AI 总结内容

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/summary.html#获取视频ai总结

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选
cid	u64	视频 cid
up_mid	u64	UP主 mid

aid 和 bvid 必须提供一个。

impl BpiClient

pub async fn video_tags( &self, aid: Option<u64>, bvid: Option<&str>, cid: Option<u64>, ) -> Result<BpiResponse<Vec<VideoTag>>, BpiError>

获取视频 TAG 信息（新版）

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/tags.html#获取视频tag信息

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选
cid	Option	分P cid，可选

aid 和 bvid 必须提供一个。

impl BpiClient

pub async fn video_playurl( &self, aid: Option<u64>, bvid: Option<&str>, cid: u64, qn: Option<u64>, fnval: Option<u64>, fnver: Option<u64>, fourk: Option<u8>, platform: Option<&str>, high_quality: Option<u8>, try_look: Option<u8>, ) -> Result<BpiResponse<PlayUrlResponseData>, BpiError>

获取视频流地址（web端）

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video/videostream_url.html#获取视频流地址

参数

名称	类型	说明
aid	Option	稿件 avid，可选
bvid	Option<&str>	稿件 bvid，可选
cid	u64	视频 cid
qn	Option	清晰度选择，可选
fnval	Option	流格式标识，可选，默认1(MP4)
fnver	Option	流版本标识，可选，默认0
fourk	Option	是否允许4K，可选，默认0
platform	Option<&str>	平台标识，可选，默认“pc“
high_quality	Option	是否高画质，可选
try_look	Option	是否可不登录拉取高画质，可选

aid 和 bvid 必须提供一个。

impl BpiClient

pub async fn video_region_dynamic( &self, rid: u32, pn: Option<u32>, ps: Option<u32>, ) -> Result<BpiResponse<RegionArchivesData>, BpiError>

获取分区最新视频列表

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/dynamic.html#获取分区最新视频列表

参数

名称	类型	说明
rid	u32	分区ID
pn	Option	页码，可选
ps	Option	每页数量，可选

pub async fn video_region_tag_dynamic( &self, rid: u32, tag_id: u64, pn: Option<u32>, ps: Option<u32>, ) -> Result<BpiResponse<RegionArchivesData>, BpiError>

获取分区标签近期互动列表

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/dynamic.html#获取分区标签近期互动列表

参数

名称	类型	说明
rid	u32	分区ID
tag_id	u64	标签ID
pn	Option	页码，可选
ps	Option	每页数量，可选

pub async fn video_region_newlist( &self, rid: u32, pn: Option<u32>, ps: Option<u32>, typ: Option<u32>, ) -> Result<BpiResponse<RegionArchivesData>, BpiError>

获取分区近期投稿列表

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/dynamic.html#获取分区近期投稿列表

参数

名称	类型	说明
rid	u32	分区ID
pn	Option	页码，可选
ps	Option	每页数量，可选
typ	Option	类型，可选

pub async fn video_region_newlist_rank( &self, cate_id: u32, order: Option<&str>, page: Option<u32>, pagesize: u32, time_from: &str, time_to: &str, ) -> Result<BpiResponse<NewListRankData>, BpiError>

获取分区近期投稿列表（带排序）

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/dynamic.html#获取分区近期投稿列表带排序

参数

名称	类型	说明
cate_id	u32	分类ID
order	Option<&str>	排序方式，可选
page	Option	页码，可选
pagesize	u32	每页数量
time_from	&str	起始日期(YYYYMMDD)
time_to	&str	结束日期(YYYYMMDD)

impl BpiClient

pub async fn video_popular_list( &self, pn: Option<u32>, ps: Option<u32>, ) -> Result<BpiResponse<PopularListData>, BpiError>

获取当前热门视频列表

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/popular.html#获取当前热门视频列表

参数

名称	类型	说明
pn	Option	页码，可选
ps	Option	每页数量，可选

pub async fn video_popular_series_list( &self, ) -> Result<BpiResponse<PopularSeriesListData>, BpiError>

获取每周必看全部列表

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/popular.html#获取每周必看全部列表

pub async fn video_popular_series_one( &self, number: u32, ) -> Result<BpiResponse<PopularSeriesOneData>, BpiError>

获取每周必看选期详细信息

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/popular.html#获取每周必看选期详细信息

参数

名称	类型	说明
number	u32	期数

impl BpiClient

pub async fn video_popular_precious( &self, ) -> Result<BpiResponse<PreciousVideoData>, BpiError>

获取入站必刷视频

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/precious_videos.html#获取入站必刷视频

impl BpiClient

pub async fn video_ranking_list( &self, rid: Option<u32>, type_name: Option<&str>, ) -> Result<BpiResponse<RankingListData>, BpiError>

获取分区视频排行榜列表

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/ranking.html#获取分区视频排行榜列表

参数

名称	类型	说明
rid	Option	目标分区 tid，默认0(全站)
type_name	Option<&str>	榜单类型 all/rookie/origin，可选

impl BpiClient

pub async fn vip_receive_privilege( &self, type_: u8, ) -> Result<BpiResponse<Value>, BpiError>

兑换大会员卡券

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/vip/action.html#兑换大会员卡券

参数

名称	类型	说明
type_	u8	卡券类型

pub async fn vip_add_experience( &self, ) -> Result<BpiResponse<VipExperienceData>, BpiError>

领取大会员每日经验

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/vip/action.html#领取大会员每日经验

impl BpiClient

pub async fn vip_center_info( &self, ) -> Result<BpiResponse<VipCenterData>, BpiError>

获取大会员中心信息

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/vip/center.html#获取大会员中心信息

impl BpiClient

pub async fn wallet_info(&self) -> Result<BpiResponse<UserWallet>, BpiError>

获取用户钱包信息

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/wallet/info.html#获取用户钱包信息

impl BpiClient

pub async fn web_widget_region_banner( &self, region_id: VideoPartitionV2, ) -> Result<BpiResponse<RegionBannerData>, BpiError>

获取各分区的轮播图（Web端）

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/web_widget/banner.html#获取各分区的轮播图

参数

名称	类型	说明
region_id	VideoPartitionV2	分区 ID

impl BpiClient

pub async fn web_widget_header_page( &self, ) -> Result<BpiResponse<HeaderData>, BpiError>

获取首页头图

文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/web_widget/header.html#获取首页头图

impl BpiClient

pub async fn web_widget_online( &self, ) -> Result<BpiResponse<OnlineData>, BpiError>

获取分区当日投稿稿件数

impl BpiClient

pub fn new() -> &'static Self

pub fn set_account(&self, account: Account)

设置账号信息

pub fn clear_account(&self)

清除账号信息

pub fn set_account_from_cookie_str(&self, cookie_str: &str)

pub fn has_login_cookies(&self) -> bool

检查是否有登录 cookies

pub fn get_account(&self) -> Option<Account>

获取当前账号信息

pub fn csrf(&self) -> Result<String, BpiError>

获取 CSRF token

pub fn get(&self, url: &str) -> RequestBuilder

pub fn post(&self, url: &str) -> RequestBuilder

impl BpiClient

pub fn from_config(config: &Account) -> &Self

从配置创建（如果你仍然需要从外部配置加载）

impl BpiClient

pub async fn get_wbi_sign(&self) -> Result<WbiData, BpiError>

pub async fn get_wbi_sign2<I, K, V>( &self, params: I, ) -> Result<Vec<(String, String)>, BpiError>

where I: IntoIterator<Item = (K, V)>, K: ToString, V: ToString,