BAC DocumentBAC Document
首页
目录
贡献指南
  • QQ交流群(综合技术交流)
  • Telegram交流群(Github Bot推送)
GitHub
首页
目录
贡献指南
  • QQ交流群(综合技术交流)
  • Telegram交流群(Github Bot推送)
GitHub
  • 用户空间相关

用户空间相关

主页

置顶视频

查询用户置顶视频

https://api.bilibili.com/x/space/top/arc

请求方式:GET

粉丝在其主页上可见

url参数:

参数名类型内容必要性备注
vmidnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
53016:没有置顶视频
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
aidnum稿件avid
videosnum视频分P总数默认为1
tidnum分区tid
tnamestr子分区名称
copyrightnum是否转载1:原创
2:转载
picstr视频封面图片url
titlestr稿件标题
pubdatenum稿件发布时间时间戳
ctimenum用户提交稿件的时间时间戳
descstr视频简介
statenum视频状态略,见获取视频详细信息(web端)中的state备注
attributenum稿件属性位配置略,见获取视频详细信息(web端)中的attribute备注
durationnum视频总计持续时长(所有分P)单位为秒
rightsobj视频属性标志略,见获取视频详细信息(web端)中的rights对象
ownerobj视频UP主信息略,见获取视频详细信息(web端)中的owner对象
statobj视频状态数略,见获取视频详细信息(web端)中的stat对象
dynamicstr视频同步发布的的动态的文字内容无为空
cidnum视频1P cid
dimensionobj视频1P分辨率略,见获取视频详细信息(web端)中的dimension对象
bvidstr稿件bvid
reasonstr置顶视频备注
inter_videobool是否为合作视频false:否
true:是

示例:

查询用户mid=23215368的置顶视频

curl -G 'https://api.bilibili.com/x/space/top/arc' \
--data-urlencode 'vmid=23215368'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "aid": 37896701,
    "videos": 1,
    "tid": 28,
    "tname": "原创音乐",
    "copyright": 1,
    "pic": "http://i2.hdslb.com/bfs/archive/cc9e72822d68fffdd0406144f1b5348a13c89652.jpg",
    "title": "燃烧吧!铃声!把主流手机铃声编成一首曲子",
    "pubdate": 1544469671,
    "ctime": 1544469671,
    "desc": "各品牌的手机铃声大合奏,毫无违和感~",
    "state": 0,
    "attribute": 16768,
    "duration": 208,
    "rights": {
      "bp": 0,
      "elec": 0,
      "download": 0,
      "movie": 0,
      "pay": 0,
      "hd5": 1,
      "no_reprint": 1,
      "autoplay": 1,
      "ugc_pay": 0,
      "is_cooperation": 0,
      "ugc_pay_preview": 0,
      "no_background": 0
    },
    "owner": {
      "mid": 23215368,
      "name": "Wayjon冰冰酱",
      "face": "http://i2.hdslb.com/bfs/face/7c9715f1768191137eb7ebf91918ca0f99532012.jpg"
    },
    "stat": {
      "aid": 37896701,
      "view": 1058237,
      "danmaku": 16821,
      "reply": 3725,
      "favorite": 76888,
      "coin": 100694,
      "share": 17091,
      "now_rank": 0,
      "his_rank": 0,
      "like": 90521,
      "dislike": 0
    },
    "dynamic": "#编曲##FL##纯音乐#",
    "cid": 66621209,
    "dimension": {
      "width": 1920,
      "height": 1080,
      "rotate": 0
    },
    "bvid": "BV18t411q7zz",
    "reason": "",
    "inter_video": false
  }
}

设置置顶视频

https://api.bilibili.com/x/space/top/arc/set

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
aidnum置顶目标稿件avid必要(可选)avid与bvid任选一个
bvidstr置顶目标稿件bvid必要(可选)avid与bvid任选一个
reasonstr置顶视频备注非必要置顶备注最大40字符
默认为空
csrfstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
-304:未修改
-400:请求错误
53014:稿件已失效
53015:备注过长
53017:置顶非自己的稿件
messagestr错误信息默认为0
ttlnum1

示例:

置顶视频av98948772/BV1n741127LD

avid方式:

curl 'https://api.bilibili.com/x/space/top/arc/set' \
--data-urlencode 'aid=98948772' \
-b 'SESSDATA=xxx'

bvid方式:

curl 'https://api.bilibili.com/x/space/top/arc/set' \
--data-urlencode 'bvid=BV1n741127LD' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

取消置顶视频

https://api.bilibili.com/x/space/top/arc/cancel

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
csrfstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误(重复取消)
messagestr错误信息默认为0
ttlnum1

示例:

curl 'https://api.bilibili.com/x/space/top/arc/cancel' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

代表作视频

查询用户代表作视频列表

https://api.bilibili.com/x/space/masterpiece

请求方式:GET

新访客在其主页上可见

最多可以设置3个

url参数:

参数名类型内容必要性备注
vmidnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
messagestr错误信息默认为0
ttlnum1
dataarray代表作列表

data数组:

项类型内容备注
0obj代表作1无则为空
1obj代表作2无则为空
2obj代表作3无则为空
最多设置3个

data数组中的对象:

同查询用户置顶视频中的data对象

示例:

查询用户mid=23215368的代表作视频列表

curl -G 'https://api.bilibili.com/x/space/masterpiece' \
--data-urlencode 'vmid=23215368'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": [{
    "aid": 37896701,
    "videos": 1,
    "tid": 28,
    "tname": "原创音乐",
    "copyright": 1,
    "pic": "http://i2.hdslb.com/bfs/archive/cc9e72822d68fffdd0406144f1b5348a13c89652.jpg",
    "title": "燃烧吧!铃声!把主流手机铃声编成一首曲子",
    "pubdate": 1544469671,
    "ctime": 1544469671,
    "desc": "各品牌的手机铃声大合奏,毫无违和感~",
    "state": 0,
    "attribute": 16768,
    "duration": 208,
    "rights": {
      "bp": 0,
      "elec": 0,
      "download": 0,
      "movie": 0,
      "pay": 0,
      "hd5": 1,
      "no_reprint": 1,
      "autoplay": 1,
      "ugc_pay": 0,
      "is_cooperation": 0,
      "ugc_pay_preview": 0,
      "no_background": 0
    },
    "owner": {
      "mid": 23215368,
      "name": "Wayjon冰冰酱",
      "face": "http://i2.hdslb.com/bfs/face/7c9715f1768191137eb7ebf91918ca0f99532012.jpg"
    },
    "stat": {
      "aid": 37896701,
      "view": 1058241,
      "danmaku": 16821,
      "reply": 3725,
      "favorite": 76888,
      "coin": 100694,
      "share": 17091,
      "now_rank": 0,
      "his_rank": 0,
      "like": 90521,
      "dislike": 0
    },
    "dynamic": "#编曲##FL##纯音乐#",
    "cid": 66621209,
    "dimension": {
      "width": 1920,
      "height": 1080,
      "rotate": 0
    },
    "bvid": "BV18t411q7zz",
    "reason": "",
    "inter_video": false
  }, {
    "aid": 39596658,
    "videos": 1,
    "tid": 21,
    "tname": "日常",
    "copyright": 1,
    "pic": "http://i2.hdslb.com/bfs/archive/431e51d0e40e3461e1c1b0f59c755ae8843b1adb.jpg",
    "title": "MY2018 - 纪念我的2018年",
    "pubdate": 1546328392,
    "ctime": 1546328392,
    "desc": "",
    "state": 0,
    "attribute": 16768,
    "duration": 239,
    "mission_id": 10996,
    "rights": {
      "bp": 0,
      "elec": 0,
      "download": 0,
      "movie": 0,
      "pay": 0,
      "hd5": 1,
      "no_reprint": 1,
      "autoplay": 1,
      "ugc_pay": 0,
      "is_cooperation": 0,
      "ugc_pay_preview": 0,
      "no_background": 0
    },
    "owner": {
      "mid": 23215368,
      "name": "Wayjon冰冰酱",
      "face": "http://i2.hdslb.com/bfs/face/7c9715f1768191137eb7ebf91918ca0f99532012.jpg"
    },
    "stat": {
      "aid": 39596658,
      "view": 1518,
      "danmaku": 16,
      "reply": 40,
      "favorite": 22,
      "coin": 60,
      "share": 9,
      "now_rank": 0,
      "his_rank": 0,
      "like": 112,
      "dislike": 0
    },
    "dynamic": "#vlog##记录##生活记录#",
    "cid": 69561078,
    "dimension": {
      "width": 1920,
      "height": 1080,
      "rotate": 0
    },
    "bvid": "BV1Jt411B7La",
    "reason": "",
    "inter_video": false
  }, {
    "aid": 44721369,
    "videos": 1,
    "tid": 28,
    "tname": "原创音乐",
    "copyright": 1,
    "pic": "http://i0.hdslb.com/bfs/archive/9887797402599c42f74a7624f3db4a92a0ebf465.jpg",
    "title": "【铃声串烧系列】华米两开花;中华有为,国之荣耀!把主流手机铃声编成一首曲子",
    "pubdate": 1551128445,
    "ctime": 1551128445,
    "desc": "把主流手机铃声编成一首曲子,这一版用华为的铃声作为主旋律,毫无违和感~伴随着2019mwc的开幕,希望国产厂商能获得全世界的目光,并且将属于中国人的科技自信传递到全世界!",
    "state": 0,
    "attribute": 16768,
    "duration": 174,
    "rights": {
      "bp": 0,
      "elec": 0,
      "download": 0,
      "movie": 0,
      "pay": 0,
      "hd5": 1,
      "no_reprint": 1,
      "autoplay": 1,
      "ugc_pay": 0,
      "is_cooperation": 0,
      "ugc_pay_preview": 0,
      "no_background": 0
    },
    "owner": {
      "mid": 23215368,
      "name": "Wayjon冰冰酱",
      "face": "http://i2.hdslb.com/bfs/face/7c9715f1768191137eb7ebf91918ca0f99532012.jpg"
    },
    "stat": {
      "aid": 44721369,
      "view": 306757,
      "danmaku": 7713,
      "reply": 1520,
      "favorite": 17216,
      "coin": 16489,
      "share": 2917,
      "now_rank": 0,
      "his_rank": 0,
      "like": 21439,
      "dislike": 0
    },
    "dynamic": "#铃声##纯音乐##音乐#【铃声串烧】Mix Ringtones!船新的版本来啦!这一版用华为的铃声作为主旋律,毫无违和感~伴随着2019mwc的开幕,希望国产厂商能获得全世界的目光,并且将属于中国人的科技自信传递到全世界!",
    "cid": 78290138,
    "dimension": {
      "width": 1920,
      "height": 1080,
      "rotate": 0
    },
    "bvid": "BV1vb411879C",
    "reason": "",
    "inter_video": false
  }]
}

添加代表作视频

https://api.bilibili.com/x/space/masterpiece/add

请求方式:POST

认证方式:Cookie(SESSDATA)

代表作上限为3个稿件

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
aidnum置顶目标稿件avid必要(可选)avid与bvid任选一个
bvidstr置顶目标稿件bvid必要(可选)avid与bvid任选一个
reasonstr代表作备注非必要置顶备注最大40字符
默认为空
csrfstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
53014:稿件已失效
53015:备注过长
53017:置顶非自己的稿件
53019:达到上限
53020:已经存在该稿件
messagestr错误信息默认为0
ttlnum1

示例:

添加视频av94916552/BV1ZE411K7ux到代表作列表

avid方式:

curl 'https://api.bilibili.com/x/space/masterpiece/add' \
--data-urlencode 'aid=94916552' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

bvid方式:

curl 'https://api.bilibili.com/x/space/masterpiece/add' \
--data-urlencode 'bvid=BV1ZE411K7ux' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

删除代表作视频

https://api.bilibili.com/x/space/masterpiece/cancel

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
aidnum要删除的目标稿件avid必要(可选)avid与bvid任选一个
bvidstr要删除的目标稿件bvid必要(可选)avid与bvid任选一个
csrfstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
53021:置顶列表中没有该视频
messagestr错误信息默认为0
ttlnum1作用尚不明确

示例:

删除置顶视频av59765630/BV1Yt41137T6

avid方式:

curl 'https://api.bilibili.com/x/space/masterpiece/cancel' \
--data-urlencode 'aid=59765630' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

bvid方式:

curl 'https://api.bilibili.com/x/space/masterpiece/cancel' \
--data-urlencode 'bvid=BV1Yt41137T6' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

个人TAG

查看用户个人TAG

https://api.bilibili.com/x/space/acc/tags

请求方式:GET

上限5条,且内容由用户自定义

带有转义

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
messagestr错误信息默认为0
ttlnum1
dataarray信息本体

data数组:

项类型内容备注
0obj套了个娃只有1项???

data数组中的对象:

字段类型内容备注
midnum目标用户mid
tagsarrayTAG名称

data数组中的对象中的tags数组:

项类型内容备注
0strTAG1
nstrTAG(n+1)
……str……
4strTAG5上限5条

示例:

查看用户mid=53456的个人TAG

curl -G 'https://api.bilibili.com/x/space/acc/tags' \
--data-urlencode 'mid=53456'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": [
        {
            "mid": 53456,
            "tags": [
                "游戏",
                "音乐",
                "warma",
                "搞笑",
                "动画"
            ]
        }
    ]
}

修改个人TAG

https://api.bilibili.com/x/space/acc/tags/set

请求方式:POST

认证方式:Cookie(SESSDATA)

鉴权方式:Cookie中DedeUserID存在且不为0

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
tagsstrs要设置的TAG内容非必要删除公告留空或省去即可
各TAG长度小于10字符
最多5个TAG
各TAG之间用","(%2C)分隔
重复TAG无效
csrfstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误(超出长度限制)
messagestr错误信息默认为0
ttlnum1

示例:

修改个人TAG为minecraft,技术宅,大佬,小哥哥,可爱

curl 'https://api.bilibili.com/x/space/acc/tags/set' \
--data-urlencode 'tags=minecraft,技术宅,大佬,小哥哥,可爱' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;DedeUserID=1'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

空间公告

查看用户空间公告

https://api.bilibili.com/x/space/notice

请求方式:GET

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
messagestr错误信息默认为0
ttlnum1
datastr公告信息无则为空

示例:

查看用户mid=53456的空间公告

curl -G 'https://api.bilibili.com/x/space/notice' \
--data-urlencode 'mid=53456'
查看响应示例:
{
    "code":0,
    "message":"0",
    "ttl":1,
    "data":"我的微博 @_warma_\n直播录像上传到:warma养鸽场\n头像画师是:微博@Dr-H_喵_\n横幅画师:@薬屋"
}

修改空间公告

https://api.bilibili.com/x/space/notice/set

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
noticestr要设置的公告内容非必要删除公告留空或省去即可
少于150字符
csrfstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
-304:未修改
-400:请求错误(超出长度限制)
messagestr错误信息默认为0
ttlnum1作用尚不明确

示例:

修改个人空间公告为鸽子

curl 'https://api.bilibili.com/x/space/notice/set' \
--data-urlencode 'notice=鸽子' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

主页板块布局与权限

查询空间设置

http://space.bilibili.com/ajax/settings/getSettings

请求方式:GET

注:带有转义

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
statusbool用户是否存在true:存在
false:不存在
data用户存在时:obj
用户不存在时:str
用户存在时:信息本体
用户不存在时:错误信息

data对象:

字段类型内容备注
privacyobj空间隐私权限
index_orderarray空间板块布局
themestrdefault主题?作用尚不明确
theme_preview_img_pathstr主题预览图路径?作用尚不明确
toutuobj空间头图

privacy对象:

字段类型内容备注
banguminum追番及追剧0:隐藏
1:公开
下同
bbqnum轻视频
channelnum频道
coins_videonum最近投币的视频
comicnum追漫
dress_upnum装扮
fav_videonum收藏夹
groupsnum圈子?作用尚不明确
likes_videonum最近点赞的视频
played_gamenum最近玩过的游戏
tagsnum订阅标签
user_infonum个人资料

index_order数组:

项类型内容备注
0obj板块1根据板块布局顺序排序
先左侧布局后右侧布局
nobj板块(n+1)
……obj…………

index_order数组内对象:

字段类型内容备注
idnum板块编号
namestr板块名称

toutu对象:

字段类型内容备注
sidnum空间头图ID
expirenum到期时间?时间戳?
作用尚不明确
s_imgstr空间头图小图相对路径完整url为http://i0.hdslb.com/+相对路径
l_imgstr空间头图相对路径同上
android_imgstr空注:手机端头图与web端不同,需要用另一个api获取
iphone_imgstr空
ipad_imgstr空
thumbnail_imgstr缩略图
platformnum0作用尚不明确

示例:

查看mid=2的空间设置

curl -G 'http://space.bilibili.com/ajax/settings/getSettings' \
--data-urlencode 'mid=2'
查看响应示例:
{
    "status":true,
    "data":{
        "privacy":{
            "bangumi":1,
            "bbq":1,
            "channel":1,
            "coins_video":0,
            "comic":1,
            "dress_up":1,
            "fav_video":0,
            "groups":0,
            "likes_video":0,
            "played_game":1,
            "tags":1,
            "user_info":1
        },
        "index_order":[
            {
                "id":1,
                "name":"我的稿件"
            },
            {
                "id":8,
                "name":"我的专栏"
            },
            {
                "id":7,
                "name":"我的频道"
            },
            {
                "id":2,
                "name":"我的收藏夹"
            },
            {
                "id":3,
                "name":"订阅番剧"
            },
            {
                "id":4,
                "name":"订阅标签"
            },
            {
                "id":5,
                "name":"最近投币的视频"
            },
            {
                "id":6,
                "name":"我的圈子"
            },
            {
                "id":9,
                "name":"我的相簿"
            },
            {
                "id":21,
                "name":"公告"
            },
            {
                "id":22,
                "name":"直播间"
            },
            {
                "id":23,
                "name":"个人资料"
            },
            {
                "id":24,
                "name":"官方活动"
            },
            {
                "id":25,
                "name":"最近玩过的游戏"
            }
        ],
        "theme":"default",
        "theme_preview_img_path":"",
        "toutu":{
            "sid":1,
            "expire":2861874560,
            "s_img":"bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
            "l_img":"bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
            "android_img":"",
            "iphone_img":"",
            "ipad_img":"",
            "thumbnail_img":"",
            "platform":0
        }
    }
}

查询可用头图列表 (Web端)

https://space.bilibili.com/ajax/topphoto/getlist

请求方式: GET

注: 带有转义

URL参数:

参数名类型内容必要性备注
midnum目标用户mid必要非负数, 即使该用户并不存在

JSON回复:

根对象:

字段类型内容备注
statusbool成功: true
失败: false
data成功: array
失败: str
成功: 信息本体
失败: "用户id错误"

data数组中的对象:

字段类型内容备注
idnum空间头图 ID
product_namestr显示名称
pricenum价格
coin_typenum支付类型?
vip_freenum大会员免费
s_imgstr小图 URI需要自行与 i0.hdslb.com 拼接成 URL
l_imgstr大图 URI同 s_img
thumbnail_imgstr空并不存在的缩略图?
sort_numnum排序编号
is_disablenum已禁用0: 未禁用
expirenum过期时间?UNIX 时间戳, 或 0 为永不过期
hadnum是否拥有?当 expire 不为 0 时 为 1, 否则为 0

示例:

查询mid=1145141919810000000的可用空间头图

curl -G "https://space.bilibili.com/ajax/topphoto/getlist" \
--data-urlencode "mid=1145141919810000000"
查看响应示例:
{
  "status": true,
  "data": [
    {
      "id": 1,
      "product_name": "bilibili春",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
      "l_img": "bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
      "thumbnail_img": "",
      "sort_num": 19,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 2,
      "product_name": "两人单车",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/d60a4be11f1bca6168a60a53c64bca18eddd6443.jpg",
      "l_img": "bfs/space/44873d3568bdcb3d850d234e02a19602972450f1.png",
      "thumbnail_img": "",
      "sort_num": 16,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 5,
      "product_name": "成为偶像",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/5fe2632486a5a91a234f0e7cb368ab6397477da4.jpg",
      "l_img": "bfs/space/87277d30cd19edcec9db466a9a3e556aeb0bc0ed.png",
      "thumbnail_img": "",
      "sort_num": 15,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 11,
      "product_name": "星际勘探",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/6849abc6e67000ad807b35a970aba31dd1e400dd.jpg",
      "l_img": "bfs/space/c919a9818172a8297f8b0597722f96504a1e1d88.png",
      "thumbnail_img": "",
      "sort_num": 14,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 10,
      "product_name": "星O大战",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/ff3b0882e55c1099738e59616e5956ad357d9948.jpg",
      "l_img": "bfs/space/e22f5b8e06ea3ee4de9e4da702ce8ef9a2958f5a.png",
      "thumbnail_img": "",
      "sort_num": 13,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 12,
      "product_name": "王牌特工",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/f5d38e2af44fd12fa65423aff55933fcf9071419.jpg",
      "l_img": "bfs/space/8cd85a382756ab938df23a856017abccd187188e.png",
      "thumbnail_img": "",
      "sort_num": 12,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 3,
      "product_name": "仰望星空",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/c9dae917e24b4fc17c4d544caf6b6c0b17f8692b.jpg",
      "l_img": "bfs/space/9ccc0447aebf0656809b339b41aa5b3705f27c47.png",
      "thumbnail_img": "",
      "sort_num": 11,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 14,
      "product_name": "雨过天晴",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/1115b2fdabd128337f892feada4ce32e51f3a5ad.jpg",
      "l_img": "bfs/space/6a1198e25f8764bd30d53411dac9fdf840bc3265.png",
      "thumbnail_img": "",
      "sort_num": 10,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 6,
      "product_name": "绿荫秘境",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/dc02d22a718c1c436f1a355b3cd726b04098ef7d.jpg",
      "l_img": "bfs/space/265ecddc52d74e624dc38cf0cff13317085aedf7.png",
      "thumbnail_img": "",
      "sort_num": 9,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 13,
      "product_name": "漫游仙境",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/184abe52a5ea9390b506c064cfba4f8f20ae9cca.jpg",
      "l_img": "bfs/space/24d0815514951bb108fbb360b04a969441079315.png",
      "thumbnail_img": "",
      "sort_num": 7,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 15,
      "product_name": "放课后time",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/aea2dd7b8894ce31d578d4fad6a7188c7b49cb2f.jpg",
      "l_img": "bfs/space/6e799ff2de2de55d27796707a283068d66cdf3f4.png",
      "thumbnail_img": "",
      "sort_num": 6,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 4,
      "product_name": "昴宿星团",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/1f4eaf70d1bb981f6057b3e440249d7a1f65774f.jpg",
      "l_img": "bfs/space/3ab888c1d149e864ab44802dea8c1443e940fa0d.png",
      "thumbnail_img": "",
      "sort_num": 5,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 7,
      "product_name": "蔷薇洛丽塔",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/718eac8c71e29b8a80431c46110805c3a40e30a6.jpg",
      "l_img": "bfs/space/70ce28bcbcb4b7d0b4f644b6f082d63a702653c1.png",
      "thumbnail_img": "",
      "sort_num": 4,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 9,
      "product_name": "黑暗之门",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/ef1b08e62fdc35b06e39795bc6de8e510935bf97.jpg",
      "l_img": "bfs/space/cd52d4ac1d336c940cc4958120170f7928d9e606.png",
      "thumbnail_img": "",
      "sort_num": 3,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    },
    {
      "id": 19,
      "product_name": "你的名字",
      "price": 0,
      "coin_type": 0,
      "vip_free": 0,
      "s_img": "bfs/space/373e127e8784d3e4c1b5e6db0c27702ba077643f.jpg",
      "l_img": "bfs/space/f49642b3683a08e3190f29d5a095386451f8952c.jpg",
      "thumbnail_img": "",
      "sort_num": 2,
      "is_disable": 0,
      "expire": 0,
      "had": 0
    }
  ]
}

设置空间头图 (Web端)

https://space.bilibili.com/ajax/settings/setToutu

请求方式: POST

认证方式: Cookie (SESSDATA)

鉴权方式: referer为 .bilibili.com 域名下

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
idnum头图 ID必要
csrfstrCSRF Token (即 Cookie bili_jct 值)不必要

JSON回复:

字段类型内容备注
statusbool状态true: 成功
false: 失败
datastr错误信息正确时无此项 (带有转义)

示例:

设置空间头图为为王牌特工(id=12)

curl -X POST "https://space.bilibili.com/ajax/settings/setToutu" \
--referer "https://space.bilibili.com/" \
--data-urlencode "id=12" \
--data-urlencode "csrf=xxx" \
-b "SESSDATA=xxx; bili_jct=xxx"
查看响应示例:
{
  "status": true
}

调整空间板块布局

http://space.bilibili.com/ajax/settings/setIndexOrder

请求方式:POST

认证方式:Cookie(SESSDATA)

鉴权方式:Cookie中DedeUserID及DedeUserID__ckMd5存在且不为0,referer为 .bilibili.com域名下

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
index_ordernums布局列表必要每个值之间用","(%2C)分隔
先左侧布局再右侧布局
值的意义见下表
csrfstrCSRF Token(位于cookie)必要

布局参数index_order:

值含义
1(左侧)我的稿件
2(左侧)我的收藏夹
3(左侧)订阅番剧
4(左侧)订阅标签
5(左侧)最近投币的视频
6(左侧)我的圈子 (此板块被隐藏)
7(左侧)我的频道
8(左侧)我的专栏
9(左侧)我的相簿
21(右侧)公告
22(右侧)直播间
23(右侧)个人资料
24(右侧)官方活动
25(右侧)最近玩的游戏

json回复:

根对象:

字段类型内容备注
statusbool操作结果true:操作成功
false:操作失败
datastr错误信息正确时无此项

示例:

调整空间布局为:

我的稿件            直播间
我的专栏            个人资料
订阅番剧            公告
我的收藏夹          官方活动
我的相簿            最近玩的游戏
最近投币的视频
订阅标签
我的频道
curl 'https://space.bilibili.com/ajax/settings/setIndexOrder' \
--data-urlencode 'index_order=1,8,3,2,9,5,4,7,22,23,21,24,25,6' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;' \
-e 'https://www.bilibili.com'
查看响应示例:
{
    "status": true
}

修改空间隐私权限

http://space.bilibili.com/ajax/settings/setPrivacy

请求方式:POST

认证方式:Cookie(SESSDATA)

鉴权方式:Cookie中DedeUserID及DedeUserID__ckMd5存在且不为0,referer为 .bilibili.com域名下

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
fav_videonum收藏视频非必要0:隐藏
1:公开
下同
banguminum追番及追剧非必要
tagsnum关注的TAG非必要
coins_videonum投币的视频非必要
user_infonum个人信息非必要
played_gamenum玩过的游戏非必要
csrfnstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
statusbool操作结果true:操作成功
false:操作失败
datastr错误信息正确时无此项

示例:

设置关注的TAG为隐藏

curl 'https://space.bilibili.com/ajax/settings/setPrivacy' \
--data-urlencode 'tags=0' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;' \
-e 'https://www.bilibili.com'
查看响应示例:
{
    "status": true
}

查询用户最近访问内容

查询用户最近玩过的游戏

https://api.bilibili.com/x/space/lastplaygame

请求方式:GET

认证方式:Cookie(SESSDATA)

如设置隐私查看自己的需要认证

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
53013:用户隐私设置未公开
messagestr错误信息默认为0
ttlnum1
data隐藏时:null
公开时:array
信息本体

data数组:

项类型内容备注
0obj游戏1
nobj游戏(n+1)项数为总计游戏数
……obj…………

data数组中的对象:

字段类型内容备注
websitestr游戏主页 url
imagestr游戏图标 url
namestr游戏名

示例:

查询mid=2的最近玩过的游戏

curl -G 'https://api.bilibili.com/x/space/lastplaygame' \
  --data-urlencode 'mid=2'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": [
        {
            "website": "https://game.bilibili.com/fgo/event_meihosou",
            "image": "http://i0.hdslb.com/bfs/game/f7d4ee0877089e4079b8f0b4f5c95dd4ceba512a.png",
            "name": "命运-冠位指定(Fate/GO)"
        },
        {
            "website": "https://game.bilibili.com/pcr/xxtix",
            "image": "http://i0.hdslb.com/bfs/game/7922ecea5cc76fe3c8c177e1d4a6c8cf1c36a700.jpg",
            "name": "公主连结Re:Dive"
        },
        {
            "website": "https://game.bilibili.com/dwbgx/",
            "image": "http://i0.hdslb.com/bfs/game/6d5b2df70dfa987408d8d09110cdc327949885e3.png",
            "name": "大王不高兴"
        },
        {
            "website": "https://game.bilibili.com/bangdream/1stanniversary-yxzx/",
            "image": "http://i0.hdslb.com/bfs/game/4a7d0b7272dffe5a489ee935b6bd2d4f7d5f1257.png",
            "name": "BanG Dream!"
        },
        {
            "website": "http://www.biligame.com/detail/?id=101772",
            "image": "http://i0.hdslb.com/bfs/game/8e8b04e7bd2170c2ba2c9f563a62c72bac2eba2c.jpg",
            "name": "明日方舟"
        }
    ]
}

查询用户最近玩过的游戏V2

https://api.bilibili.com/x/space/lastplaygame/v2

请求方式:GET

认证方式:Cookie(SESSDATA)

如设置隐私查看自己的需要认证

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
53013:用户隐私设置未公开
messagestr错误信息默认为0
ttlnum1
data隐藏时:null
公开时:obj
信息本体

data对象:

字段类型内容备注
page_numnum当前页码
page_sizenum每页项数
total_countnum游戏总数
listarray游戏列表

list数组:

项类型内容备注
0obj游戏1
nobj游戏(n+1)项数为总计游戏数
……obj…………

list数组中的对象:

字段类型内容备注
game_base_idnum游戏 idbiligame 的游戏 id
game_namestr游戏名
game_iconstr游戏图标 url
gradenum游戏评分如8.2、6.8
detail_urlstr游戏主页 url
game_tagsarray游戏标签
noticestr游戏简介文案
gift_titlestr游戏礼物文案
game_status_v2num(?)

game_tags数组:

项类型内容备注
0obj游戏标签1如角色扮演、音乐节奏、休闲
nobj游戏标签(n+1)
……obj…………

示例:

查询mid=2的最近玩过的游戏

curl -G 'https://api.bilibili.com/x/space/lastplaygame/v2' \
  --data-urlencode 'mid=2'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "page_num": 0,
    "page_size": 15,
    "total_count": 8,
    "list": [
      {
        "game_base_id": 102567,
        "game_name": "坎特伯雷公主与骑士唤醒冠军之剑的奇幻冒险",
        "game_icon": "https://i0.hdslb.com/bfs/game/fc2f4fd3a347eeb9b8b6ab59d961269bdd05d4e0.png",
        "grade": 8.2,
        "detail_url": "https://www.biligame.com/detail/?id=102567",
        "game_tags": [
          "角色扮演",
          "像素风"
        ],
        "notice": "像素风欢脱冒险RPG",
        "gift_title": "",
        "game_status_v2": 0
      },
      {
        "game_base_id": 101661,
        "game_name": "光·遇",
        "game_icon": "https://i0.hdslb.com/bfs/game/9a1be39915f057597f9328afe503a2bbd0de7754.png",
        "grade": 6.8,
        "detail_url": "https://www.biligame.com/detail/?id=101661",
        "game_tags": [
          "休闲",
          "治愈",
          "唯美"
        ],
        "notice": "九色鹿季开启,探索本真之旅",
        "gift_title": "光·遇九色鹿季回归礼包",
        "game_status_v2": 0
      },
      {
        "game_base_id": 103496,
        "game_name": "原神",
        "game_icon": "https://i0.hdslb.com/bfs/game/2b29383536b3d1a2517bfcb73767f78c242f0458.png",
        "grade": 6.5,
        "detail_url": "https://www.biligame.com/detail/?id=103496",
        "game_tags": [
          "角色扮演",
          "二次元",
          "冒险"
        ],
        "notice": "跨越尘世的探索之旅",
        "gift_title": "bilibili-原神4.4版本独家礼包",
        "game_status_v2": 0
      },
      {
        "game_base_id": 49,
        "game_name": "命运-冠位指定(Fate/GO)",
        "game_icon": "https://i0.hdslb.com/bfs/game/ca5d8d4b3a042beddf7cabca20ae0c946527d1bf.png",
        "grade": 6,
        "detail_url": "https://www.biligame.com/detail/?id=49",
        "game_tags": [
          "卡牌",
          "fate",
          "厨向"
        ],
        "notice": "第2部现已开启!",
        "gift_title": "",
        "game_status_v2": 0
      },
      {
        "game_base_id": 102216,
        "game_name": "公主连结Re:Dive",
        "game_icon": "https://i0.hdslb.com/bfs/game/3bb819e010fe6d594d8f4d417ee380f40e8b5b06.png",
        "grade": 8.4,
        "detail_url": "https://www.biligame.com/detail/?id=102216",
        "game_tags": [
          "角色扮演"
        ],
        "notice": "新角色「璃乃(圣诞节)」登场!",
        "gift_title": "",
        "game_status_v2": 0
      },
      {
        "game_base_id": 168,
        "game_name": "BanG Dream!",
        "game_icon": "https://i0.hdslb.com/bfs/game/d196365d9f112a5adede7eedea1e4154e98c5e53.png",
        "grade": 9.2,
        "detail_url": "https://www.biligame.com/detail/?id=168",
        "game_tags": [
          "音乐节奏",
          "BanG Dream"
        ],
        "notice": "「迎风展翅的我们」活动开启!",
        "gift_title": "",
        "game_status_v2": 0
      },
      {
        "game_base_id": 101772,
        "game_name": "明日方舟",
        "game_icon": "https://i0.hdslb.com/bfs/game/faa556b00d29fffc88281c1ee038b1b7f23aa5c2.jpg",
        "grade": 7.4,
        "detail_url": "https://www.biligame.com/detail/?id=101772",
        "game_tags": [
          "策略",
          "架空文明",
          "末世"
        ],
        "notice": "2023感谢庆典正式开启",
        "gift_title": "",
        "game_status_v2": 0
      },
      {
        "game_base_id": 97,
        "game_name": "碧蓝航线",
        "game_icon": "https://i0.hdslb.com/bfs/game/b141a7690c226a0eae66518c713d3af62613b21d.png",
        "grade": 8.7,
        "detail_url": "https://www.biligame.com/detail/?id=97",
        "game_tags": [
          "养成"
        ],
        "notice": "指挥官,欢迎回港",
        "gift_title": "",
        "game_status_v2": 0
      }
    ]
  }
}

查询用户最近投币视频(Web)

https://api.bilibili.com/x/space/coin/video

请求方式:GET

认证方式:Cookie(SESSDATA)

如设置隐私查看自己的需要认证

url参数:

参数名类型内容必要性备注
vmidnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
53013:用户隐私设置未公开
messagestr错误信息默认为0
ttlnum1
data隐藏时:null
公开时:array
信息本体

data数组:

项类型内容备注
0obj投币视频1
nobj投币视频(n+1)
……obj……

data数组中的对象:

基本与获取视频详细信息(web端)中data对象字段一致

示例:

查看用户mid=15858903的最近投币视频

curl -G 'http://space.bilibili.com/x/space/coin/video' \
  --data-urlencode 'vmid=15858903' \
  -b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": [
        {
            "aid": 669644066,
            "videos": 1,
            "tid": 75,
            "tname": "动物圈",
            "copyright": 2,
            "pic": "http://i1.hdslb.com/bfs/archive/0f73a68b8f449cc72e9ef109685bd295dc0c0c9d.jpg",
            "title": "在人类幼崽身上用尽了温柔",
            "pubdate": 1600608261,
            "ctime": 1600608261,
            "desc": "https://weibo.com/tv/show/1034:4551253766897703?from=old_pc_videoshow",
            "state": 0,
            "attribute": 16384,
            "duration": 29,
            "rights": {
                "bp": 0,
                "elec": 0,
                "download": 0,
                "movie": 0,
                "pay": 0,
                "hd5": 0,
                "no_reprint": 0,
                "autoplay": 1,
                "ugc_pay": 0,
                "is_cooperation": 0,
                "ugc_pay_preview": 0,
                "no_background": 0
            },
            "owner": {
                "mid": 258457966,
                "name": "卧龙寺",
                "face": "http://i2.hdslb.com/bfs/face/f868d1f522733fdcf72a6267e0237157dd0e9948.jpg"
            },
            "stat": {
                "aid": 669644066,
                "view": 3412898,
                "danmaku": 719,
                "reply": 1481,
                "favorite": 21909,
                "coin": 2864,
                "share": 13702,
                "now_rank": 0,
                "his_rank": 0,
                "like": 86970,
                "dislike": 0
            },
            "dynamic": "",
            "cid": 237319289,
            "dimension": {
                "width": 576,
                "height": 1024,
                "rotate": 0
            },
            "bvid": "BV1sa4y1j7jk",
            "coins": 1,
            "time": 1601802763,
            "ip": "",
            "inter_video": false
        },
        {
            "aid": 202267998,
            "videos": 1,
            "tid": 138,
            "tname": "搞笑",
            "copyright": 1,
            "pic": "http://i0.hdslb.com/bfs/archive/ca7746f2207114513f1a421d7f744523275ee679.jpg",
            "title": "充  电  器  の  痛",
            "pubdate": 1601750952,
            "ctime": 1601750952,
            "desc": "这个简介吓到我了!",
            "state": 0,
            "attribute": 16512,
            "duration": 50,
            "mission_id": 14725,
            "rights": {
                "bp": 0,
                "elec": 0,
                "download": 0,
                "movie": 0,
                "pay": 0,
                "hd5": 0,
                "no_reprint": 1,
                "autoplay": 1,
                "ugc_pay": 0,
                "is_cooperation": 0,
                "ugc_pay_preview": 0,
                "no_background": 0
            },
            "owner": {
                "mid": 129922746,
                "name": "-白糖洒一地-",
                "face": "http://i0.hdslb.com/bfs/face/1f581f3b20a380c2fd13ecb8bbe409f8b49c6418.jpg"
            },
            "stat": {
                "aid": 202267998,
                "view": 109,
                "danmaku": 2,
                "reply": 11,
                "favorite": 5,
                "coin": 9,
                "share": 0,
                "now_rank": 0,
                "his_rank": 0,
                "like": 20,
                "dislike": 0
            },
            "dynamic": "",
            "cid": 241861687,
            "dimension": {
                "width": 1920,
                "height": 1080,
                "rotate": 0
            },
            "bvid": "BV1oh411X7iA",
            "coins": 2,
            "time": 1601773750,
            "ip": "",
            "inter_video": false
        },
        {
            "aid": 839722373,
            "videos": 1,
            "tid": 208,
            "tname": "校园学习",
            "copyright": 1,
            "pic": "http://i2.hdslb.com/bfs/archive/11ed53241ceab314c919adba9f85582d24d9313c.jpg",
            "title": "“白piáo”用日语到底怎么说?油管人气日语老师来教你!",
            "pubdate": 1601026026,
            "ctime": 1601026026,
            "desc": "志方老师的B站用语日语课又来了~\n欢迎大家来看哦,\n如果喜欢我们的作品的话,欢迎大家用2~3连+转发来支持我们~\n如果拒绝的话,也可以用日语在评论和弹幕里刷上一波~即可以锻炼日语又可以拒绝我们,岂不美哉~~",
            "state": 0,
            "attribute": 16768,
            "duration": 310,
            "mission_id": 14655,
            "rights": {
                "bp": 0,
                "elec": 0,
                "download": 0,
                "movie": 0,
                "pay": 0,
                "hd5": 1,
                "no_reprint": 1,
                "autoplay": 1,
                "ugc_pay": 0,
                "is_cooperation": 0,
                "ugc_pay_preview": 0,
                "no_background": 0
            },
            "owner": {
                "mid": 677926489,
                "name": "日语志方老师",
                "face": "http://i2.hdslb.com/bfs/face/d465e5cd42e3523a52b3bef38dce7b23627b7723.jpg"
            },
            "stat": {
                "aid": 839722373,
                "view": 130688,
                "danmaku": 1320,
                "reply": 799,
                "favorite": 3722,
                "coin": 5883,
                "share": 339,
                "now_rank": 0,
                "his_rank": 0,
                "like": 17585,
                "dislike": 0
            },
            "dynamic": "志方老师的B站用语日语课又来了~\n欢迎大家来看哦,\n如果喜欢我们的作品的话,欢迎大家用2~3连+转发来支持我们~\n如果拒绝的话,也可以用日语在评论和弹幕里刷上一波~即可以锻炼日语又可以拒绝我们,岂不美哉~~",
            "cid": 238876133,
            "dimension": {
                "width": 1920,
                "height": 1080,
                "rotate": 0
            },
            "bvid": "BV1n54y117kq",
            "coins": 2,
            "time": 1601036198,
            "ip": "",
            "inter_video": false
        }
    ]
}

查询用户最近投币视频(APP)

https://app.bilibili.com/x/v2/space/coinarc

请求方式:GET

认证方式:APP

如设置隐私查看自己的需要认证

url参数:

参数名类型内容必要性备注
access_keystrAPP登录TokenAPP方式必要
appkeystrAPP密钥APP方式必要
vmidnum目标用户mid必要
pnnum页码非必要默认为1
psnum每页项数非必要默认为20

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
countnum投币的视频数
itemarray投币视频列表

item数组:

项类型内容备注
0obj投币的视频信息1
nobj投币的视频信息(n+1)
……obj……

item数组中的对象:

字段类型内容备注
titlestr稿件标题
subtitlestr空
tnamestr空
coverstr封面图片 url
cover_iconstr空
uristrAPP 跳转 uri如bilibili://video/2
paramstr稿件 avid
gotostrav
lengthnum空
durationnum稿件视频长度单位为秒
is_popularbool(?)
is_steinsbool(?)
is_ugcpaybool(?)
is_cooperationstr(?)
is_pgcstr(?)
is_live_playbackstr(?)
is_pugvstr(?)
is_foldnum(?)
playnum播放量
danmakunum弹幕量
ctimenum发布时间时间戳
ugc_paynum0
authorstrUP主昵称
statebooltrue
videosnum0
view_contentstr稿件播放量文案
icon_typenum0
publish_time_textstr空

示例:

用户mid=2的投币列表

curl -G 'https://app.bilibili.com/x/v2/space/coinarc' \
  --data-urlencode 'appkey=1d8b6e7d45233436' \
  --data-urlencode 'access_key=xxx' \
  --data-urlencode 'vmid=2' \
  --data-urlencode 'ps=2' \
  --data-urlencode 'pn=1' \
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "count": 2,
        "item": [
            {
                "title": "请打开麦克风交流",
                "subtitle": "",
                "tname": "",
                "cover": "http://i1.hdslb.com/bfs/archive/cf9aea43b72354ee8c9486e4bf8e07cb38920a65.jpg",
                "cover_icon": "",
                "uri": "bilibili://video/496832459?player_width=1080\u0026player_height=1920\u0026player_rotate=0",
                "param": "496832459",
                "goto": "av",
                "length": "",
                "duration": 134,
                "is_popular": false,
                "is_steins": false,
                "is_ugcpay": false,
                "is_cooperation": false,
                "is_pgc": false,
                "is_live_playback": false,
                "is_pugv": false,
                "is_fold": false,
                "play": 706480,
                "danmaku": 167,
                "ctime": 1706431476,
                "ugc_pay": 0,
                "author": "三个猪鼓励",
                "state": true,
                "videos": 0,
                "view_content": "70.6万",
                "icon_type": 0,
                "publish_time_text": ""
            },
            {
                "title": "【裏命】地球的内部【いよわ】【中文CC字幕】",
                "subtitle": "",
                "tname": "",
                "cover": "http://i0.hdslb.com/bfs/archive/e087224ae4a5ff9ef3f2f6b7644d635276b8f5c6.jpg",
                "cover_icon": "",
                "uri": "bilibili://video/860645391?player_width=1920\u0026player_height=1080\u0026player_rotate=0",
                "param": "860645391",
                "goto": "av",
                "length": "",
                "duration": 264,
                "is_popular": false,
                "is_steins": false,
                "is_ugcpay": false,
                "is_cooperation": false,
                "is_pgc": false,
                "is_live_playback": false,
                "is_pugv": false,
                "is_fold": false,
                "play": 194375,
                "danmaku": 173,
                "ctime": 1669713070,
                "ugc_pay": 0,
                "author": "精神安定剤",
                "state": true,
                "videos": 0,
                "view_content": "19.4万",
                "icon_type": 0,
                "publish_time_text": ""
            }
        ]
    }
}

查询用户最近点赞视频(Web)

https://api.bilibili.com/x/space/like/video

请求方式:GET

认证方式:Cookie(SESSDATA)

如设置隐私查看自己的需要认证

url参数:

参数名类型内容必要性备注
vmidnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
53013:用户隐私设置未公开
messagestr错误信息默认为0
ttlnum1
data隐藏时:null
公开时:array
信息本体

data数组:

项类型内容备注
0obj点赞视频1
nobj点赞视频(n+1)
……obj……

data数组中的对象:

基本与获取视频详细信息(web端)中data对象字段一致

示例:

查看用户mid=15858903的最近点赞视频

curl -G 'http://space.bilibili.com/x/space/like/video' \
  --data-urlencode 'vmid=15858903' \
  -b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "list": [
            {
                "aid": 1700085880,
                "videos": 1,
                "tid": 21,
                "tname": "日常",
                "copyright": 1,
                "pic": "http://i0.hdslb.com/bfs/archive/7fad4ca408c66eb7ea72188f56bcf952306d5807.jpg",
                "title": "你是从什么时候,意识到自己缺爱的呢?",
                "pubdate": 1706706000,
                "ctime": 1706602115,
                "desc": "关于个人情感问题,私信发“2024”我来帮你~",
                "state": 0,
                "duration": 91,
                "mission_id": 4009559,
                "rights": {
                    "bp": 0,
                    "elec": 0,
                    "download": 0,
                    "movie": 0,
                    "pay": 0,
                    "hd5": 0,
                    "no_reprint": 1,
                    "autoplay": 1,
                    "ugc_pay": 0,
                    "is_cooperation": 0,
                    "ugc_pay_preview": 0,
                    "no_background": 0,
                    "arc_pay": 0,
                    "pay_free_watch": 0
                },
                "owner": {
                    "mid": 2104592226,
                    "name": "鲸落艳红尘",
                    "face": "https://i0.hdslb.com/bfs/face/80160fbcf71958e6f5ad3a4fdfa39a55cc0699a5.jpg"
                },
                "stat": {
                    "aid": 1700085880,
                    "view": 930,
                    "danmaku": 1,
                    "reply": 5,
                    "favorite": 18,
                    "coin": 0,
                    "share": 4,
                    "now_rank": 0,
                    "his_rank": 0,
                    "like": 27,
                    "dislike": 0,
                    "vt": 0,
                    "vv": 930
                },
                "dynamic": "",
                "cid": 1424231007,
                "dimension": {
                    "width": 1920,
                    "height": 1080,
                    "rotate": 0
                },
                "short_link_v2": "https://b23.tv/BV1XK421y7ZL",
                "first_frame": "http://i2.hdslb.com/bfs/storyff/n240130sa1k9birz4lwlsm21ya1w3p2c_firsti.jpg",
                "pub_location": "湖北",
                "bvid": "BV1XK421y7ZL",
                "inter_video": false,
                "resource_type": "ugc",
                "subtitle": "",
                "enable_vt": 0
            },
            {
                "aid": 836926413,
                "videos": 1,
                "tid": 21,
                "tname": "日常",
                "copyright": 1,
                "pic": "http://i2.hdslb.com/bfs/archive/dceaf79d1cc4f74ab8cd862f454a8ec4b4a44343.jpg",
                "title": "内心的创伤,是建立深度亲密关系的桥梁!",
                "pubdate": 1706594400,
                "ctime": 1706515438,
                "desc": "关于个人情感问题,私信发“2024”我来帮你~",
                "state": 0,
                "duration": 297,
                "mission_id": 4009559,
                "rights": {
                    "bp": 0,
                    "elec": 0,
                    "download": 0,
                    "movie": 0,
                    "pay": 0,
                    "hd5": 0,
                    "no_reprint": 1,
                    "autoplay": 1,
                    "ugc_pay": 0,
                    "is_cooperation": 0,
                    "ugc_pay_preview": 0,
                    "no_background": 0,
                    "arc_pay": 0,
                    "pay_free_watch": 0
                },
                "owner": {
                    "mid": 2104592226,
                    "name": "鲸落艳红尘",
                    "face": "https://i0.hdslb.com/bfs/face/80160fbcf71958e6f5ad3a4fdfa39a55cc0699a5.jpg"
                },
                "stat": {
                    "aid": 836926413,
                    "view": 1903,
                    "danmaku": 0,
                    "reply": 7,
                    "favorite": 142,
                    "coin": 34,
                    "share": 30,
                    "now_rank": 0,
                    "his_rank": 0,
                    "like": 118,
                    "dislike": 0,
                    "vt": 0,
                    "vv": 1903
                },
                "dynamic": "",
                "cid": 1423127570,
                "dimension": {
                    "width": 1920,
                    "height": 1080,
                    "rotate": 0
                },
                "short_link_v2": "https://b23.tv/BV1xg4y1e7kY",
                "first_frame": "http://i0.hdslb.com/bfs/storyff/n240129qn55at7dr1775k12hp34tw284_firsti.jpg",
                "pub_location": "湖北",
                "bvid": "BV1xg4y1e7kY",
                "inter_video": false,
                "resource_type": "ugc",
                "subtitle": "",
                "enable_vt": 0
            },
            ……
        ]
    }
}

查询用户最近点赞视频(APP)

https://app.bilibili.com/x/v2/space/likearc

请求方式:GET

认证方式:APP

如设置隐私查看自己的需要认证

url参数:

参数名类型内容必要性备注
access_keystrAPP登录TokenAPP方式必要
appkeystrAPP密钥APP方式必要
vmidnum目标用户mid必要
pnnum页码非必要默认为1
psnum每页项数非必要默认为20

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
countnum点赞的视频数
itemarray点赞视频列表

item数组:

项类型内容备注
0obj点赞的视频信息1
nobj点赞的视频信息(n+1)
……obj……

item数组中的对象:

字段类型内容备注
titlestr稿件标题
subtitlestr空
tnamestr空
coverstr封面图片 url
cover_iconstr空
uristrAPP 跳转 uri如bilibili://video/2
paramstr稿件 avid
gotostrav
lengthnum空
durationnum稿件视频长度单位为秒
is_popularbool(?)
is_steinsbool(?)
is_ugcpaybool(?)
is_cooperationstr(?)
is_pgcstr(?)
is_live_playbackstr(?)
is_pugvstr(?)
is_foldnum(?)
playnum播放量
danmakunum弹幕量
ctimenum发布时间时间戳
ugc_paynum0
authorstrUP主昵称
statebooltrue
videosnum0
view_contentstr稿件播放量文案
icon_typenum0
publish_time_textstr空

示例:

用户mid=2的点赞列表

curl -G 'https://app.bilibili.com/x/v2/space/likearc' \
  --data-urlencode 'appkey=1d8b6e7d45233436' \
  --data-urlencode 'access_key=xxx' \
  --data-urlencode 'vmid=2' \
  --data-urlencode 'ps=2' \
  --data-urlencode 'pn=1' \
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "count": 2,
        "item": [
            {
                "title": "兄弟难舍也难分",
                "subtitle": "",
                "tname": "",
                "cover": "http://i1.hdslb.com/bfs/archive/58f031a52eab6d5faec5a39dfaab5728f65672d5.jpg",
                "cover_icon": "",
                "uri": "bilibili://video/624351941?player_width=1080\u0026player_height=1920\u0026player_rotate=0",
                "param": "624351941",
                "goto": "av",
                "length": "",
                "duration": 216,
                "is_popular": false,
                "is_steins": false,
                "is_ugcpay": false,
                "is_cooperation": false,
                "is_pgc": false,
                "is_live_playback": false,
                "is_pugv": false,
                "is_fold": false,
                "play": 423652,
                "danmaku": 362,
                "ctime": 1706320200,
                "ugc_pay": 0,
                "author": "甜蜜老张",
                "state": true,
                "videos": 0,
                "view_content": "42.4万",
                "icon_type": 0,
                "publish_time_text": ""
            },
            {
                "title": "技能搭配不累,共赴热血团战!",
                "subtitle": "",
                "tname": "",
                "cover": "http://i2.hdslb.com/bfs/archive/2094b8e0be819222d320e2841ee1c39f5f2e4357.jpg",
                "cover_icon": "",
                "uri": "bilibili://video/793597196?player_width=1280\u0026player_height=720\u0026player_rotate=0",
                "param": "793597196",
                "goto": "av",
                "length": "",
                "duration": 41,
                "is_popular": false,
                "is_steins": false,
                "is_ugcpay": false,
                "is_cooperation": false,
                "is_pgc": false,
                "is_live_playback": false,
                "is_pugv": false,
                "is_fold": false,
                "play": 1237,
                "danmaku": 2,
                "ctime": 1704855559,
                "ugc_pay": 0,
                "author": "38047aa1-cb8a-4",
                "state": true,
                "videos": 0,
                "view_content": "1237",
                "icon_type": 0,
                "publish_time_text": ""
            }
        ]
    }
}

投稿

查询用户投稿视频明细

https://api.bilibili.com/x/space/wbi/arc/search

https://api.bilibili.com/x/space/arc/search (已废弃,保留是方便遇到问题的人搜索到此处)

请求方式:GET

鉴权方式:Wbi 签名

另见 根据关键词查找视频, 功能基本相同, 暂未发现风控校验

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要
orderstr排序方式非必要默认为pubdate
最新发布:pubdate
最多播放:click
最多收藏:stow
tidnum筛选目标分区非必要默认为0
0:不进行分区筛选
分区tid为所筛选的分区
keywordstr关键词筛选非必要用于使用关键词搜索该UP主视频稿件
pnnum页码非必要默认为 1
psnum每页项数非必要默认为 30

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
-412:请求被拦截
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
listobj列表信息
pageobj页面信息
episodic_buttonobj“播放全部“按钮
is_riskbool
gaia_res_typenum
gaia_dataobj

data中的list对象:

字段类型内容备注
slistarray空数组
tlistobj投稿视频分区索引
vlistarray投稿视频列表

list中的tlist对象:

字段类型内容备注
{tid}obj该分区的详情字段名为存在的分区tid
……obj……向下扩展

tlist中的{tid}对象:

字段类型内容备注
countnum投稿至该分区的视频数
namestr该分区名称
tidnum该分区tid

list中的vlist数组:

项类型内容备注
0obj投稿视频1
nobj投稿视频(n+1)
……obj…………

list中的vlist数组中的对象:

字段类型内容备注
aidnum稿件avid
attributenum
authorstr视频UP主不一定为目标用户(合作视频)
bvidstr稿件bvid
commentnum视频评论数
copyrightstr视频版权类型
creatednum投稿时间时间戳
descriptionstr视频简介
elec_arc_typenum充电为1,否则0可能还有其他情况
enable_vtnum0作用尚不明确
hide_clickboolfalse作用尚不明确
is_avoidednum0作用尚不明确
is_charging_arcbool是否为充电视频
is_lesson_videonum是否为课堂视频0:否
1:是
is_lesson_finishednum课堂是否已完结0:否
1:是
is_live_playbacknum是否为直播回放0:否
1:是
is_paynum0作用尚不明确
is_self_viewboolfalse作用尚不明确
is_steins_gatenum是否为互动视频0:否
1:是
is_union_videonum是否为合作视频0:否
1:是
jump_urlstr跳转链接跳转到课堂的链接,否则为""
lengthstr视频长度MM:SS
midnum视频UP主mid不一定为目标用户(合作视频)
metaobj所属合集或课堂无数据时为 null
picstr视频封面
playnum视频播放次数
playback_positionnum百分比播放进度封面下方显示的粉色条
reviewnum0作用尚不明确
season_idnum合集或课堂编号都不属于时为0
subtitlestr空作用尚不明确
titlestr视频标题
typeidnum视频分区tid
video_reviewnum视频弹幕数
vtnum0作用尚不明确
vt_displaystr空作用尚不明确

list中的vlist数组中的对象中的meta对象:

字段类型内容备注
attributenum0作用尚不明确
coverstr合集封面URL
ep_countnum合集视频数量
ep_numnum合集视频数量
first_aidnum首个视频av号
idnum合集id
introstr合集介绍
midnumUP主uid若为课堂,则为0
ptimenumunix时间(s)最后更新时间
sign_statenum0作用尚不明确
statobj合集统计数据
titlestr合集名称

list中的vlist数组中的对象中的meta对象中的stat对象:

字段类型内容备注
coinnum合集总投币数
danmakunum合集总弹幕数
favoritenum合集总收藏数
likenum合集总点赞数
mtimenumunix时间(s)其他统计数据更新时间
replynum合集总评论数
season_idnum合集id
sharenum合集总分享数
viewnum合集总播放量
vtnum0作用尚不明确
vvnum0作用尚不明确

data中的page对象:

字段类型内容备注
countnum总计稿件数
pnnum当前页码
psnum每页项数

data中的episodic_button对象:

字段类型内容备注
textstr按钮文字
uristr全部播放页url

示例:

pn(页码)和ps(每页项数)只改变vlist中成员的多少与内容

以每页2项查询用户mid=53456的第1页投稿视频明细

curl -G 'https://api.bilibili.com/x/space/arc/search' \
--data-urlencode 'mid=53456' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1'
查看响应示例:
{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"list": {
			"slist": [],
			"tlist": {
				"1": {
					"tid": 1,
					"count": 3,
					"name": "动画"
				},
				"129": {
					"tid": 129,
					"count": 1,
					"name": "舞蹈"
				},
				"160": {
					"tid": 160,
					"count": 96,
					"name": "生活"
				},
				"177": {
					"tid": 177,
					"count": 4,
					"name": "纪录片"
				},
				"181": {
					"tid": 181,
					"count": 50,
					"name": "影视"
				},
				"188": {
					"tid": 188,
					"count": 444,
					"name": "科技"
				},
				"196": {
					"tid": 196,
					"count": 2,
					"name": "课堂"
				}
			},
			"vlist": [{
				"comment": 985,
				"typeid": 250,
				"play": 224185,
				"pic": "http://i0.hdslb.com/bfs/archive/5e56c10a9bd67f2fcac46fdd0fc2caa8769700c8.jpg",
				"subtitle": "",
				"description": "这一次,我们的样片日记首次来到了西藏,在桃花季开启了藏东样片之旅!这趟“开荒”之旅我们跋山涉水,一路硬刚,多亏有路虎卫士这样的神队友撑全场!这次的素材我们也上传到了官网(ysjf.com/material),欢迎大家去看看~如果你喜欢这期视频,请多多支持我们,并把视频分享给你的朋友们一起看看!",
				"copyright": "1",
				"title": "和朋友去西藏拍样片日记……",
				"review": 0,
				"author": "影视飓风",
				"mid": 946974,
				"created": 1745290800,
				"length": "22:11",
				"video_review": 2365,
				"aid": 114375683741573,
				"bvid": "BV1ac5yzhE94",
				"hide_click": false,
				"is_pay": 0,
				"is_union_video": 1,
				"is_steins_gate": 0,
				"is_live_playback": 0,
				"is_lesson_video": 0,
				"is_lesson_finished": 0,
				"lesson_update_info": "",
				"jump_url": "",
				"meta": {
					"id": 2046621,
					"title": "样片日记",
					"cover": "https://archive.biliimg.com/bfs/archive/e2ca3e5a6672cf35c9e61ac02e8d739cc0aafa8b.jpg",
					"mid": 946974,
					"intro": "",
					"sign_state": 0,
					"attribute": 140,
					"stat": {
						"season_id": 2046621,
						"view": 31755096,
						"danmaku": 171253,
						"reply": 33685,
						"favorite": 409505,
						"coin": 935105,
						"share": 199467,
						"like": 1791607,
						"mtime": 1745309513,
						"vt": 0,
						"vv": 0
					},
					"ep_count": 13,
					"first_aid": 238588630,
					"ptime": 1745290800,
					"ep_num": 13
				},
				"is_avoided": 0,
				"season_id": 2046621,
				"attribute": 16793984,
				"is_charging_arc": false,
				"elec_arc_type": 0,
				"vt": 0,
				"enable_vt": 0,
				"vt_display": "",
				"playback_position": 0,
				"is_self_view": false
			}, {
				"comment": 0,
				"typeid": 197,
				"play": 8506,
				"pic": "https://archive.biliimg.com/bfs/archive/489f3df26a190a152ad479bfe50a73f1cd4c43c5.jpg",
				"subtitle": "",
				"description": "8节课,Tim和青青带你用iPhone拍出电影感",
				"copyright": "1",
				"title": "【影视飓风】只看8节课,用iPhone拍出电影感",
				"review": 0,
				"author": "影视飓风",
				"mid": 946974,
				"created": 1744865737,
				"length": "00:00",
				"video_review": 9,
				"aid": 114351440726681,
				"bvid": "BV1WB5ezxEnz",
				"hide_click": false,
				"is_pay": 0,
				"is_union_video": 0,
				"is_steins_gate": 0,
				"is_live_playback": 0,
				"is_lesson_video": 1,
				"is_lesson_finished": 1,
				"lesson_update_info": "8",
				"jump_url": "https://www.bilibili.com/cheese/play/ss190402215",
				"meta": {
					"id": 190402215,
					"title": "【影视飓风】只看8节课,用iPhone拍出电影感",
					"cover": "https://archive.biliimg.com/bfs/archive/489f3df26a190a152ad479bfe50a73f1cd4c43c5.jpg",
					"mid": 0,
					"intro": "",
					"sign_state": 0,
					"attribute": 0,
					"stat": {
						"season_id": 190402215,
						"view": 1111222,
						"danmaku": 1853,
						"reply": 0,
						"favorite": 0,
						"coin": 0,
						"share": 0,
						"like": 0,
						"mtime": 0,
						"vt": 0,
						"vv": 0
					},
					"ep_count": 0,
					"ptime": 1744865737,
					"ep_num": 0
				},
				"is_avoided": 0,
				"season_id": 190402215,
				"attribute": 1073758592,
				"is_charging_arc": false,
				"elec_arc_type": 0,
				"vt": 0,
				"enable_vt": 0,
				"vt_display": "",
				"playback_position": 0,
				"is_self_view": false
			}]
		},
		"page": {
			"pn": 1,
			"ps": 42,
			"count": 786
		},
		"episodic_button": {
			"text": "播放全部",
			"uri": "//www.bilibili.com/medialist/play/946974?from=space"
		},
		"is_risk": false,
		"gaia_res_type": 0,
		"gaia_data": null
	}
}

查询用户投稿相簿预览

相簿功能已下线, 以下接口失效, 参见 #801

https://api.bilibili.com/x/space/album/index

请求方式:GET

所有类型的相簿

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要
psnum获取的相簿量非必要默认为8 定义域 1-大于1700 (注意滥用风险)

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
messagestr错误信息默认为0
ttlnum1
dataarray相簿列表

data数组:

项类型内容备注
0obj相簿内容1
nobj相簿内容(n+1)
……obj…………

data数组中的对象:

字段类型内容备注
countnum总计图片数
ctimenum发布时间时间戳
descriptionstr简介
doc_idnum相簿id非动态!!!
likenum点赞数
picturesarray图片内容
poster_uidnum上传用户mid
titlestr标题动态内容无
viewnum浏览数

data数组中的对象中的pictures数组:

项类型内容备注
0obj内容图片1
nobj内容图片(n+1)项数取决于count的值
……obj…………

pictures数组中的对象:

字段类型内容备注
img_heightnum图片高度
img_sizenum图片大小单位为KByte
img_srcstr图片url
img_widthnum图片宽度

示例:

查询用户mid=53456的投稿相簿预览

curl -G 'https://api.bilibili.com/x/space/album/index' \
--data-urlencode 'mid=53456' \
--data-urlencode 'ps=2'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": [{
    "doc_id": 60470424,
    "poster_uid": 53456,
    "title": "",
    "description": "你醒啦![tv_大佬]\n之前说到过的百万粉纪念的视频已经定时在了今天下午七点,欢迎来看呀!",
    "pictures": [{
      "img_src": "https://i0.hdslb.com/bfs/album/2840366e30bf7c0aba9da5adde1a771255a57bc7.jpg",
      "img_width": 625,
      "img_height": 134,
      "img_size": 14
    }],
    "count": 1,
    "ctime": 1583444859,
    "view": 1677521,
    "like": 29974
  }, {
    "doc_id": 58962388,
    "poster_uid": 53456,
    "title": "",
    "description": "上次的那些写实儿童画发出来啦!可以打印下来辟邪[tv_大佬]",
    "pictures": [{
      "img_src": "https://i0.hdslb.com/bfs/album/8acaf7c7897cb858cccab36c33a5e875adfef177.jpg",
      "img_width": 2172,
      "img_height": 3258,
      "img_size": 2831
    }, {
      "img_src": "https://i0.hdslb.com/bfs/album/1611b6b56d3d4328889a62b9f9bdc92e9d065532.jpg",
      "img_width": 3456,
      "img_height": 5184,
      "img_size": 3024
    }, {
      "img_src": "https://i0.hdslb.com/bfs/album/f3a30a2ef5b39711af8b945d54d85ffd1e932b8a.jpg",
      "img_width": 1200,
      "img_height": 757,
      "img_size": 313
    }],
    "count": 3,
    "ctime": 1582881332,
    "view": 1176646,
    "like": 25734
  }]
}

查询用户投稿相簿明细

相簿功能已下线, 以下接口失效

https://api.vc.bilibili.com/link_draw/v1/doc/doc_list https://api.bilibili.com/x/dynamic/feed/draw/doc_list

请求方式:GET

url参数:

参数名类型内容必要性备注
uidnum目标用户mid必要
page_numnum页码必要默认为0
page_sizenum每页项数必要默认为30
bizstr查询类型非必要全部:all
绘画:draw
摄影:photo
日常:daily
默认为all

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
msgstr错误信息默认为success
messagestr错误信息默认为success
dataobj信息本体

data对象:

字段类型内容备注
itemsarray相簿列表

items数组:

项类型内容备注
0obj相簿内容1
nobj相簿内容(n+1)
……obj…………

items数组中的对象:

字段类型内容备注
countnum总计图片数
ctimenum发布时间时间戳
descriptionstr简介
doc_idnum相簿id非动态!!!
likenum点赞数
picturesarray图片内容
poster_uidnum上传用户mid
titlestr标题动态内容无
viewnum浏览数

items数组中的对象中的pictures数组:

项类型内容备注
0obj内容图片1
nobj内容图片(n+1)项数取决于count的值
……obj…………

pictures数组中的对象:

字段类型内容备注
img_heightnum图片高度
img_sizenum图片大小单位为KByte
img_srcstr图片url
img_widthnum图片宽度

示例:

查询用户mid=53456的投稿明细中的全部类型

curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \
--data-urlencode 'uid=2' \
--data-urlencode 'page_num=1' \
--data-urlencode 'page_size=2' \
--data-urlencode 'biz=all'
查看响应示例:
{
  "code": 0,
  "msg": "success",
  "message": "success",
  "data": {
    "items": [{
      "doc_id": 59015720,
      "poster_uid": 2,
      "title": "",
      "description": "6影是真的无脑,2个宝石都护不住(设计师:这真是太酷了)",
      "pictures": [{
        "img_src": "http://i0.hdslb.com/bfs/album/8456f050ec8639c6e0cef36aba27bfdedc550590.jpg",
        "img_width": 1824,
        "img_height": 840,
        "img_size": 1024
      }],
      "count": 1,
      "ctime": 1582894607,
      "view": 707073,
      "like": 7055
    }, {
      "doc_id": 46853140,
      "poster_uid": 2,
      "title": "",
      "description": "#年度报告# #新年Flag# https://www.bilibili.com/blackboard/timemachine2019.html\n决定了,这就是我的新年Flag!今年我一定要…",
      "pictures": [{
        "img_src": "http://i0.hdslb.com/bfs/album/5b3ae76f79d7cf2501afc3ca7c7da509dcf0e38a.jpg",
        "img_width": 1125,
        "img_height": 2184,
        "img_size": 465
      }, {
        "img_src": "http://i0.hdslb.com/bfs/album/87789fe9644337a1f7e6a0655a32584705af8bda.jpg",
        "img_width": 1125,
        "img_height": 2184,
        "img_size": 421
      }, {
        "img_src": "http://i0.hdslb.com/bfs/album/f752d7f3bb7952f6c0013b3f48ddcb07060b4721.jpg",
        "img_width": 1125,
        "img_height": 2184,
        "img_size": 524
      }, {
        "img_src": "http://i0.hdslb.com/bfs/active/7a52a411bccb716c8e67fe70e6c330d5209346de.jpg",
        "img_width": 1125,
        "img_height": 2184,
        "img_size": 534
      }],
      "count": 4,
      "ctime": 1577966163,
      "view": 833193,
      "like": 5667
    }]
  }
}

查询用户投稿专栏明细

https://api.bilibili.com/x/space/wbi/article

https://api.bilibili.com/x/space/article(旧链接)

请求方式:GET

认证方式:Cookie(SESSDATA)

鉴权方式:Wbi 签名

url参数:

参数名类型内容必要性备注
midnum用户uid√
pnnum默认:1
psnum默认:30
范围:[1,30]
sortstrpublish_time:最新发布
view:最多阅读
fav:最多收藏
默认:publish_time

json回复:

根对象

字段类型内容备注
codenum返回值0:成功
-400:请求错误
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象

字段名类型内容备注
articlesarray专栏文章信息列表
pnnum本次请求分页页数
psnum本次请求分页大小
countnum专栏文章总数

data对象 -> articles数组中的对象

字段名类型内容备注
idnum专栏文章id
categoryobj分类
categoriesarray分类
titlestr标题
summarystr摘要
banner_urlstr封面图
template_idnum
statenum
authorobjUP主信息
reprintnum
image_urlsarray
publish_timenum发布时间戳单位:秒
ctimenum提交时间戳单位:秒
statsobj专栏文章数据统计
tagsarray标签
wordsnum
dynamicstr粉丝动态文案
origin_image_urlsarray
listnull
is_likebool
mediaobj
apply_timestr空串
check_timestr空串
originalnum
act_idnum
disputenull
authenMarknull
cover_avidnum
top_video_infonull
typenum

data对象 -> articles数组中的对象 -> category对象

字段名类型内容备注
idnum分类id
parent_idnum父级分类id
namestr分类名称

data对象 -> articles数组中的对象 -> categories数组中的对象

字段名类型内容备注
idnum分类id
parent_idnum父级分类id
namestr分类名称

data对象 -> articles数组中的对象 -> author对象

字段名类型内容备注
midnum用户uid
namestr用户名
facestr头像
pendantobj头像框信息
official_verifyobj账号认证信息
nameplateobj成就勋章信息
vipobj大会员信息

data对象 -> articles数组中的对象 -> author对象 -> pendant对象

字段名类型内容备注
pidnum头像框id
namestr头像框名称
imagestr头像框图片url
expirenum过期时间

data对象 -> articles数组中的对象 -> author对象 -> official_verify对象

字段名类型内容备注
typenum是否认证-1:无
0:个人认证
1:机构认证
descstr认证备注

data对象 -> articles数组中的对象 -> author对象 -> nameplate对象

字段名类型内容备注
nidnum勋章id
namestr勋章名称
imagestr勋章图标
image_smallstr勋章图标(小)
levelstr勋章等级
conditionstr获取条件

data对象 -> articles数组中的对象 -> author对象 -> vip对象

字段名类型内容备注
typenum大会员类型0:无
1:月大会员
2:年度及以上大会员
statusnum大会员状态0:无
1:有
due_datenum大会员过期时间时间戳单位:毫秒
vip_pay_typenum支付类型
theme_typenum0
labelobj大会员标签
avatar_subscriptnum是否显示大会员图标0:不显示
1:显示
nickname_colorstr大会员昵称颜色

data对象 -> articles数组中的对象 -> author对象 -> vip对象 -> label对象

字段名类型内容备注
pathstr空串
textstr会员类型文案大会员 年度大会员 十年大会员 百年大会员 最强绿鲤鱼
label_themestr会员标签vip:大会员
annual_vip:年度大会员
ten_annual_vip:十年大会员
hundred_annual_vip:百年大会员
fools_day_hundred_annual_vip:最强绿鲤鱼

data对象 -> articles数组中的对象 -> stats对象

字段名类型内容备注
viewnum浏览数
favoritenum收藏数
likenum点赞数
dislikenum点踩数恒为0
replynum回复数
sharenum转发数
coinnum投币数
dynamicnum

data对象 -> articles数组中的对象 -> tags数组中的对象

字段名类型内容备注
tidnum标签id
namestr标签名称

data对象 -> articles数组中的对象 -> media对象

字段名类型内容备注
scorenum0
media_idnum0
titlestr空串
coverstr空串
areastr空串
type_idnum0
type_namestr空串
spoilernum0

示例:

curl -L -X GET 'https://api.bilibili.com/x/space/article?mid=300021061&pn=1&ps=2&sort=publish_time'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "articles": [
      {
        "id": 18989884,
        "category": {
          "id": 15,
          "parent_id": 3,
          "name": "日常"
        },
        "categories": [
          {
            "id": 3,
            "parent_id": 0,
            "name": "生活"
          },
          {
            "id": 15,
            "parent_id": 3,
            "name": "日常"
          }
        ],
        "title": "B站UP主日报2022年10月08日23点(v1.1)",
        "summary": "冠:罗翔说刑法(2485.45万粉,+7204) 涨:肯德基(+18.37万粉) 掉:Overidea_China(-186850粉) 播:开心锤锤(+927.56万) 赞:荒草音乐(+31.02万) 赞:飞翔的丘丘人(+22.08万) 充:冰糖IO(+210)",
        "banner_url": "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg",
        "template_id": 4,
        "state": 0,
        "author": {
          "mid": 300021061,
          "name": "狸工智能",
          "face": "https://i1.hdslb.com/bfs/face/4cba9bc9d6cf6935a37ec156dedb8f8d26c1df95.jpg",
          "pendant": {
            "pid": 0,
            "name": "",
            "image": "",
            "expire": 0
          },
          "official_verify": {
            "type": -1,
            "desc": ""
          },
          "nameplate": {
            "nid": 3,
            "name": "白银殿堂",
            "image": "https://i2.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png",
            "image_small": "https://i2.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png",
            "level": "高级勋章",
            "condition": "单个自制视频总播放数>=10万"
          },
          "vip": {
            "type": 0,
            "status": 0,
            "due_date": 0,
            "vip_pay_type": 0,
            "theme_type": 0,
            "label": {
              "path": "",
              "text": "",
              "label_theme": ""
            },
            "avatar_subscript": 0,
            "nickname_color": ""
          }
        },
        "reprint": 0,
        "image_urls": [
          "https://i0.hdslb.com/bfs/article/8e5497f7854e7df3468fbc29b0dd10fcf17d1223.png"
        ],
        "publish_time": 1665278884,
        "ctime": 1665278884,
        "stats": {
          "view": 689,
          "favorite": 2,
          "like": 61,
          "dislike": 0,
          "reply": 18,
          "share": 0,
          "coin": 1,
          "dynamic": 0
        },
        "words": 0,
        "dynamic": "狸子的UP主日报📰v1.1,每天稳定更新~(如果咕咕咕了,请艾特狸子LePtC检查狐务器 [tv_微笑] #排行榜##大数据##狸工智能#",
        "origin_image_urls": [
          "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg"
        ],
        "list": null,
        "is_like": false,
        "media": {
          "score": 0,
          "media_id": 0,
          "title": "",
          "cover": "",
          "area": "",
          "type_id": 0,
          "type_name": "",
          "spoiler": 0
        },
        "apply_time": "",
        "check_time": "",
        "original": 1,
        "act_id": 0,
        "dispute": null,
        "authenMark": null,
        "cover_avid": 0,
        "top_video_info": null,
        "type": 0
      },
      {
        "id": 18972446,
        "category": {
          "id": 15,
          "parent_id": 3,
          "name": "日常"
        },
        "categories": [
          {
            "id": 3,
            "parent_id": 0,
            "name": "生活"
          },
          {
            "id": 15,
            "parent_id": 3,
            "name": "日常"
          }
        ],
        "title": "B站UP主日报2022年10月07日23点(v1.1)",
        "summary": "冠:罗翔说刑法(2484.73万粉,+8020) 涨:靖菌命(+3.61万粉) 掉:Overidea_China(-8593粉) 播:开心锤锤(+971.44万) 赞:荒草音乐(+53.14万) 赞:南方都市报(+18.05万) 充:内德维德(+190)",
        "banner_url": "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg",
        "template_id": 4,
        "state": 0,
        "author": {
          "mid": 300021061,
          "name": "狸工智能",
          "face": "https://i1.hdslb.com/bfs/face/4cba9bc9d6cf6935a37ec156dedb8f8d26c1df95.jpg",
          "pendant": {
            "pid": 0,
            "name": "",
            "image": "",
            "expire": 0
          },
          "official_verify": {
            "type": -1,
            "desc": ""
          },
          "nameplate": {
            "nid": 3,
            "name": "白银殿堂",
            "image": "https://i2.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png",
            "image_small": "https://i2.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png",
            "level": "高级勋章",
            "condition": "单个自制视频总播放数>=10万"
          },
          "vip": {
            "type": 0,
            "status": 0,
            "due_date": 0,
            "vip_pay_type": 0,
            "theme_type": 0,
            "label": {
              "path": "",
              "text": "",
              "label_theme": ""
            },
            "avatar_subscript": 0,
            "nickname_color": ""
          }
        },
        "reprint": 0,
        "image_urls": [
          "https://i0.hdslb.com/bfs/article/8e5497f7854e7df3468fbc29b0dd10fcf17d1223.png"
        ],
        "publish_time": 1665189149,
        "ctime": 1665189149,
        "stats": {
          "view": 1021,
          "favorite": 1,
          "like": 66,
          "dislike": 0,
          "reply": 21,
          "share": 2,
          "coin": 2,
          "dynamic": 0
        },
        "tags": [
          {
            "tid": 1598,
            "name": "粉丝"
          },
          {
            "tid": 422982,
            "name": "狸子"
          },
          {
            "tid": 526616,
            "name": "大数据"
          },
          {
            "tid": 14082112,
            "name": "狸工智能"
          },
          {
            "tid": 438,
            "name": "排行榜"
          }
        ],
        "words": 0,
        "dynamic": "狸子的UP主日报📰v1.1,每天稳定更新~(如果咕咕咕了,请艾特狸子LePtC检查狐务器 [tv_微笑] #排行榜##大数据##狸工智能#",
        "origin_image_urls": [
          "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg"
        ],
        "list": null,
        "is_like": false,
        "media": {
          "score": 0,
          "media_id": 0,
          "title": "",
          "cover": "",
          "area": "",
          "type_id": 0,
          "type_name": "",
          "spoiler": 0
        },
        "apply_time": "",
        "check_time": "",
        "original": 1,
        "act_id": 0,
        "dispute": null,
        "authenMark": null,
        "cover_avid": 0,
        "top_video_info": null,
        "type": 0
      }
    ],
    "pn": 1,
    "ps": 2,
    "count": 1563
  }
}

查询用户专栏文集明细

https://api.bilibili.com/x/article/up/lists

请求方式:GET

认证方式:Cookie(SESSDATA)

url参数:

参数名类型内容必要性备注
midnum用户uid√
sortnum排序方式0:最近更新
1:最多阅读
jsonpstr
callbackstr

json回复:

根对象

字段名类型内容备注
codenum响应码0:成功
-400:请求错误
messagestr0
ttlnum1
dataobj信息本体

data对象

字段名类型内容备注
listsarray文集信息列表
totalnum文集总数

data对象 -> lists数组中的对象

字段名类型内容备注
idnum文集id
midnum作者uid
namestr文集名称
image_urlstr封面
update_timenum最后更新时间戳单位:秒
ctimenum创建时间戳单位:秒
publish_timenum单位:秒
summarystr空串
wordsnum总字数
readnum阅读量
articles_countnum包含文章数
statenum1
reasonstr空串
apply_timestr空串
check_timestr空串

示例:

curl -X GET 'https://api.bilibili.com/x/article/up/lists' \
    --data-urlencode 'mid=2859372' \
    --data-urlencode 'sort=0'
点击查看
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "lists": [
      {
        "id": 77163,
        "mid": 2859372,
        "name": "碟报",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1664854854,
        "ctime": 1554785697,
        "publish_time": 1664863200,
        "summary": "",
        "words": 71532,
        "read": 478726,
        "articles_count": 113,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      },
      {
        "id": 26407,
        "mid": 2859372,
        "name": "周榜",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1664721205,
        "ctime": 1537942450,
        "publish_time": 1664721307,
        "summary": "",
        "words": 102099,
        "read": 1366280,
        "articles_count": 206,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      },
      {
        "id": 107952,
        "mid": 2859372,
        "name": "制作委员会",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1646663919,
        "ctime": 1563107348,
        "publish_time": 1646910000,
        "summary": "",
        "words": 47564,
        "read": 72911,
        "articles_count": 10,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      },
      {
        "id": 26457,
        "mid": 2859372,
        "name": "实时榜",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1603115712,
        "ctime": 1537955117,
        "publish_time": 1603115719,
        "summary": "",
        "words": 206741,
        "read": 1136352,
        "articles_count": 76,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      },
      {
        "id": 49769,
        "mid": 2859372,
        "name": "预测",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1593933314,
        "ctime": 1546153226,
        "publish_time": 1593933314,
        "summary": "",
        "words": 2518,
        "read": 55123,
        "articles_count": 6,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      },
      {
        "id": 96916,
        "mid": 2859372,
        "name": "书籍周榜",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1559815260,
        "ctime": 1559815159,
        "publish_time": 1559815577,
        "summary": "",
        "words": 272,
        "read": 2955,
        "articles_count": 1,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      },
      {
        "id": 96610,
        "mid": 2859372,
        "name": "原始周榜存档",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1559721231,
        "ctime": 1559720762,
        "publish_time": 1559721271,
        "summary": "",
        "words": 290,
        "read": 1498,
        "articles_count": 1,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      },
      {
        "id": 26453,
        "mid": 2859372,
        "name": "杂谈",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1557303117,
        "ctime": 1537954625,
        "publish_time": 1557303168,
        "summary": "",
        "words": 10673,
        "read": 38363,
        "articles_count": 4,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      },
      {
        "id": 59028,
        "mid": 2859372,
        "name": "新春访谈",
        "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png",
        "update_time": 1549878596,
        "ctime": 1549343048,
        "publish_time": 1549884125,
        "summary": "",
        "words": 33472,
        "read": 34597,
        "articles_count": 13,
        "state": 1,
        "reason": "",
        "apply_time": "",
        "check_time": ""
      }
    ],
    "total": 9
  }
}

查询用户投稿音频明细

https://api.bilibili.com/audio/music-service/web/song/upper

请求方法: GET

URL参数:

参数名类型内容必要性备注
midnum用户 mid必要
pnnum页码必要默认为 1
psnum每页项数必要默认为 30
orderstr排序方式必要1: 最新发布
2: 最多播放
3: 最多收藏

JSON回复:

根对象:

字段类型内容备注
codenum返回值0: 成功
72000000: 缺少参数
msgstr返回信息成功为 success
datastr数据本体失败时不存在

data 对象:

字段类型内容备注
curPagenum当前页码
pageCountnum总页数
totalSizenum总计数
pageSizenum每页项数
dataarray音频列表

data 对象中的 data 数组中的对象:

字段类型内容备注
idnum音频 AU 号
uidnum用户 mid
unamestr用户名
authornull
titlestr音频标题
coverstr音频封面图片 URL
intronull
lyricstr音频歌词 URL
crtypenum1
durationnum音频时长单位为 秒
passtimenum发布时间UNIX 秒级时间戳
curtimenum0
aidnull
cidnull
msidnull
attrnull
limitnull
activityIdnull
limitdescnull
ctimenum发布时间UNIX 毫秒时间戳
statisticobj统计数
coin_numnum硬币数量
is_coopernull

data 数组中的对象中的 statistic 对象:

字段类型内容备注
sidnum音频 AU 号
playnum播放数
collectnum收藏数
commentnum评论数
sharenum分享数

示例:

curl -G 'https://api.bilibili.com/audio/music-service/web/song/upper' \
--url-query 'uid=8047632' \
--url-query 'pn=1' \
--url-query 'ps=30' \
--url-query 'order=2'
查看响应示例:
{
  "code": 0,
  "msg": "success",
  "data": {
    "curPage": 1,
    "pageCount": 1,
    "totalSize": 2,
    "pageSize": 30,
    "data": [
      {
        "id": 257709,
        "uid": 8047632,
        "uname": "哔哩哔哩弹幕网",
        "author": null,
        "title": "【2018拜年祭单品】与你同行~B With U~",
        "cover": "http://i0.hdslb.com/bfs/music/0f890889c8e1101f37317def0c4c555068054c88.jpg",
        "intro": null,
        "lyric": "http://i0.hdslb.com/bfs/music/1519959250257709.lrc",
        "crtype": 1,
        "duration": 301,
        "passtime": 1519878405,
        "curtime": 0,
        "aid": null,
        "cid": null,
        "msid": null,
        "attr": null,
        "limit": null,
        "activityId": null,
        "limitdesc": null,
        "ctime": 1519875632000,
        "statistic": {
          "sid": 257709,
          "play": 845264,
          "collect": 21978,
          "comment": 1983,
          "share": 1685
        },
        "coin_num": 13368,
        "is_cooper": null
      },
      {
        "id": 378521,
        "uid": 8047632,
        "uname": "哔哩哔哩弹幕网",
        "author": null,
        "title": "《B TOGETHER》-bilibili九周年主题曲",
        "cover": "http://i0.hdslb.com/bfs/music/109136c63e16d83fbad5ec9282a6fb96498d8144.jpg",
        "intro": null,
        "lyric": "http://i0.hdslb.com/bfs/music/1529979007378521.lrc",
        "crtype": 1,
        "duration": 261,
        "passtime": 1529928347,
        "curtime": 0,
        "aid": null,
        "cid": null,
        "msid": null,
        "attr": null,
        "limit": null,
        "activityId": null,
        "limitdesc": null,
        "ctime": 1529928235000,
        "statistic": {
          "sid": 378521,
          "play": 123264,
          "collect": 5501,
          "comment": 1591,
          "share": 535
        },
        "coin_num": 3640,
        "is_cooper": null
      }
    ]
  }
}

频道

所有旧接口 已弃用, 现可用接口参见 合集和视频列表信息

课程

查询用户发布的课程列表

https://api.bilibili.com/pugv/app/web/season/page

请求方式:GET

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要
pnnum页码非必要默认为1
psnum每页项数非必要默认为20

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
53013:用户隐私设置未公开
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
listarray课程列表
pageobj页面信息

data中的page对象:

字段类型内容备注
nextbool是否存在下一页false:最后一页
true:存在下一页
numnum当前页码
sizenum每页项数
totalnum总计项数

data中的list数组:

项类型内容备注
0obj课程1
nobj课程(n+1)按照目标用户的发布顺序排列
……obj……

data中的list数组中的对象:

字段类型内容备注
coverstr课程封面url
ep_countnum课程集数
linkstr课程页面url手机版页面url
pagenum1作用尚不明确
playnum课程播放数
season_idnum课程ssid
statusstr更新状态说明
subtitlestr课程副标题
titlestr课程标题

示例:

查询用户mid=33683045的课程发布列表

curl -G 'https://api.bilibili.com/pugv/app/web/season/page' \
--data-urlencode 'mid=33683045' \
--data-urlencode 'ps=5' \
--data-urlencode 'pn=1'
查看响应示例:
{
    "code": 0,
    "data": {
        "items": [
            {
                "cover": "http://i0.hdslb.com/bfs/archive/596575057885fff7f0ceff047437186cba459358.jpg",
                "ep_count": 10,
                "link": "https://m.bilibili.com/cheese/play/ss80",
                "page": 1,
                "play": 174467,
                "season_id": 80,
                "status": "共10期",
                "subtitle": "百科全书式军事科普短视频系列",
                "title": "《战忽知道》第一季"
            },
            {
                "cover": "http://i0.hdslb.com/bfs/archive/322aa94d27cece62d2a859caf71ac2426f29eee2.jpg",
                "ep_count": 1,
                "link": "https://m.bilibili.com/cheese/play/ss145",
                "page": 1,
                "play": 22155,
                "season_id": 145,
                "status": "更新至第1期",
                "subtitle": "此课程为《局座:第四次工业革命来了》部分集数,请谨慎购买",
                "title": "【体验课】局座讲5G:5G如何改变我们的生活?"
            },
            {
                "cover": "http://i0.hdslb.com/bfs/archive/b9794ac4507f8764e219df413b661b5faf499a19.jpg",
                "ep_count": 10,
                "link": "https://m.bilibili.com/cheese/play/ss113",
                "page": 1,
                "play": 49833,
                "season_id": 113,
                "status": "更新至第10期",
                "subtitle": "百科全书式军事科普短视频系列",
                "title": "《战忽知道》第二季"
            },
            {
                "cover": "http://i0.hdslb.com/bfs/archive/7351fcb33592a4bc7aac9f71d421b4b5ce0177d3.jpg",
                "ep_count": 10,
                "link": "https://m.bilibili.com/cheese/play/ss51",
                "page": 1,
                "play": 4981037,
                "season_id": 51,
                "status": "共10期",
                "subtitle": "洞悉国际局势,学习战略思维",
                "title": "局座的国际战略课"
            },
            {
                "cover": "http://i0.hdslb.com/bfs/archive/31e2a170b5a815e34f0537a2727b28f1b87dca18.jpg",
                "ep_count": 10,
                "link": "https://m.bilibili.com/cheese/play/ss121",
                "page": 1,
                "play": 30754,
                "season_id": 121,
                "status": "更新至第10期",
                "subtitle": "百科全书式军事科普短视频系列",
                "title": "《战忽知道》第三季"
            }
        ],
        "page": {
            "next": true,
            "num": 1,
            "size": 5,
            "total": 8
        }
    },
    "message": "success"
}

订阅

查询用户追番预览列表

http://space.bilibili.com/ajax/Bangumi/getList

请求方式:GET

认证方式:Cookie(SESSDATA)

如设置隐私查看自己的需要认证

带有转义,且只能获取最多15条

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
statusbool状态false:失败
true:成功
data失败:str
成功:obj
失败:错误信息
成功:信息本体

data对象:

字段类型内容备注
countnum总计追番数
pagesnum0作用尚不明确
resultarray追番预览列表

data中的result数组:

项类型内容备注
0obj追番1
nobj追番(n+1)按照目标用户的关注顺序排列
……obj……
14obj追番15最后一项

data中的result数组中的对象:

字段类型内容备注
briefstr简介
coverstr封面图片url
evaluatestr空
favoritesnum追番数
is_finishnum是否已完结0:未完结
1:已完结
last_ep_indexnum0作用尚不明确
newest_ep_indexnum最新一话可能为0
season_idstr番剧ssid
share_urlstr播放页面链接url
titlestr标题
total_countnum总计集数未完结:-1
已完结:非0正整数

示例:

查看用户mid=14082的追番预览列表

curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \
--data-urlencode 'mid=14082' \
-b 'SESSDATA=xxx'
查看响应示例:
{
  "status": true,
  "data": {
    "count": 25,
    "pages": 0,
    "result": [{
      "season_id": "29310",
      "share_url": "http:\/\/bangumi.bilibili.com\/anime\/29310\/",
      "title": "异度侵入 ID:INVADED",
      "is_finish": 1,
      "favorites": 3479220,
      "newest_ep_index": 13,
      "last_ep_index": 0,
      "total_count": 13,
      "cover": "http:\/\/i0.hdslb.com\/bfs\/bangumi\/image\/9bf9e66968f85b33ec3769a16c86b36dc984abbc.png",
      "evaluate": "",
      "brief": "本片讲述利用能检测出人们杀意的装置以及利用思想粒子做出的“井”,来探知事件真相的科幻故事。"
    }, {
      "season_id": "25739",
      "share_url": "http:\/\/bangumi.bilibili.com\/anime\/25739\/",
      "title": "关于我转生变成史莱姆这档事",
      "is_finish": 1,
      "favorites": 5518829,
      "newest_ep_index": 0,
      "last_ep_index": 0,
      "total_count": 27,
      "cover": "http:\/\/i0.hdslb.com\/bfs\/bangumi\/a4c0e0ccc44fe3949a734f546cf5bb07da925bad.png",
      "evaluate": "",
      "brief": "史莱姆生活,开始了。\n上班族的三上悟在道路上被歹徒给刺杀身亡后,回过神来发现自己转生到了异世界。\n不..."
    },
    …………
    ]
  }
}

查询用户追番(追剧)明细

https://api.bilibili.com/x/space/bangumi/follow/list

请求方式:GET

认证方式:Cookie(SESSDATA)

如设置隐私查看自己的需要认证

url参数:

参数名类型内容必要性备注
vmidnum目标用户mid必要
pnnum页码非必要默认为1
psnum每页项数非必要默认为15 定义域1-30
typenum查询类型必要1:追番
2:追剧

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
53013:用户隐私设置未公开
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
listarray追番列表
pnnum当前页码
psnum每页项数
totalnum总计追番数

data中的list数组:

项类型内容备注
0obj追番1
nobj追番(n+1)按照目标用户的关注顺序排列
……obj……

data中的list数组中的对象:

基本同「番剧详细信息」中的result对象(未完工)

示例:

查看用户mid=14082的追番明细

curl -G 'https://api.bilibili.com/x/space/bangumi/follow/list' \
--data-urlencode 'vmid=14082' \
--data-urlencode 'type=1' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "list": [{
      "season_id": 29310,
      "media_id": 28224080,
      "season_type": 1,
      "season_type_name": "番剧",
      "title": "异度侵入 ID:INVADED",
      "cover": "http://i0.hdslb.com/bfs/bangumi/image/9bf9e66968f85b33ec3769a16c86b36dc984abbc.png",
      "total_count": 13,
      "is_finish": 1,
      "is_started": 1,
      "is_play": 1,
      "badge": "会员专享",
      "badge_type": 0,
      "rights": {
        "allow_review": 1,
        "is_selection": 1,
        "selection_style": 1
      },
      "stat": {
        "follow": 3475768,
        "view": 87500861,
        "danmaku": 1334654,
        "reply": 316632,
        "coin": 835150,
        "series_follow": 3475242,
        "series_view": 87500861
      },
      "new_ep": {
        "id": 307774,
        "index_show": "全13话",
        "cover": "http://i0.hdslb.com/bfs/archive/3dce2b856a7b0ea667aa288b51b7c0478fa56c4d.jpg",
        "title": "13",
        "long_title": "CHANNELEDⅡ",
        "pub_time": "2020-03-23 00:30:00",
        "duration": 1481000
      },
      "rating": {
        "score": 9.8,
        "count": 262589
      },
      "square_cover": "http://i0.hdslb.com/bfs/bangumi/image/664dbf039ec2da8dd982b697a108e28e87b9897e.jpg",
      "season_status": 13,
      "season_title": "TV",
      "badge_ep": "会员",
      "media_attr": 196608,
      "season_attr": 0,
      "evaluate": "本片讲述利用能检测出人们杀意的装置以及利用思想粒子做出的“井”,来探知事件真相的科幻故事。...",
      "areas": [{
        "id": 2,
        "name": "日本"
      }],
      "subtitle": "",
      "first_ep": 307446,
      "can_watch": 1,
      "series": {
        "series_id": 4760,
        "title": "ID:INVADED",
        "season_count": 1,
        "new_season_id": 29310
      },
      "publish": {
        "pub_time": "2020-01-06 00:30:00",
        "pub_time_show": "敬请期待",
        "release_date": "2020-01-06",
        "release_date_show": "2020年1月6日"
      },
      "mode": 2,
      "section": [{
        "section_id": 39327,
        "season_id": 29310,
        "limit_group": 328,
        "watch_platform": 15,
        "copyright": "dujia",
        "ban_area_show": 1
      }, {
        "section_id": 39633,
        "season_id": 29310,
        "limit_group": 328,
        "watch_platform": 15,
        "type": 1,
        "copyright": "dujia",
        "title": "其他",
        "ban_area_show": 1
      }, {
        "section_id": 44101,
        "season_id": 29310,
        "limit_group": 316,
        "watch_platform": 15,
        "type": 4,
        "copyright": "ugc",
        "ban_area_show": 1
      }],
      "url": "https://www.bilibili.com/bangumi/play/ss29310",
      "follow_status": 2,
      "is_new": 0,
      "progress": "",
      "both_follow": true
    }, {
      "season_id": 25739,
      "media_id": 139252,
      "season_type": 1,
      "season_type_name": "番剧",
      "title": "关于我转生变成史莱姆这档事",
      "cover": "http://i0.hdslb.com/bfs/bangumi/a4c0e0ccc44fe3949a734f546cf5bb07da925bad.png",
      "total_count": 27,
      "is_finish": 1,
      "is_started": 1,
      "is_play": 1,
      "badge": "会员专享",
      "badge_type": 0,
      "rights": {
        "allow_review": 1,
        "is_selection": 1,
        "selection_style": 1
      },
      "stat": {
        "follow": 5516519,
        "view": 246739631,
        "danmaku": 3802465,
        "reply": 460225,
        "coin": 1338958,
        "series_follow": 5516535,
        "series_view": 246739631
      },
      "new_ep": {
        "id": 316957,
        "index_show": "全27话",
        "cover": "http://i0.hdslb.com/bfs/archive/81d07d1a478ce3a6209b557e14df9b9c78c42abb.jpg",
        "title": "OAD03",
        "long_title": "外传:利姆鲁的华丽教师生活 其一",
        "pub_time": "2020-03-27 00:00:03",
        "duration": 1493000
      },
      "rating": {
        "score": 9.4,
        "count": 83354
      },
      "square_cover": "http://i0.hdslb.com/bfs/bangumi/8d9f5b4a566d0547bc2e3f6f733b732a09c0d3d4.jpg",
      "season_status": 13,
      "season_title": "TV",
      "badge_ep": "会员",
      "media_attr": 0,
      "season_attr": 0,
      "evaluate": "史莱姆生活,开始了。\n上班族的三上悟在道路上被歹徒给刺杀身亡后,回过神来发现自己转生到了异世界。\n不过,自己居然是“史莱姆”!\n他在得到利姆鲁这个名字后开始了自己的史莱姆人生,随着与各个种族相处交流的...",
      "areas": [{
        "id": 2,
        "name": "日本"
      }],
      "subtitle": "",
      "first_ep": 250460,
      "can_watch": 1,
      "series": {
        "series_id": 4188,
        "title": "关于我转生变成史莱姆这档事",
        "season_count": 1,
        "new_season_id": 25739
      },
      "publish": {
        "pub_time": "2018-10-02 00:30:00",
        "pub_time_show": "2018年10月02日00:30",
        "release_date": "2018-10-02",
        "release_date_show": "2018年10月2日"
      },
      "mode": 2,
      "section": [{
        "section_id": 34988,
        "season_id": 25739,
        "limit_group": 328,
        "watch_platform": 15,
        "copyright": "bilibili",
        "ban_area_show": 1
      }],
      "url": "https://www.bilibili.com/bangumi/play/ss25739",
      "follow_status": 2,
      "is_new": 0,
      "progress": "",
      "both_follow": true
    }],
    "pn": 1,
    "ps": 2,
    "total": 25
  }
}

查询用户关注的TAG(话题)

http://space.bilibili.com/ajax/tags/getSubList

请求方式:GET

认证方式:Cookie(SESSDATA)

如设置隐私查看自己的需要认证

带有转义

只显示前100个

url参数:

参数名类型内容必要性备注
midnum目标用户mid必要

json回复:

根对象:

字段类型内容备注
statusbool返回值false:错误
true:正确
data错误时:str
正确时:obj
错误时:错误信息
正确时:数据本体
正确时不返回错误信息

data对象:

字段类型内容备注
tagsarray关注TAG列表
countnum关注TAG的数

data中的tags数组:

项类型内容备注
0obj关注TAG1
nobj关注TAG(n+1)
……obj…………
99obj关注TAG100最后一项

data中的tags数组中的对象:

字段类型内容备注
archive_countnum0作用尚不明确
coverstrTAG图片url无则为空
namestrTAG名
notifynum1作用尚不明确
tag_idnumtag_id
updated_tsstr1970-01-01 08:00:00作用尚不明确

示例:

查询用户mid=2的关注TAG

curl -G 'http://space.bilibili.com/ajax/tags/getSubList' \
--data-urlencode 'mid=2' \
-b 'SESSDATA=xxx'
查看响应示例:
{
  "status": true,
  "data": {
    "tags": [{
      "name": "豪宅",
      "cover": "",
      "tag_id": 47637,
      "notify": 1,
      "archive_count": 0,
      "updated_ts": "1970-01-01 08:00:00"
    }, {
      "name": "死亡搁浅",
      "cover": "",
      "tag_id": 1737239,
      "notify": 1,
      "archive_count": 0,
      "updated_ts": "1970-01-01 08:00:00"
    },
    …………
    ],
    "count": 58
  }
}
在 GitHub 上编辑此页
最近更新:: 2025/5/5 05:52
Contributors: SocialSisterYi, SessionHu, LaMerChiang, Luoxin, stmtc233, wuziqian211, 王翼翔, stydxm
Copyright © 2020-2025 SocialSisterYi | CC-BY-NC-4.0 Licensed