个人空间相关-哔哩哔哩用户 API

  • 2020 年 08 月 04 日
  • 614
  • 7293 字
  • 12 条评论

用户空间相关

主页

置顶视频

查询用户置顶视频

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

请求方式:GET

粉丝在其主页上可见

url 参数:

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

json 回复:

根对象:

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

data 对象:

字段类型内容备注
aidnum视频 avID
videosnum视频分 P 总数默认为 1
tidnum分区 ID
tnamestr子分区名称
copyrightnum版权标志1:自制 2:转载
picstr视频封面图片 url
titlestr视频标题
pubdatenum视频上传时间时间戳
ctimenum视频审核通过时间时间戳
descstr视频简介
statenum0作用尚不明确
attributenum 作用尚不明确
durationnum视频总计持续时长(所有分 P)单位为秒
rightsobj视频属性标志
ownerobj视频 UP 主信息
statobj视频状态数
dynamicstr视频同步发布的的动态的文字内容无为空
cidnum视频 1P CID
dimensionobj视频 1P 分辨率
bvidstr视频 bvID
reasonstr置顶视频备注
inter_videobool是否为合作视频false:否 true:是

data 中的 rights 对象:

字段类型内容备注
bpnum0作用尚不明确
elecnum0作用尚不明确
downloadnum允许下载标志0:不允许 1:允许
movienum视频时电影标志0:否 1:是
paynum仅会员可观看标志0:无 1:有
hd5num有高码率标志0:无 1:有
no_reprintnum禁止转载标志0:无 1:禁止
autoplaynum可自动播放标志0:无 1:有 区别影视番剧与普通视频
ugc_paynum0作用尚不明确
is_cooperationnum视频合作标志0:无 1:是
ugc_pay_previewnum0作用尚不明确
no_backgroundnum0作用尚不明确

data 中的 owner 对象:

字段类型内容备注
midnumUP 主 UID
namestrUP 主昵称
facestrUP 主头像

data 中的 stat 对象:

字段类型内容备注
aidnum视频 avID
viewnum普通:观看次数 屏蔽时:-1
danmakunum弹幕条数
replynum评论条数
favoritenum收藏人数
coinnum投币枚数
sharenum分享次数
now_ranknum0作用尚不明确
his_ranknum历史最高排行
likenum获赞次数
dislikenum0作用尚不明确
evaluationstr视频评分默认为空

data 中的 dimension 对象

字段类型内容备注
widthnum当前分 P 宽度可能为 0
heightnum当前分 P 高度可能为 0
rotatenum是否将宽高对换0:正常 1:对换

示例:

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

curl -G 'http://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
    }
}

设置置顶视频

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

请求方式:POST

认证方式:Cookie(SESSDATA)

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

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

json 回复:

根对象:

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

示例:

置顶视频 av98948772/BV1n741127LD

avID 方式:

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

bvID 方式:

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

取消置顶视频

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

请求方式:POST

认证方式:Cookie(SESSDATA)

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

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

json 回复:

根对象:

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

示例:

curl 'http://api.bilibili.com/x/space/top/arc/cancel'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

代表作视频

查询用户代表作视频列表

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

请求方式:GET

新访客在其主页上可见

最多可以设置 3 个

url 参数:

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

json 回复:

根对象:

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

data 数组:

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

data 数组中的对象:

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

示例:

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

curl -G 'http://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
    }]
}

添加代表作视频

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

请求方式:POST

认证方式:Cookie(SESSDATA)

代表作上限为 3 个稿件

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

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

json 回复:

根对象:

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

示例:

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

avID 方式:

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

bvID 方式:

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

删除代表作视频

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

请求方式:POST

认证方式:Cookie(SESSDATA)

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

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

json 回复:

根对象:

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

示例:

删除置顶视频 av59765630/BV1Yt41137T6

avID 方式:

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

bvID 方式:

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

个人 TAG

查看用户个人 TAG

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

请求方式:GET

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

带有转义

url 参数:

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

json 回复:

根对象:

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

data 数组:

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

data 数组中的对象:

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

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

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

示例:

查看用户 UID=53456 的个人 TAG

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

修改个人 TAG

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

请求方式:POST

认证方式:Cookie(SESSDATA)

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

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

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

json 回复:

根对象:

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

示例:

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

curl 'http://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
}

空间公告

查看用户空间公告

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

请求方式:GET

url 参数:

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

json 回复:

根对象:

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

示例:

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

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

修改空间公告

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

请求方式:POST

认证方式:Cookie(SESSDATA)

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

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

json 回复:

根对象:

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

示例:

修改个人空间公告为鸽子

curl 'http://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/setIndexOrder

请求方式:POST

认证方式:Cookie(SESSDATA)

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

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

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

布局参数 index_order

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

json 回复:

根对象:

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

示例:

调整空间布局为:

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

curl 'http://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 中 DedeUserIDDedeUserID__ckMd5 存在且不为 0,referer 为 .bilibili.com 域名下

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

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

json 回复:

根对象:

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

示例:

设置关注的TAG 为隐藏

curl 'http://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
}

查询用户最近玩过的游戏

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

请求方式:GET

url 参数:

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

json 回复:

根对象:

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

data 数组:

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

data 数组中的对象:

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

示例:

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

curl -G 'http://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": "明日方舟"
        }
    ]
}

投稿

img

查询用户投稿视频明细

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

请求方式:GET

url 参数:

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

json 回复:

根对象:

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

data 对象:

字段类型内容备注
listobj列表信息
pageobj页面信息

data 中的 list 对象:

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

list 中的 tlist 对象:

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

tlist 中的 {tID} 对象:

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

list 中的 vlist 数组:

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

list 中的 vlist 数组中的对象:

字段类型内容备注
aidnum稿件 avID
authorstr视频 UP 主不一定为目标用户(合作视频)
bvidstr稿件 bvID
commentnum视频评论数
copyrightstr作用尚不明确
creatednum投稿时间时间戳
descriptionstr视频简介
hide_clickboolfalse作用尚不明确
is_paynum0作用尚不明确
is_union_videonum是否为合作视频0:否 1:是
lengthstr视频长度MM:SS
midnum视频 UP 主 UID不一定为目标用户(合作视频)
picstr视频封面
playnum视频播放次数
reviewnum0作用尚不明确
subtitlestr作用尚不明确
titlestr视频标题
typeidnum视频分区 tID
video_reviewnum视频弹幕数

data 中的 page 对象:

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

示例:

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

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

curl -G 'http://api.bilibili.com/x/space/arc/search'\
--data-urlencode 'ps=2'\
--data-urlencode '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://api.bilibili.com/x/space/album/index

请求方式:GET

所有类型的相簿

url 参数:

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

json 回复:

根对象:

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

data 数组:

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

data 数组中的对象:

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

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

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

pictures 数组中的对象:

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

示例:

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

curl -G 'http://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
    }]
}

查询用户投稿相簿明细

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

请求方式:GET

url 参数:

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

json 回复:

根对象:

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

data 对象:

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

items 数组:

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

items 数组中的对象:

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

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

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

pictures 数组中的对象:

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

示例:

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

curl -G 'http://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
        }]
    }
}

频道

查询用户频道列表

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

请求方式:GET

url 参数:

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

json 回复:

根对象:

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

data 对象:

字段类型内容备注
countnum总计频道数
listarray频道列表

data 中的 list 数组:

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

data 中的 list 数组中的对象:

字段类型内容备注
cidnum频道 ID
countnum频道内含视频数
coverstr封面图片 url
introstr简介无则为空
midnum创建用户 UID
mtimenum创建时间时间戳
namestr标题

示例:

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

curl -G 'http://api.bilibili.com/x/space/channel/list'\
--data-urlencode '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

url 参数:

参数名类型内容必要性备注
midnum目标用户 UID必要
cidnum目标频道 ID必要
pnnum页码非必要默认为 1
psnum每页项数非必要默认为 100

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 -400:请求错误 -404:无用户对应的频道
messagestr错误信息默认为 0
ttlnum1
dataobj信息本体

data 对象:

字段类型内容备注
listobj频道信息
pageobj页面信息

data 中的 list 对象:

字段类型内容备注
archivesarray包含的视频列表
cidnum频道 ID
countnum频道内含视频数
coverstr封面图片 url
introstr简介无则为空
midnum创建用户 UID
mtimenum创建时间时间戳
namestr标题

list 中的 archives 数组:

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

list 中的 archives 数组中的对象:

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

data 中的 page 对象:

字段类型内容备注
countnum总计视频数
numnum当前页码
sizenum每页项数

示例:

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

curl -G 'http://api.bilibili.com/x/space/channel/video'\
--data-urlencode 'mid=53456'\
--data-urlencode 'cid=170'\
--data-urlencode 'ps=2'\
--data-urlencode '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/channel/add

请求方式:POST

认证方式:Cookie(SESSDATA)

创建成功后会返回新建频道的 ID

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

参数名类型内容必要性备注
namestr频道名必要
introstr频道简介非必要
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 -101:账号未登录 -111:csrf 校验失败 -400:请求错误 53001:频道名字数超过限制 53002:频道简介字数超过限制 53004:创建的频道已经满额 53007:频道名称已经存在 53024:编辑内容命中敏感信息
messagestr错误信息默认为 0
ttlnum1
dataobj数据本体成功有此项

data 对象:

字段类型内容备注
cidnum频道 ID

示例:

创建名为 test1 的频道,简介为空

curl 'http://api.bilibili.com/x/space/channel/add'\
--data-urlencode 'name=test1'\
--data-urlencode 'intro='\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "cid": 138996
    }
}

修改频道

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

请求方式:POST

认证方式:Cookie(SESSDATA)

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

参数名类型内容必要性备注
cidnum频道 ID必要
namestr频道名必要
introstr频道简介非必要
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 -101:账号未登录 -111:csrf 校验失败 -400:请求错误 53001:频道名字数超过限制 53002:频道简介字数超过限制 53007:频道名称已经存在 53024:编辑内容命中敏感信息
messagestr错误信息默认为 0
ttlnum1

示例:

修改频道 138996 名称为测试,简介为 123456

curl 'http://api.bilibili.com/x/space/channel/edit'\
--data-urlencode 'cid=138996'\
--data-urlencode 'name=测试'\
--data-urlencode 'intro=123456'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

删除频道

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

请求方式:POST

认证方式:Cookie(SESSDATA)

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

参数名类型内容必要性备注
cidnum需要删除的频道 ID必要
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

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

示例:

删除频道 138996

curl 'http://api.bilibili.com/x/space/channel/del'\
--data-urlencode 'cid=138996'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

频道添加视频

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

请求方式:POST

认证方式:Cookie(SESSDATA)

仅能添加自己是 UP 主的视频

如添加多个视频,仅会添加正确的

注:完成后需要使用接口「查询用户频道中的视频」刷新

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

参数名类型内容必要性备注
cidnum频道 ID必要
aidsnums要添加的目标视频 avID必要多个使用 ","(%2C)分隔
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 -101:账号未登录 -111:csrf 校验失败 -400:请求错误 -404:无此项 53003:本频道里的视频已满 53006:提交视频已失效或频道里有(非该视频 UP 主)
messagestr错误信息默认为 0
ttlnum1
dataarray出错视频 avID 列表

data 数组:

类型内容备注
0num出错视频 avID1
nnum出错视频 avID(n+1)
……num…………

示例:

向频道 138995 中添加视频 av583785685av243322853

curl 'http://api.bilibili.com/x/space/channel/video/add'\
--data-urlencode 'cid=138995'\
--data-urlencode 'aids=583785685,243322853'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": []
}

频道删除视频

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

请求方式:POST

认证方式:Cookie(SESSDATA)

注:完成后需要使用接口「查询用户频道中的视频」刷新

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

参数名类型内容必要性备注
cidnum频道 ID必要
aidnum要删除的目标视频 avID必要
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 -101:账号未登录 -111:csrf 校验失败 -400:请求错误 -404:无此项 53008:频道内没有视频 53009:频道内没有该视频
messagestr错误信息默认为 0
ttlnum1

示例:

删除频道 138995 中的视频 av583785685

curl 'http://api.bilibili.com/x/space/channel/video/del'\
--data-urlencode 'cid=138995'\
--data-urlencode 'aid=583785685'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

调整频道视频排序

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

请求方式:POST

认证方式:Cookie(SESSDATA)

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

参数名类型内容必要性备注
cidnum频道 ID必要
aidnum要移动的目标视频 avID必要
tonum视频排序倒数位置非必要默认为 1 1 为列表底部,视频总数为首端 与显示顺序恰好相反
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

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

示例:

调整 138995 中的视频 av583785685 位置为倒数第 2

curl 'http://api.bilibili.com/x/space/channel/video/sort'\
--data-urlencode 'cid=138995'\
--data-urlencode 'aid=583785685'\
--data-urlencode 'to=2'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

检查频道中有无失效视频

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

请求方式:GET

认证方式:Cookie(SESSDATA)

url 参数:

参数名类型内容必要性备注
cidnum目标频道 ID必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 -101:账号未登录 -400:请求错误 -404:无此项 53005:频道内有失效视频
messagestr错误信息默认为 0
ttlnum1

示例:

检查频道 138995

curl -G 'http://api.bilibili.com/x/space/channel/video/check
--data-urlencode 'cid=138995'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

收藏

img

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

http://api.bilibili.com/x/v3/fav/folder/created/list-all

请求方式:GET

认证方式:Cookie(SESSDATA)

查看私有收藏夹时需要认证

url 参数:

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

json 回复:

根对象:

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

data 对象:

字段类型内容备注
countnum创建的收藏夹数
list无收藏夹时:null 有收藏夹时:array收藏夹列表

data 中的 list 数组:

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

data 中的 list 数组中的对象:

字段类型内容备注
idnum收藏夹 mlID
fidnum原始收藏夹 ID去除两位 UID 尾号
midnum创建用户 UID
attrnum收藏夹属性转换成 8-bit 二进制处理 详细说明见下表
titlestr收藏夹标题
fav_statenum0作用尚不明确
media_countnum收藏夹总计视频数

attr 属性二进制值表:

其他有待补充...1:默认收藏夹0:公开性
0:默认收藏夹 1:其他收藏夹0:公开 1:私有

示例:

查询用户 UID=7792521 的收藏夹列表

curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all'\
--data-urlencode 'up_mid=7792521'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "count": 5,
        "list": [{
            "id": 44233921,
            "fid": 442339,
            "mid": 7792521,
            "attr": 0,
            "title": "默认收藏夹",
            "fav_state": 0,
            "media_count": 85
        }, {
            "id": 936347621,
            "fid": 9363476,
            "mid": 7792521,
            "attr": 22,
            "title": "放假君的鬼畜私房歌",
            "fav_state": 0,
            "media_count": 2
        }, {
            "id": 845218621,
            "fid": 8452186,
            "mid": 7792521,
            "attr": 22,
            "title": "♪一言不合就开唱♪",
            "fav_state": 0,
            "media_count": 4
        }, {
            "id": 844998121,
            "fid": 8449981,
            "mid": 7792521,
            "attr": 22,
            "title": "个人作品精选",
            "fav_state": 0,
            "media_count": 25
        }, {
            "id": 381779121,
            "fid": 3817791,
            "mid": 7792521,
            "attr": 22,
            "title": "鬼畜小课堂",
            "fav_state": 0,
            "media_count": 25
        }]
    }
}

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

http://api.bilibili.com/x/v3/fav/folder/collected/list

请求方式:GET

url 参数:

参数名类型内容必要性备注
psnum每页项数必要
pnnum页码必要
up_midnum目标用户 UID必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 -101:账号未登录 -111:csrf 校验失败 40022:签名过长
messagestr错误信息默认为 0
ttlnum1
data隐藏时:null 公开时:obj信息本体

data 对象:

字段类型内容备注
countnum创建的收藏夹数
list无收藏夹时:null 有收藏夹时:array收藏夹列表

data 中的 list 数组:

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

data 中的 list 数组中的对象:

字段类型内容备注
idnum收藏夹 mlID
fidnum原始收藏夹 ID去除两位 UID 尾号
midnum创建用户 UID
attrnum收藏夹属性转换成 8-bit 二进制处理 详细说明见下表
titlestr收藏夹标题
coverstr收藏夹封面图片 url
upperobj收藏夹创建用户信息
cover_typenum2作用尚不明确
introstr作用尚不明确
ctimenum创建时间时间戳
mtimenum审核时间时间戳
statenum0作用尚不明确
fav_statenum0作用尚不明确
media_countnum收藏夹总计视频数

attr 属性二进制值表:

其他有待补充...1:默认收藏夹0:公开性
0:默认收藏夹 1:其他收藏夹0:公开 1:私有

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

字段类型内容备注
midnum创建人 UID
namestr创建人昵称
facestr作用尚不明确

示例:

查询用户 UID=293793435 的收藏夹收藏列表

curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list'\
--data-urlencode 'up_mid=293793435'\
--data-urlencode 'ps=20'\
--data-urlencode 'pn=1'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "count": 2,
        "list": [{
            "id": 496307088,
            "fid": 4963070,
            "mid": 412466388,
            "attr": 22,
            "title": "入站必刷",
            "cover": "http://i0.hdslb.com/bfs/archive/baae2b4050363c0ab45465b7cf696b8304fdaca8.jpg",
            "upper": {
                "mid": 412466388,
                "name": "热门菌",
                "face": ""
            },
            "cover_type": 2,
            "intro": "",
            "ctime": 1563394571,
            "mtime": 1563394571,
            "state": 0,
            "fav_state": 0,
            "media_count": 55
        }, {
            "id": 381779121,
            "fid": 3817791,
            "mid": 7792521,
            "attr": 22,
            "title": "鬼畜小课堂",
            "cover": "http://i2.hdslb.com/bfs/archive/09a668cfdb38fb3a85f905c10f48a2947e36a695.jpg",
            "upper": {
                "mid": 7792521,
                "name": "还有一天就放假了",
                "face": ""
            },
            "cover_type": 2,
            "intro": "",
            "ctime": 1553700224,
            "mtime": 1557291666,
            "state": 0,
            "fav_state": 0,
            "media_count": 25
        }]
    }
}

订阅

订阅查询用户追番预览列表

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

请求方式:GET

认证方式:Cookie(SESSDATA)

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

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

url 参数:

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

json 回复:

根对象:

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

data 对象:

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

data 中的 result 数组:

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

data 中的 result 数组中的对象:

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

示例:

查看用户 UID=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不..."
        }, 
        …………
        ]
    }
}

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

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

请求方式:GET

认证方式:Cookie(SESSDATA)

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

url 参数:

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

json 回复:

根对象:

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

data 对象:

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

data 中的 list 数组:

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

data 中的 list 数组中的对象:

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

示例:

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

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

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

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

请求方式:GET

认证方式:Cookie(SESSDATA)

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

带有转义

只显示前 100 个

url 参数:

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

json 回复:

根对象:

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

data 对象:

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

data 中的 tags 数组:

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

data 中的 tags 数组中的对象:

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

示例:

查询用户 UID=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
    }
}

原文地址:https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/user/space.md


版权属于:Aini99

本文链接:https://bv-av.cn/read/cv15

本站部分内容转载于互联网,目的是为了传达信息。如果有内容侵犯了你的版权,请联系 QQ:1144560054。我们会在审查后第一时间进行修改。


—— 收到 12 条评论 ——

评论已关闭