Skip to content

用户 ​

用户基本信息、关系(关注/粉丝)、投稿、收藏、历史、动态、追番等信息。多数只读接口免登录;涉及“我的”数据时需要登录 Cookie。

来源声明:本页接口资料整理自开源项目 bilibili-api-python(GPL-3.0)随包提供的 API 数据文件,仅作来源标注。使用前请以哔哩哔哩实际返回为准,并遵守其服务条款。

用户信息 ​

查询 info ​

login_log ​

方法地址鉴权
GEThttps://api.bilibili.com/x/member/web/login/log需登录

moral_log ​

方法地址鉴权
GEThttps://api.bilibili.com/x/member/web/moral/log需登录

exp_log ​

方法地址鉴权
GEThttps://api.bilibili.com/x/member/web/exp/log需登录

name_to_uid ​

方法地址鉴权
GEThttps://api.bilibili.com/x/polymer/web-dynamic/v1/name-to-uid免登录

Query / 表单参数

参数类型说明
namesstring多个名称, 用,分割

my_info 获取自己的信息 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/myinfo需登录

edit_my_info 修改自己的信息 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/member/web/update需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
birthdaystring用户生日
sexstring用户性别
unamestring用户昵称
usersignstring用户签名

info 用户基本信息 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/wbi/acc/info免登录 + WBI 签名 + dm 参数

Query / 表单参数

参数类型说明
midintuid
w_webidstrw_webid

space_notice 用户个人空间公告 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/notice免登录

Query / 表单参数

参数类型说明
midintuid

user_tag 用户关注的 TAG / 话题,认证方式:SESSDATA ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/tag/sub/list免登录

Query / 表单参数

参数类型说明
vmidintuid
pnint页码
psint每页项数

user_top_videos 用户置顶视频 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/top/arc免登录

Query / 表单参数

参数类型说明
vmidintuid

masterpiece 用户代表作 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/masterpiece免登录

Query / 表单参数

参数类型说明
vmidintuid

relation_stat 获取用户关系信息(关注数,粉丝数,悄悄关注,黑名单数) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/stat免登录

Query / 表单参数

参数类型说明
vmidintuid

upstat 视频播放量,文章阅读量,总点赞数 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/upstat免登录

Query / 表单参数

参数类型说明
midintuid

user_medal 读取用户粉丝牌详细信息,如果隐私则不可以 ​

方法地址鉴权
GEThttps://api.live.bilibili.com/xlive/web-ucenter/user/MedalWall需登录

Query / 表单参数

参数类型说明
target_idintuid

live 直播间基本信息 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/wbi/acc/info免登录 + WBI 签名

Query / 表单参数

参数类型说明
midintuid
w_webidstrw_webid

video 搜索用户视频 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/wbi/arc/search免登录 + WBI 签名 + dm 参数

Query / 表单参数

参数类型说明
midintuid
psconst int30
tidint分区 ID,0 表示全部
pnint页码
keywordstr关键词,可为空
w_webidstrw_webid

media_list 以medialist形式获取用户视频列表 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/v2/medialist/resource/list免登录 + WBI 签名

Query / 表单参数

参数类型说明
mobi_appstr定值 web
typeint视频类型,通过uid获取用户视频时为1
biz_idintuid
oidint起始视频 aid, 默认为列表开头
otypeintoid类型, 接受任意值不影响结果
psint每页视频数量, 最大为100
directionbool相对于给定oid的查询方向,true:向列表末尾方向,false:向列表开头方向
descbool列表是否逆序排列
sort_fieldint用于排序的栏 1 发布时间,2 播放量,3 收藏量
tidint分区 ID,0 表示全部, 1 部分(未知),不接受2及以上
with_currentbool返回的列表中是否包含给定oid自身

reservation 获取用户空间预约 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/reservation免登录 + WBI 签名

Query / 表单参数

参数类型说明
vmidintuid

album 相簿 ​

方法地址鉴权
GEThttps://api.vc.bilibili.com/link_draw/v1/doc/doc_list免登录

Query / 表单参数

参数类型说明
uidintuid 此项必须
page_sizeint每页项数 此项必须
page_numint页码
bizstr全部:all 绘画:draw 摄影:photo 日常:daily 默认为 all

audio 音频 ​

方法地址鉴权
GEThttps://api.bilibili.com/audio/music-service/web/song/upper免登录

Query / 表单参数

参数类型说明
uidintuid
psconst int30
pnint页码
orderint1 最新发布,2 最多播放,3 最多收藏

article 专栏 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/wbi/article免登录

Query / 表单参数

参数类型说明
midintuid
psconst int30
pnint页码
sortstrpublish_time 最新发布,publish_time 最多阅读,publish_time 最多收藏

article_lists 专栏文集 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/article/up/lists免登录

Query / 表单参数

参数类型说明
midintuid
sortint0 最近更新,1 最多阅读

dynamic 用户动态信息 ​

方法地址鉴权
GEThttps://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/space_history免登录

Query / 表单参数

参数类型说明
host_uidintuid
offset_dynamic_idint动态偏移用,第一页为 0
need_topint bool是否显示置顶动态

dynamic_new 用户动态信息 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/polymer/web-dynamic/v1/feed/space免登录 + WBI 签名 + dm 参数

Query / 表单参数

参数类型说明
host_midintuid
offsetint动态偏移用,第一页为 0
timezone_offsetint-400
featuresstritemOpusStyle
x-bili-device-req-json.platformstrsweb
x-bili-device-req-json.devicestrpc
x-bili-web-req-json.spm_idstr333.1368

upower_qa_list 用户充电问答列表 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/upower/qa/list需登录

Query / 表单参数

参数类型说明
up_midintuid
anchorint动态偏移用,第一页为 0
privilege_typeint0
fans_filterint0
up_filterint0
psint每页数量
tint时间戳,单位毫秒

upower_qa_detail 用户充电问答 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/upower/qa/info需登录

Query / 表单参数

参数类型说明
qa_idint问答 ID
tint时间戳,单位毫秒

bangumi 用户追番列表 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/bangumi/follow/list免登录

Query / 表单参数

参数类型说明
vmidintuid
pnint页码
psconst int15
typeint1 追番,2 追剧
follow_status—0 全部 1 想看 2 在看 3 看过

followings 获取用户关注列表(不是自己只能访问前 5 页) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/followings需登录

Query / 表单参数

参数类型说明
vmidintuid
psconst int20
pnint页码
orderstrdesc 倒序, asc 正序

all_followings 获取用户所有关注(需要用户公开信息) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/web-interface/attentions需登录

Query / 表单参数

参数类型说明
midintuid

all_followings2 获取用户关注 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/followings需登录

Query / 表单参数

参数类型说明
vmidintuid
orderstrdesc 倒序, asc 正序
order_typestr按照关注顺序排列:留空 按照最常访问排列:attention
pnint页码
psconst int100

followers 获取用户粉丝列表(不是自己只能访问前 5 页,是自己也不能获取全部的样子) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/followers需登录

Query / 表单参数

参数类型说明
vmidintuid
psconst int20
pnint页码
orderstrdesc 倒序, asc 正序

top_followers 粉丝排行 ​

方法地址鉴权
GEThttps://member.bilibili.com/x/web/data/fan免登录

Query / 表单参数

参数类型说明
tintsince when in timestamp(msec)
csrf,csrf_token—要给两个

overview 获取用户的简易订阅和投稿信息(主要是这些的数量统计) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/navnum免登录

Query / 表单参数

参数类型说明
midintuid
jsonpconst strjsonp

self_subscribe_group 获取自己的关注分组列表,用于操作关注 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/tags需登录

get_user_in_which_subscribe_groups 获取用户在哪一个分组 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/tag/user需登录

Query / 表单参数

参数类型说明
fidintuid

history 用户浏览历史记录(旧版) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/v2/history需登录

Query / 表单参数

参数类型说明
pnint页码
psconst int100

history_new 用户浏览历史记录 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/web-interface/history/cursor需登录

Query / 表单参数

参数类型说明
type—all:全部类型(默认)archive:稿件 live:直播 article:文章
view_atint时间戳,获取此时间戳之前的历史记录
business—历史记录截止目标业务类型 默认为空 archive:稿件 pgc:剧集(番剧 / 影视) live:直播 article-list:文集 article:文章
max—历史记录截止目标 oid
psconst int100

channel_list 查看用户合集的列表(新版) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/polymer/web-space/seasons_series_list免登录

Query / 表单参数

参数类型说明
midintuid
page_numint开始项
page_sizeint开始项后面的项数

channel_video_series 查看列表内视频(旧版) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/series/archives免登录

Query / 表单参数

参数类型说明
midintuid
series_idintseries_id
pnint页码
psconst int100

channel_video_season 查看用户合集中的视频(新版) ​

方法地址鉴权
GEThttps://api.bilibili.com/x/polymer/web-space/seasons_archives_list免登录

Query / 表单参数

参数类型说明
midintuid
season_idintseason_id
sort_reversebool是否升序排序,否则默认排序
page_numint页码
page_sizeint每一页的项数

pugv 查看用户的课程 ​

方法地址鉴权
GEThttps://api.bilibili.com/pugv/app/web/season/page免登录

Query / 表单参数

参数类型说明
midintuid

get_coins 获取硬币数量 ​

方法地址鉴权
GEThttps://account.bilibili.com/site/getCoin需登录

events 获取事件 [deprecated] ​

方法地址鉴权
GEThttps://member.bilibili.com/x2/creative/h5/calendar/event需登录

Query / 表单参数

参数类型说明
tsint时间戳

public_notes 获取用户的公开笔记信息 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/note/publish/list/user需登录

Query / 表单参数

参数类型说明
pnint页码
psint每页项数

all_notes 获取用户的笔记信息 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/note/list需登录

Query / 表单参数

参数类型说明
pnint页码
psint每页项数

get_special_followings 获取自己的特别关注 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/tag/special需登录

Query / 表单参数

参数类型说明
pnint页码
psint每页项数

get_whisper_followings 获取自己的悄悄关注 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/whispers需登录

Query / 表单参数

参数类型说明
pnint页码
psint每页项数

get_friends 获取与自己互粉的人 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/friends需登录

get_black_list 获取自己的黑名单列表 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/blacks需登录

Query / 表单参数

参数类型说明
pnint页码
psint每页项数

get_same_followings 获取指定用户和自己共同关注的 up 主 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/relation/same/followings需登录

Query / 表单参数

参数类型说明
vmidintuid
pnint页码
psint每页项数

jury 获取自己风纪委员信息 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/credit/v2/jury/jury需登录

elec_user_monthly 获取空间充电公示列表 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/ugcpay-rank/elec/month/up需登录

Query / 表单参数

参数类型说明
up_midintuid 号

uplikeimg 视频三连特效 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/web-interface/view/uplikeimg需登录

Query / 表单参数

参数类型说明
aidintav 号
vmidintup uid 号

relation 获取与某用户的关系 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/wbi/acc/relation需登录 + WBI 签名

Query / 表单参数

参数类型说明
midintuid

opus ​

方法地址鉴权
GEThttps://api.bilibili.com/x/polymer/web-dynamic/v1/opus/feed/space免登录 + WBI 签名

Query / 表单参数

参数类型说明
host_midintuid
pageint页码 非必要,且貌似对结果影响不大
offsetint动态偏移用,第一页为空
typestrall / article / dynamic
web_location—333.1387
w_webidstrw_webid

操作 operate ​

modify 用户关系操作 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/relation/modify需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
fidintUID
actint1 关注 2 取关 3 悄悄关注 5 拉黑 6 取消拉黑 7 移除粉丝
re_srcconst int11

set_space_notice 修改用户个人空间公告 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/space/notice/set需登录

Query / 表单参数

参数类型说明
noticestrtext ,不必要
csrfstrCSRF Token(位于 cookie),必要

create_subscribe_group 添加关注分组 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/relation/tag/create需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
tagstr分组名

del_subscribe_group 删除关注分组 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/relation/tag/del需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
tagidint分组 id

rename_subscribe_group 重命名分组 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/relation/tag/update需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
tagidint分组 id
namestr新的分组名

set_user_subscribe_group 移动用户到关注分组 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/relation/tags/addUsers需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
fidsintUID
tagidscommaSeparatedList[int]分组的 tagids,逗号分隔

channel_series ​

info 获取简介 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/series/series免登录

Query / 表单参数

参数类型说明
series_idintseries_id

season_info 获取简介 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/space/fav/season/list免登录

Query / 表单参数

参数类型说明
season_idintseason_id

del_channel_aids_series ​

方法地址鉴权
POSThttps://api.bilibili.com/x/series/series/delArchives需登录

Query / 表单参数

参数类型说明
midintuid
series_idintseries_id
aidsintaid 列表

add_channel_aids_series ​

方法地址鉴权
POSThttps://api.bilibili.com/x/series/series/addArchives需登录

Query / 表单参数

参数类型说明
midintuid
series_idintseries_id
aidsintaid 列表

del_channel_series ​

方法地址鉴权
POSThttps://api.bilibili.com/x/series/series/delete需登录

create ​

方法地址鉴权
POSThttps://api.bilibili.com/x/series/series/createAndAddArchives需登录

Query / 表单参数

参数类型说明
midintuid
aidsintaid 列表
name—str
keywords—str,str
description—str

稍后再看 ​

查询 info ​

list 获取稍后再看列表 ​

方法地址鉴权
GEThttps://api.bilibili.com/x/v2/history/toview需登录

操作 operate ​

add 添加视频至稍后再看列表 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/v2/history/toview/add需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
aidintaid
csrfstringbili_jct

del 删除稍后再看列表中的视频 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/v2/history/toview/del需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
aidintaid
viewedbool是否删除已观看的视频

clear 清空稍后再看列表 ​

方法地址鉴权
POSThttps://api.bilibili.com/x/v2/history/toview/clear需登录

请求体(application/x-www-form-urlencoded)

参数类型说明
csrfstringbili_jct