# 用户空间相关 ## 查询相关 ### 查询用户置顶视频 >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`对象: 基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息(avID/bvID互转))」中的data对象 示例: 查询用户`UID=23215368`的置顶视频 http://api.bilibili.com/x/space/top/arc?vmid=23215368 ```json { "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`数组中的对象: 基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息(avID/bvID互转))」中的data对象 示例: 查询用户`UID=23215368`的代表作视频列表 http://api.bilibili.com/x/space/masterpiece?vmid=23215368 ```json { "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 | 视频封面 | jpg gif | | 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 ```json { "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/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 ```json { "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/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 ```json { "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 ```json { "code": 0, "message": "0", "ttl": 1, "data": [{ "mid": 53456, "tags": ["\u6e38\u620f", "\u97f3\u4e50", "warma", "\u641e\u7b11", "\u52a8\u753b"] }] } ```