space.md

用户空间相关

主页

置顶视频

查询用户置顶视频

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

请求方式：GET

粉丝在其主页上可见

url参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 53016：没有置顶视频
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
aid	num	稿件avid
videos	num	视频分P总数	默认为1
tid	num	分区tid
tname	str	子分区名称
copyright	num	是否转载	1：原创 2：转载
pic	str	视频封面图片url
title	str	稿件标题
pubdate	num	稿件发布时间	时间戳
ctime	num	用户提交稿件的时间	时间戳
desc	str	视频简介
state	num	视频状态	略，见获取视频详细信息（web端）中的state备注
attribute	num	稿件属性位配置	略，见获取视频详细信息（web端）中的attribute备注
duration	num	视频总计持续时长（所有分P）	单位为秒
rights	obj	视频属性标志	略，见获取视频详细信息（web端）中的rights对象
owner	obj	视频UP主信息	略，见获取视频详细信息（web端）中的owner对象
stat	obj	视频状态数	略，见获取视频详细信息（web端）中的stat对象
dynamic	str	视频同步发布的的动态的文字内容	无为空
cid	num	视频1P cid
dimension	obj	视频1P分辨率	略，见获取视频详细信息（web端）中的dimension对象
bvid	str	稿件bvid
reason	str	置顶视频备注
inter_video	bool	是否为合作视频	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 ）：

参数名	类型	内容	必要性	备注
aid	num	置顶目标稿件avid	必要（可选）	avid与bvid任选一个
bvid	str	置顶目标稿件bvid	必要（可选）	avid与bvid任选一个
reason	str	置顶视频备注	非必要	置顶备注最大40字符 默认为空
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

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

示例：

置顶视频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 ）：

参数名	类型	内容	必要性	备注
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败 -400：请求错误（重复取消）
message	str	错误信息	默认为0
ttl	num	1

示例：

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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误
message	str	错误信息	默认为0
ttl	num	1
data	array	代表作列表

data数组：

项	类型	内容	备注
0	obj	代表作1	无则为空
1	obj	代表作2	无则为空
2	obj	代表作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 ）：

参数名	类型	内容	必要性	备注
aid	num	置顶目标稿件avid	必要（可选）	avid与bvid任选一个
bvid	str	置顶目标稿件bvid	必要（可选）	avid与bvid任选一个
reason	str	代表作备注	非必要	置顶备注最大40字符 默认为空
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

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

示例：

添加视频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 ）：

参数名	类型	内容	必要性	备注
aid	num	要删除的目标稿件avid	必要（可选）	avid与bvid任选一个
bvid	str	要删除的目标稿件bvid	必要（可选）	avid与bvid任选一个
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

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

示例：

删除置顶视频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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误
message	str	错误信息	默认为0
ttl	num	1
data	array	信息本体

data数组：

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

data数组中的对象：

字段	类型	内容	备注
mid	num	目标用户mid
tags	array	TAG名称

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

项	类型	内容	备注
0	str	TAG1
n	str	TAG(n+1)
……	str	……
4	str	TAG5	上限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 ）：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败 -400：请求错误（超出长度限制）
message	str	错误信息	默认为0
ttl	num	1

示例：

修改个人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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误
message	str	错误信息	默认为0
ttl	num	1
data	str	公告信息	无则为空

示例：

查看用户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 ）：

参数名	类型	内容	必要性	备注
notice	str	要设置的公告内容	非必要	删除公告留空或省去即可 少于150字符
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败 -304：未修改 -400：请求错误（超出长度限制）
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确

示例：

修改个人空间公告为鸽子

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参数：

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

json回复：

根对象：

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

data对象：

字段	类型	内容	备注
privacy	obj	空间隐私权限
index_order	array	空间板块布局
theme	str	default主题？	作用尚不明确
theme_preview_img_path	str	主题预览图路径？	作用尚不明确
toutu	obj	空间头图

privacy对象：

字段	类型	内容	备注
bangumi	num	追番及追剧	0：隐藏 1：公开 下同
bbq	num	轻视频
channel	num	频道
coins_video	num	最近投币的视频
comic	num	追漫
dress_up	num	装扮
fav_video	num	收藏夹
groups	num	圈子？	作用尚不明确
likes_video	num	最近点赞的视频
played_game	num	最近玩过的游戏
tags	num	订阅标签
user_info	num	个人资料

index_order数组：

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

index_order数组内对象：

字段	类型	内容	备注
id	num	板块编号
name	str	板块名称

toutu对象：

字段	类型	内容	备注
sid	num	空间头图ID
expire	num	到期时间？	时间戳？ 作用尚不明确
s_img	str	空间头图小图相对路径	完整url为http://i0.hdslb.com/+相对路径
l_img	str	空间头图相对路径	同上
android_img	str	空	注：手机端头图与web端不同，需要用另一个api获取
iphone_img	str	空
ipad_img	str	空
thumbnail_img	str	缩略图
platform	num	0	作用尚不明确

示例：

查看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参数:

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

JSON回复:

根对象:

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

data数组中的对象:

字段	类型	内容	备注
id	num	空间头图 ID
product_name	str	显示名称
price	num	价格
coin_type	num	支付类型?
vip_free	num	大会员免费
s_img	str	小图 URI	需要自行与 i0.hdslb.com 拼接成 URL
l_img	str	大图 URI	同 s_img
thumbnail_img	str	空	并不存在的缩略图?
sort_num	num	排序编号
is_disable	num	已禁用	0: 未禁用
expire	num	过期时间?	UNIX 时间戳, 或 0 为永不过期
had	num	是否拥有?	当 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):

参数名	类型	内容	必要性	备注
id	num	头图 ID	必要
csrf	str	CSRF Token (即 Cookie bili_jct 值)	不必要

JSON回复:

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

示例:

设置空间头图为为王牌特工(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_order	nums	布局列表	必要	每个值之间用","（%2C）分隔 先左侧布局再右侧布局 值的意义见下表
csrf	str	CSRF Token（位于cookie）	必要

布局参数index_order：

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

json回复：

根对象：

字段	类型	内容	备注
status	bool	操作结果	true：操作成功 false：操作失败
data	str	错误信息	正确时无此项

示例：

调整空间布局为：

我的稿件            直播间
我的专栏            个人资料
订阅番剧            公告
我的收藏夹          官方活动
我的相簿            最近玩的游戏
最近投币的视频  
订阅标签  
我的频道

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_video	num	收藏视频	非必要	0：隐藏 1：公开 下同
bangumi	num	追番及追剧	非必要
tags	num	关注的TAG	非必要
coins_video	num	投币的视频	非必要
user_info	num	个人信息	非必要
played_game	num	玩过的游戏	非必要
csrf	nstr	CSRF Token（位于cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
status	bool	操作结果	true：操作成功 false：操作失败
data	str	错误信息	正确时无此项

示例：

设置关注的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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 53013：用户隐私设置未公开
message	str	错误信息	默认为0
ttl	num	1
data	隐藏时：null 公开时：array	信息本体

data数组：

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

data数组中的对象：

字段	类型	内容	备注
website	str	游戏主页 url
image	str	游戏图标 url
name	str	游戏名

示例：

查询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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 53013：用户隐私设置未公开
message	str	错误信息	默认为0
ttl	num	1
data	隐藏时：null 公开时：obj	信息本体

data对象：

字段	类型	内容	备注
page_num	num	当前页码
page_size	num	每页项数
total_count	num	游戏总数
list	array	游戏列表

list数组：

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

list数组中的对象：

字段	类型	内容	备注
game_base_id	num	游戏 id	biligame 的游戏 id
game_name	str	游戏名
game_icon	str	游戏图标 url
grade	num	游戏评分	如8.2、6.8
detail_url	str	游戏主页 url
game_tags	array	游戏标签
notice	str	游戏简介文案
gift_title	str	游戏礼物文案
game_status_v2	num	（？）

game_tags数组：

项	类型	内容	备注
0	obj	游戏标签1	如角色扮演、音乐节奏、休闲
n	obj	游戏标签(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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 53013：用户隐私设置未公开
message	str	错误信息	默认为0
ttl	num	1
data	隐藏时：null 公开时：array	信息本体

data数组：

项	类型	内容	备注
0	obj	投币视频1
n	obj	投币视频（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_key	str	APP登录Token	APP方式必要
appkey	str	APP密钥	APP方式必要
vmid	num	目标用户mid	必要
pn	num	页码	非必要	默认为1
ps	num	每页项数	非必要	默认为20

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
count	num	投币的视频数
item	array	投币视频列表

item数组：

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

item数组中的对象：

字段	类型	内容	备注
title	str	稿件标题
subtitle	str	空
tname	str	空
cover	str	封面图片 url
cover_icon	str	空
uri	str	APP 跳转 uri	如bilibili://video/2
param	str	稿件 avid
goto	str	av
length	num	空
duration	num	稿件视频长度	单位为秒
is_popular	bool	（？）
is_steins	bool	（？）
is_ugcpay	bool	（？）
is_cooperation	str	（？）
is_pgc	str	（？）
is_live_playback	str	（？）
is_pugv	str	（？）
is_fold	num	（？）
play	num	播放量
danmaku	num	弹幕量
ctime	num	发布时间	时间戳
ugc_pay	num	0
author	str	UP主昵称
state	bool	true
videos	num	0
view_content	str	稿件播放量文案
icon_type	num	0
publish_time_text	str	空

示例：

用户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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 53013：用户隐私设置未公开
message	str	错误信息	默认为0
ttl	num	1
data	隐藏时：null 公开时：array	信息本体

data数组：

项	类型	内容	备注
0	obj	点赞视频1
n	obj	点赞视频（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_key	str	APP登录Token	APP方式必要
appkey	str	APP密钥	APP方式必要
vmid	num	目标用户mid	必要
pn	num	页码	非必要	默认为1
ps	num	每页项数	非必要	默认为20

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
count	num	点赞的视频数
item	array	点赞视频列表

item数组：

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

item数组中的对象：

字段	类型	内容	备注
title	str	稿件标题
subtitle	str	空
tname	str	空
cover	str	封面图片 url
cover_icon	str	空
uri	str	APP 跳转 uri	如bilibili://video/2
param	str	稿件 avid
goto	str	av
length	num	空
duration	num	稿件视频长度	单位为秒
is_popular	bool	（？）
is_steins	bool	（？）
is_ugcpay	bool	（？）
is_cooperation	str	（？）
is_pgc	str	（？）
is_live_playback	str	（？）
is_pugv	str	（？）
is_fold	num	（？）
play	num	播放量
danmaku	num	弹幕量
ctime	num	发布时间	时间戳
ugc_pay	num	0
author	str	UP主昵称
state	bool	true
videos	num	0
view_content	str	稿件播放量文案
icon_type	num	0
publish_time_text	str	空

示例：

用户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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 -412：请求被拦截
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
list	obj	列表信息
page	obj	页面信息
episodic_button	obj	“播放全部“按钮
is_risk	bool
gaia_res_type	num
gaia_data	obj

data中的list对象：

字段	类型	内容	备注
tlist	obj	投稿视频分区索引
vlist	array	投稿视频列表

list中的tlist对象：

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

tlist中的{tid}对象：

字段	类型	内容	备注
count	num	投稿至该分区的视频数
name	str	该分区名称
tid	num	该分区tid

list中的vlist数组：

项	类型	内容	备注
0	obj	投稿视频1
n	obj	投稿视频（n+1）
……	obj	……	……

list中的vlist数组中的对象：

字段	类型	内容	备注
aid	num	稿件avid
attribute	num
author	str	视频UP主	不一定为目标用户（合作视频）
bvid	str	稿件bvid
comment	num	视频评论数
copyright	str	视频版权类型
created	num	投稿时间	时间戳
description	str	视频简介
enable_vt	num
hide_click	bool	false	作用尚不明确
is_pay	num	0	作用尚不明确
is_union_video	num	是否为合作视频	0：否 1：是
length	str	视频长度	MM:SS
mid	num	视频UP主mid	不一定为目标用户（合作视频）
meta	obj		无数据时为 null
pic	str	视频封面
play	num	视频播放次数
review	num	0	作用尚不明确
subtitle	str	空	作用尚不明确
title	str	视频标题
typeid	num	视频分区tid
video_review	num	视频弹幕数

data中的page对象：

字段	类型	内容	备注
count	num	总计稿件数
pn	num	当前页码
ps	num	每页项数

data中的episodic_button对象：

字段	类型	内容	备注
text	str	按钮文字
uri	str	全部播放页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": {
            "tlist": {
                "1": {
                    "tid": 1,
                    "count": 26,
                    "name": "动画"
                },
                "160": {
                    "tid": 160,
                    "count": 42,
                    "name": "生活"
                },
                "211": {
                    "tid": 211,
                    "count": 3,
                    "name": "美食"
                },
                "3": {
                    "tid": 3,
                    "count": 33,
                    "name": "音乐"
                },
                "4": {
                    "tid": 4,
                    "count": 72,
                    "name": "游戏"
                }
            },
            "vlist": [
                {
                    "comment": 3558,
                    "typeid": 47,
                    "play": 1275661,
                    "pic": "//i2.hdslb.com/bfs/archive/90157806a34646ac2d4c6af3e8b6156cb3460d14.jpg",
                    "subtitle": "",
                    "description": "第一期：BV1ak4y1B7aG\n第二期：BV1eA411Y7FN\n脚本/绘画/配音/动画/片尾曲：warma\n第三期终于做完啦！这是一个以我平时发呆的时候想到的一些灵感组成的冷笑话合集，名字叫《沃玛的生活》，可以当作日常搞笑单元小动画来看。\n如果你喜欢这个系列的话请点赞投币收藏一键三连给我一些继续制作的动力吧，我真的非常非常需要更多的动力！\n祝看得开心~\n我的微博：@_warma_",
                    "copyright": "",
                    "title": "【warma】沃玛的新番更新！从现在开始放飞自我【沃玛的生活/第三期】",
                    "review": 0,
                    "author": "Warma",
                    "mid": 53456,
                    "created": 1605844817,
                    "length": "05:16",
                    "video_review": 7470,
                    "aid": 585275804,
                    "bvid": "BV1sz4y1y7KJ",
                    "hide_click": false,
                    "is_pay": 0,
                    "is_union_video": 0,
                    "is_steins_gate": 0
                },
                {
                    "comment": 2979,
                    "typeid": 21,
                    "play": 840676,
                    "pic": "//i2.hdslb.com/bfs/archive/b43f88c6ebae8fdc7dfb663f6f6f2931b924c763.jpg",
                    "subtitle": "",
                    "description": "前一阵子过生日，大家的礼物经过几番转寄终于收到了~于是录了这期礼物开箱视频。\n现在也在感慨，大家的礼物真的都太强了，居然这些全都是手工做的，真的好厉害！\n这些手工礼物背后得花多少时间和心力啊……这些对我来说都是无价的礼物，制作礼物的大家真的有心了，谢谢！！\n收到这些礼物真的很开心，视频的封面也是在这样激动的情况下画出来的，祝你看得开心~\n我的微博：@_warma_",
                    "copyright": "",
                    "title": "【warma】来开箱！大家寄来的生日礼物",
                    "review": 0,
                    "author": "Warma",
                    "mid": 53456,
                    "created": 1604635221,
                    "length": "24:28",
                    "video_review": 10476,
                    "aid": 287744380,
                    "bvid": "BV1xf4y1q7XN",
                    "hide_click": false,
                    "is_pay": 0,
                    "is_union_video": 0,
                    "is_steins_gate": 0
                }
            ]
        },
        "page": {
            "pn": 1,
            "ps": 2,
            "count": 176
        },
        "episodic_button": {
            "text": "播放全部",
            "uri": "//www.bilibili.com/medialist/play/53456?from=space"
        }
    }
}

查询用户投稿相簿预览

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

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

请求方式：GET

所有类型的相簿

url参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误
message	str	错误信息	默认为0
ttl	num	1
data	array	相簿列表

data数组：

项	类型	内容	备注
0	obj	相簿内容1
n	obj	相簿内容（n+1）
……	obj	……	……

data数组中的对象：

字段	类型	内容	备注
count	num	总计图片数
ctime	num	发布时间	时间戳
description	str	简介
doc_id	num	相簿id	非动态！！！
like	num	点赞数
pictures	array	图片内容
poster_uid	num	上传用户mid
title	str	标题	动态内容无
view	num	浏览数

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

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

pictures数组中的对象：

字段	类型	内容	备注
img_height	num	图片高度
img_size	num	图片大小	单位为KByte
img_src	str	图片url
img_width	num	图片宽度

示例：

查询用户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参数：

参数名	类型	内容	必要性	备注
uid	num	目标用户mid	必要
page_num	num	页码	必要	默认为0
page_size	num	每页项数	必要	默认为30
biz	str	查询类型	非必要	全部：all 绘画：draw 摄影：photo 日常：daily 默认为all

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功
msg	str	错误信息	默认为success
message	str	错误信息	默认为success
data	obj	信息本体

data对象：

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

items数组：

项	类型	内容	备注
0	obj	相簿内容1
n	obj	相簿内容（n+1）
……	obj	……	……

items数组中的对象：

字段	类型	内容	备注
count	num	总计图片数
ctime	num	发布时间	时间戳
description	str	简介
doc_id	num	相簿id	非动态！！！
like	num	点赞数
pictures	array	图片内容
poster_uid	num	上传用户mid
title	str	标题	动态内容无
view	num	浏览数

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

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

pictures数组中的对象：

字段	类型	内容	备注
img_height	num	图片高度
img_size	num	图片大小	单位为KByte
img_src	str	图片url
img_width	num	图片宽度

示例：

查询用户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/audio/music-service/web/song/upper

请求方法: GET

URL参数:

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

JSON回复:

根对象:

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

data 对象:

字段	类型	内容	备注
curPage	num	当前页码
pageCount	num	总页数
totalSize	num	总计数
pageSize	num	每页项数
data	array	音频列表

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

字段	类型	内容	备注
id	num	音频 AU 号
uid	num	用户 mid
uname	str	用户名
author	null
title	str	音频标题
cover	str	音频封面图片 URL
intro	null
lyric	str	音频歌词 URL
crtype	num	1
duration	num	音频时长	单位为 秒
passtime	num	发布时间	UNIX 秒级时间戳
curtime	num	0
aid	null
cid	null
msid	null
attr	null
limit	null
activityId	null
limitdesc	null
ctime	num	发布时间	UNIX 毫秒时间戳
statistic	obj	统计数
coin_num	num	硬币数量
is_cooper	null

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

字段	类型	内容	备注
sid	num	音频 AU 号
play	num	播放数
collect	num	收藏数
comment	num	评论数
share	num	分享数

示例:

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参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 53013：用户隐私设置未公开
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
list	array	课程列表
page	obj	页面信息

data中的page对象：

字段	类型	内容	备注
next	bool	是否存在下一页	false：最后一页 true：存在下一页
num	num	当前页码
size	num	每页项数
total	num	总计项数

data中的list数组：

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

data中的list数组中的对象：

字段	类型	内容	备注
cover	str	课程封面url
ep_count	num	课程集数
link	str	课程页面url	手机版页面url
page	num	1	作用尚不明确
play	num	课程播放数
season_id	num	课程ssid
status	str	更新状态说明
subtitle	str	课程副标题
title	str	课程标题

示例：

查询用户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参数：

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

json回复：

根对象：

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

data对象：

字段	类型	内容	备注
count	num	总计追番数
pages	num	0	作用尚不明确
result	array	追番预览列表

data中的result数组：

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

data中的result数组中的对象：

字段	类型	内容	备注
brief	str	简介
cover	str	封面图片url
evaluate	str	空
favorites	num	追番数
is_finish	num	是否已完结	0：未完结 1：已完结
last_ep_index	num	0	作用尚不明确
newest_ep_index	num	最新一话	可能为0
season_id	str	番剧ssid
share_url	str	播放页面链接url
title	str	标题
total_count	num	总计集数	未完结：-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参数：

参数名	类型	内容	必要性	备注
vmid	num	目标用户mid	必要
pn	num	页码	非必要	默认为1
ps	num	每页项数	非必要	默认为15 定义域1-30
type	num	查询类型	必要	1：追番 2：追剧

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 53013：用户隐私设置未公开
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
list	array	追番列表
pn	num	当前页码
ps	num	每页项数
total	num	总计追番数

data中的list数组：

项	类型	内容	备注
0	obj	追番1
n	obj	追番（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参数：

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

json回复：

根对象：

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

data对象：

字段	类型	内容	备注
tags	array	关注TAG列表
count	num	关注TAG的数

data中的tags数组：

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

data中的tags数组中的对象：

字段	类型	内容	备注
archive_count	num	0	作用尚不明确
cover	str	TAG图片url	无则为空
name	str	TAG名
notify	num	1	作用尚不明确
tag_id	num	tag_id
updated_ts	str	1970-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
	}
}