bilibili-API-collect/user/space.md

用户空间相关

查询相关

查询用户置顶视频

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

方式:GET

粉丝在其主页上可见

参数：

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

json回复：

根对象：

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

data对象：

基本同「视频详细信息」中的data对象

示例：

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

http://api.bilibili.com/x/space/top/arc?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
	}
}

查询用户代表作视频列表

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

方式:GET

新访客在其主页上可见

最多可以设置3个

参数：

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

json回复：

根对象：

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

data数组：

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

data数组中的对象：

基本同「视频详细信息」中的data对象

示例：

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

http://api.bilibili.com/x/space/masterpiece?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
	}]
}

查询用户投稿视频明细

http://api.bilibili.com/x/space/arc/search

方式:GET

参数：

参数名	类型	内容	必要性	备注
mid	url	目标用户UID	必要
pn	url	页码	必要
ps	url	每页项数	必要

json回复：

根对象：

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

data对象：

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

data中的list对象：

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

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
author	str	视频UP主	不一定为目标用户（合作视频）
bvid	str	稿件bvID
comment	num	视频评论数
copyright	str	空	作用尚不明确
created	num	投稿时间	时间戳
description	str	视频简介
hide_click	bool	false	作用尚不明确
is_pay	num	0	作用尚不明确
is_union_video	num	是否为合作视频	0：否 1：是
length	str	视频长度	MM:SS
mid	num	视频UP主UID	不一定为目标用户（合作视频）
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	每页项数

示例：

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

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

http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"list": {
			"tlist": {
				"1": {
					"tid": 1,
					"count": 17,
					"name": "动画"
				},
				"160": {
					"tid": 160,
					"count": 43,
					"name": "生活"
				},
				"3": {
					"tid": 3,
					"count": 33,
					"name": "音乐"
				},
				"4": {
					"tid": 4,
					"count": 70,
					"name": "游戏"
				}
			},
			"vlist": [{
				"comment": 4626,
				"typeid": 17,
				"play": 954380,
				"pic": "//i0.hdslb.com/bfs/archive/b40edb19d3000763e1984f854f8f13d2159e13bc.jpg",
				"subtitle": "",
				"description": "游戏：动物森友会 平台：Switch\n封面画师：微博@HRDrifter \n终于盼来了动森的新作，和大家一起守夜等着游戏解锁，终于能在第一时间和大家一起分享这份喜悦~\n但是为什么这份高兴的心情最后会变成越来越多的房债呢……\n我的微博：@_warma_",
				"copyright": "",
				"title": "【warma】用水壶往海里浇水海平面会升高吗？《动物森友会》",
				"review": 0,
				"author": "Warma",
				"mid": 53456,
				"created": 1585311134,
				"length": "48:16",
				"video_review": 25064,
				"aid": 667551016,
				"bvid": "BV1na4y1t7Bf",
				"hide_click": false,
				"is_pay": 0,
				"is_union_video": 0
			}, {
				"comment": 3372,
				"typeid": 17,
				"play": 838204,
				"pic": "//i1.hdslb.com/bfs/archive/fc2bd95021e5c88a16b16a3bef803e0fc141d059.jpg",
				"subtitle": "",
				"description": "游戏：Rimworld\n上一期：av96139881\n点赞过8W会更新下一期的~\n录制这一期的时候嗓子炎症加剧了，所以说话有点点闷，不过现在已经好很多了~ 下一期要录的话，我会在嗓子完全康复后再录制的，大家放心~\n我的微博：@_warma_",
				"copyright": "",
				"title": "【warma实况】拿起狼牙棒去交朋友！《Rimworld》【第二期】",
				"review": 0,
				"author": "Warma",
				"mid": 53456,
				"created": 1584758891,
				"length": "21:40",
				"video_review": 12964,
				"aid": 98061972,
				"bvid": "BV1vE411c7Wu",
				"hide_click": false,
				"is_pay": 0,
				"is_union_video": 0
			}]
		},
		"page": {
			"count": 163,
			"pn": 1,
			"ps": 2
		}
	}
}

查询用户追番预览列表

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

方式:GET

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

参数：

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

json回复：

根对象：

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

data对象：

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

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正整数

示例：

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

http://space.bilibili.com/ajax/Bangumi/getList?mid=14082

{
	"status": true,
	"data": {
		"count": 25,
		"pages": 0,
		"result": [{
			"season_id": "29310",
			"share_url": "http:\/\/bangumi.bilibili.com\/anime\/29310\/",
			"title": "\u5f02\u5ea6\u4fb5\u5165 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": "\u672c\u7247\u8bb2\u8ff0\u5229\u7528\u80fd\u68c0\u6d4b\u51fa\u4eba\u4eec\u6740\u610f\u7684\u88c5\u7f6e\u4ee5\u53ca\u5229\u7528\u601d\u60f3\u7c92\u5b50\u505a\u51fa\u7684\u201c\u4e95\u201d\uff0c\u6765\u63a2\u77e5\u4e8b\u4ef6\u771f\u76f8\u7684\u79d1\u5e7b\u6545\u4e8b\u3002"
		}, {
			"season_id": "25739",
			"share_url": "http:\/\/bangumi.bilibili.com\/anime\/25739\/",
			"title": "\u5173\u4e8e\u6211\u8f6c\u751f\u53d8\u6210\u53f2\u83b1\u59c6\u8fd9\u6863\u4e8b",
			"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": "\u53f2\u83b1\u59c6\u751f\u6d3b\uff0c\u5f00\u59cb\u4e86\u3002\n\u4e0a\u73ed\u65cf\u7684\u4e09\u4e0a\u609f\u5728\u9053\u8def\u4e0a\u88ab\u6b79\u5f92\u7ed9\u523a\u6740\u8eab\u4ea1\u540e\uff0c\u56de\u8fc7\u795e\u6765\u53d1\u73b0\u81ea\u5df1\u8f6c\u751f\u5230\u4e86\u5f02\u4e16\u754c\u3002\n\u4e0d..."
		}, 
		…………
		]
	}
}

查询用户追番（追剧）明细

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

方式:GET

参数：

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

json回复：

根对象：

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

data对象：

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

data中的list数组：

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

data中的list数组中的对象：

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

示例：

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

http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1

{
	"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
	}
}

查询用户投稿相簿预览

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

方式:GET

所有类型的相簿

参数：

参数名	类型	内容	必要性	备注
mid	url	目标用户UID	必要
ps	url	获取的相簿量	非必要	默认为8

json回复：

根对象：

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

data数组：

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

data数组中的对象：

字段	类型	内容	备注
count	num	总计图片数
ctime	num	发布时间	时间戳
description	str	简介
doc_id	num	相册ID	非动态ID！！！
like	num	点赞数
pictures	arrary	图片内容
poster_uid	num	上传用户UID
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	图片宽度

示例：

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

http://api.bilibili.com/x/space/album/index?mid=53456&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
	}]
}

查询用户投稿相簿明细

http://api.vc.bilibili.com/link_draw/v1/doc/doc_list

方式:GET

参数：

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

json回复：

根对象：

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

data对象：

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

items数组：

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

items数组中的对象：

字段	类型	内容	备注
count	num	总计图片数
ctime	num	发布时间	时间戳
description	str	简介
doc_id	num	相册ID	非动态ID！！！
like	num	点赞数
pictures	arrary	图片内容
poster_uid	num	上传用户UID
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	图片宽度

示例：

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

http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size=2&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
		}]
	}
}

查询用户频道列表

http://api.bilibili.com/x/space/channel/list

方式:GET

参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确
data	obj	信息本体	无则为空

data对象：

字段	类型	内容	备注
count	num	总计频道数
list	arrary	频道列表

data中的list数组：

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

data中的list数组中的对象：

字段	类型	内容	备注
cid	num	频道ID
count	num	频道内含视频数
cover	str	封面图片url
intro	str	简介	无则为空
mid	num	创建用户UID
mtime	num	创建时间	时间戳
name	str	标题

示例：

查询用户UID=53456的频道列表

http://api.bilibili.com/x/space/channel/list?mid=53456

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"count": 6,
		"list": [{
			"cid": 100249,
			"mid": 53456,
			"name": "【实况】动物之森",
			"intro": "",
			"mtime": 1579898830,
			"count": 2,
			"cover": "http://i1.hdslb.com/bfs/archive/6a7ed9483c34e839dfca981b9e2b94cd4c4efa0a.jpg"
		}, {
			"cid": 79323,
			"mid": 53456,
			"name": "忆雨",
			"intro": "忆雨出现过的视频",
			"mtime": 1562535222,
			"count": 7,
			"cover": "http://i2.hdslb.com/bfs/archive/1783e4f03042b282495799adda1cb56270cea647.jpg"
		}, {
			"cid": 79322,
			"mid": 53456,
			"name": "大画家",
			"intro": "",
			"mtime": 1562535122,
			"count": 6,
			"cover": "http://i0.hdslb.com/bfs/archive/9c85a14e805c6c23cb7a42e1dbef97821bb68960.jpg"
		}, {
			"cid": 77758,
			"mid": 53456,
			"name": "灭火器",
			"intro": "",
			"mtime": 1561270856,
			"count": 4,
			"cover": "http://i2.hdslb.com/bfs/archive/0073208d086b4ebe9cdc540e7664aa74b483aeb6.jpg"
		}, {
			"cid": 75696,
			"mid": 53456,
			"name": "沃玛小剧场",
			"intro": "",
			"mtime": 1559129460,
			"count": 5,
			"cover": "http://i2.hdslb.com/bfs/archive/db2b20ecdb6ed013fc3780b0e741ea88d46b5b40.jpg"
		}, {
			"cid": 170,
			"mid": 53456,
			"name": "爆炸电台",
			"intro": "闲聊的电台",
			"mtime": 1503298893,
			"count": 7,
			"cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg"
		}]
	}
}

查询用户频道中的视频

http://api.bilibili.com/x/space/channel/video

方式:GET

参数：

参数名	类型	内容	必要性	备注
mid	url	目标用户UID	必要
cid	url	目标频道ID	必要
pn	url	页码	非必要	默认为1
ps	url	每页项数	非必要	默认为100

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 -404：无用户对应的频道
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确
data	obj	信息本体

data对象：

字段	类型	内容	备注
list	obj	频道信息
page	obj	页面信息

data中的list对象：

字段	类型	内容	备注
archives	arrary	包含的视频列表
cid	num	频道ID
count	num	频道内含视频数
cover	str	封面图片url
intro	str	简介	无则为空
mid	num	创建用户UID
mtime	num	创建时间	时间戳
name	str	标题

list中的archives数组：

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

list中的archives数组中的对象：

基本同「视频详细信息」中的data对象

data中的page对象：

字段	类型	内容	备注
count	num	总计视频数
num	num	当前页码
size	num	每页项数

示例：

查询用户UID=53456的频道170中的视频

http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"list": {
			"cid": 170,
			"mid": 53456,
			"name": "爆炸电台",
			"intro": "闲聊的电台",
			"mtime": 1503298893,
			"count": 7,
			"cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg",
			"archives": [{
				"aid": 87673204,
				"videos": 1,
				"tid": 21,
				"tname": "日常",
				"copyright": 1,
				"pic": "http://i0.hdslb.com/bfs/archive/5387bdcbbe4d5551adbf0ee2e607e4b7d3d8f2f0.jpg",
				"title": "【warma爆炸电台】迟来的自我介绍【第八期】",
				"pubdate": 1581244539,
				"ctime": 1581244540,
				"desc": "时隔半年的新的一期爆炸电台来啦，这是我的一系列杂谈聊天电台，这次因为多了很多新关注的朋友们，所以来做个自我介绍吧！\n画师：Dr-H_喵_   动画：K_Lacid\n结尾提到的壁纸稍后在动态发原图，动态壁纸在steam那个壁纸软件的创意工坊里搜warma能找到\n\n往期的电台：\n第一期：av6786024 \n第三期：av13619263\n第四期：av18862091\n第五期：av25092410\n第六期：av42492515\n第七期：av62910468",
				"state": 0,
				"attribute": 16512,
				"duration": 2388,
				"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": 53456,
					"name": "Warma",
					"face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
				},
				"stat": {
					"aid": 87673204,
					"view": 1383542,
					"danmaku": 88908,
					"reply": 9237,
					"favorite": 32929,
					"coin": 68849,
					"share": 5140,
					"now_rank": 0,
					"his_rank": 52,
					"like": 116164,
					"dislike": 0
				},
				"dynamic": "来做个自我介绍吧！ #warma##沃玛##爆炸电台#",
				"cid": 149793525,
				"dimension": {
					"width": 1920,
					"height": 1080,
					"rotate": 0
				},
				"bvid": "BV1D7411t7Be",
				"inter_video": false
			}, {
				"aid": 62910468,
				"videos": 1,
				"tid": 21,
				"tname": "日常",
				"copyright": 1,
				"pic": "http://i2.hdslb.com/bfs/archive/4bd598f71a144d4505e259b143c0de0bf27968b2.jpg",
				"title": "【warma爆炸电台】居然收到了几千条问题！【第七期】",
				"pubdate": 1565345410,
				"ctime": 1565338559,
				"desc": "时隔半年的爆炸电台第七期终于来啦！在这一期里回答了很多问题，祝看得开心！此外，就在昨天，50万订阅了…真的谢谢大家！\n也欢迎来看往期的电台：\n第一期：av6786024 （2016年10月）\n第二期：av10373352（2017年5月）\n第三期：av13619263（2017年8月）\n第四期：av18862091（2018年1月）\n第五期：av25092410（2018年6月）\n第六期：av42492515（2019年2月）",
				"state": 0,
				"attribute": 16512,
				"duration": 1987,
				"mission_id": 11740,
				"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": 53456,
					"name": "Warma",
					"face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
				},
				"stat": {
					"aid": 62910468,
					"view": 455277,
					"danmaku": 19383,
					"reply": 2108,
					"favorite": 10507,
					"coin": 19422,
					"share": 1208,
					"now_rank": 0,
					"his_rank": 0,
					"like": 31515,
					"dislike": 0
				},
				"dynamic": "爆炸电台 第七期 来啦！",
				"cid": 109284065,
				"dimension": {
					"width": 1920,
					"height": 1080,
					"rotate": 0
				},
				"bvid": "BV1gt411K7Ga",
				"inter_video": false
			}]
		},
		"page": {
			"count": 7,
			"num": 1,
			"size": 2
		}
	}
}

查看用户空间公告

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

方式:GET

参数：

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

json回复：

根对象：

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

示例：

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

http://api.bilibili.com/x/space/notice?mid=53456

{
    "code":0,
    "message":"0",
    "ttl":1,
    "data":"我的微博 @_warma_\n直播录像上传到：warma养鸽场\n头像画师是：微博@Dr-H_喵_\n横幅画师：@薬屋"
}

查看用户个人TAG

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

方式:GET

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

带有转义

参数：

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

json回复：

根对象：

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

data数组：

项	类型	内容	备注
0	obj	信息本体	只有1项？？？

data数组中的对象：

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

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

项	类型	内容	备注
0	str	TAG1
n	str	TAG(n+1)
……	str	……
4	str	TAG5	上限5条

示例：

查看用户UID=53456的个人TAG

http://api.bilibili.com/x/space/acc/tags?mid=53456

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": [{
		"mid": 53456,
		"tags": ["\u6e38\u620f", "\u97f3\u4e50", "warma", "\u641e\u7b11", "\u52a8\u753b"]
	}]
}

设置相关

修改个人签名

http://api.bilibili.com/x/member/web/sign/update

方式：POST

签名最多支持70个字

修改签名不会立即生效，会等待审核队列稍后生效

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名	类型	内容	必要性	备注
user_sign	data	要设置的签名内容	非必要	删除签名留空或省去即可
csrf	data	cookies中的bili_jct	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败 40022：签名过长
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确

示例：

更新个人标签为高中技术宅一枚，爱好MC&电子&音乐&数码&编程，资深猿厨

curl -b "SESSDATA=xxx" -d "user_sign=%E9%AB%98%E4%B8%AD%E6%8A%80%E6%9C%AF%E5%AE%85%E4%B8%80%E6%9E%9A%EF%BC%8C%E7%88%B1%E5%A5%BDMC&%E7%94%B5%E5%AD%90&%E9%9F%B3%E4%B9%90&%E6%95%B0%E7%A0%81&%E7%BC%96%E7%A8%8B%EF%BC%8C%E8%B5%84%E6%B7%B1%E7%8C%BF%E5%8E%A8&csrf=xxx" "http://api.bilibili.com/x/member/web/sign/update"

{
    "code":0,
    "message":"0",
    "ttl":1
}

修改用户空间公告

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

方式：POST

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名	类型	内容	必要性	备注
notice	data	要设置的公告内容	非必要	删除公告留空或省去即可 公告最多150字符
csrf	data	cookies中的bili_jct	必要

json回复：

根对象：

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

示例：

修改个人空间公告为鸽子

curl -b "sessdata=xxx" -d "csrf=xxx&notice=%E9%B8%BD%E5%AD%90" "http://api.bilibili.com/x/space/notice/set"

{
    "code": 0,
    "message": "0",
    "ttl": 1
}

修改个人TAG

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

方式：POST

需要登录(SESSDATA)

需要验证DedeUserID存在且不为0

参数（ application/x-www-form-urlencoded ）：

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

json回复：

根对象：

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

示例：

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

curl -b "SESSDATA=xxx;DedeUserID=1" -d "csrf=xxx&tags=minecraft%2C%E6%8A%80%E6%9C%AF%E5%AE%85%2C%E5%A4%A7%E4%BD%AC%2C%E5%B0%8F%E5%93%A5%E5%93%A5%2C%E5%8F%AF%E7%88%B1" "http://api.bilibili.com/x/space/acc/tags/set"

{
    "code": 0,
    "message": "0",
    "ttl": 1
}