diff --git a/docs/user/relation.md b/docs/user/relation.md index d9e5d43..2ecb74b 100644 --- a/docs/user/relation.md +++ b/docs/user/relation.md @@ -18,13 +18,15 @@ | contract_info | obj | 契约计划相关信息 | | | uname | str | 用户昵称 | | | face | str | 用户头像url | | -| face_nft | num | 是否为 NFT 头像 | 0:非 NFT 头像
1:NFT 头像 | | sign | str | 用户签名 | | +| face_nft | num | 是否为 NFT 头像 | 0:非 NFT 头像
1:NFT 头像 | | official_verify | obj | 认证信息 | | | vip | obj | 会员信息 | | +| name_render | 有效时:obj
无效时:null | 昵称渲染信息 | | | nft_icon | str | (?) | | -| rec_reason | str | (?) | | -| track_id | str | (?) | | +| rec_reason | str | 推荐该用户的原因 | 一般为空;如:`xxx关注了TA`、`xx粉丝 xx视频` | +| track_id | str | 内部记录id | 一般为空;如:`up_rec_0.router-main-2021485-5f84c987cf-dv8fg.1746380060327.607` | +| follow_time | str | (?) | | `list`中的对象中的`tag`数组: @@ -43,7 +45,6 @@ | ts | num | 对方成为目标用户的契约者的时间 | 秒级时间戳,仅当 `is_contractor` 项的值为 `true` 时才有此项 | | user_attr | num | 对方作为目标用户的契约者的属性 | 1:老粉
否则为原始粉丝
仅当有特殊属性时才有此项 | - `list`中的对象中的`official_verify`对象: | 字段 | 类型 | 内容 | 备注 | @@ -70,9 +71,187 @@ | ---- | ---- | ------ | ---- | | path | str | (?) | | -### 查询用户粉丝明细 +### 查询用户粉丝明细(新) -> https://api.bilibili.com/x/relation/followers +> + +*请求方式:GET* + +认证方式:Cookie(SESSDATA) + +本接口只有登录、标头 `referer` 为 `bilibili.com` 下的子域名、UA 不含 `python` 时才会返回列表 + +由于接口实现不同,本接口的返回可能出现以下三种情况: + +1. 返回列表按关注时间排序,此时当前用户**仅返回前 1000 名粉丝**,其他用户仅返回前 100 名粉丝,若继续往后查询则返回空列表 +2. 返回列表按粉丝 mid 的**文本形式**排序,此时对于任意用户均可返回全部粉丝 +3. 返回列表按照**智能推荐算法**排序,此时请求参数 `from=main` 且目标用户为自己,**仅返回前 1000 名粉丝** + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ------------------------------------------------------------------- | +| vmid | num | 目标用户 mid | 必要 | | +| ps | num | 每页项数 | 非必要 | 默认为 50 | +| pn | num | 页码 | 非必要 | 默认为 1 | +| offset | str | 偏移量 | 非必要 | 此项有效且不为 `rcmd` 时会从此偏移量开始返回粉丝列表,忽略参数 `pn` | +| from | str | 请求来源 | 非必要 | 当为 `main` 且目标用户为自己时,粉丝列表按照**智能推荐算法**排序,此时 `&.data.list[]` 中的 `rec_reason` 与 `track_id` 为非空 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------------------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录
-352:请求被拦截
-400:请求错误
22118:由于该用户隐私设置,粉丝列表不可见 | +| message | str | 错误信息 | 默认为 0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| offset | str | 偏移量 | 供下次请求使用
普通:`{列表最后的粉丝的 mtime}:{列表最后的粉丝的 mid}`
智能推荐算法:`rcmd` | +| re_version | num | (?) | | +| total | num | 粉丝总数 | | + +`data`中的`list`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ---------------------------------- | +| 0 | obj | 粉丝 1 | 详见 [关系列表对象](#关系列表对象) | +| n | obj | 粉丝 (n+1) | 按照添加顺序排列 | +| …… | obj | …… | …… | + +**示例:** + +获取用户`mid=293793435`的粉丝明细 + +```shell +curl -G 'https://api.bilibili.com/x/relation/fans' \ + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 289796932, + "attribute": 0, + "mtime": 1746199088, + "tag": null, + "special": 0, + "contract_info": { + + }, + "uname": "Astlinga_星灵", + "face": "https://i1.hdslb.com/bfs/face/005264524d05c0b8c132acc3ee88bb839351025b.jpg", + "sign": "", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1734278400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "avatar_subscript_url": "" + }, + "name_render": { + + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "", + "follow_time": "" + }, + { + "mid": 3494375621396821, + "attribute": 0, + "mtime": 1746098997, + "tag": null, + "special": 0, + "contract_info": { + + }, + "uname": "JSRCode", + "face": "https://i1.hdslb.com/bfs/face/f6c74700c72d27ae224c5311634b4a3770e3cdcf.jpg", + "sign": "一个喜欢码代码的高中牲", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 0, + "vipDueDate": 0, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "avatar_subscript_url": "" + }, + "name_render": { + + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "", + "follow_time": "" + } + ], + "offset": "1746098997:3494375621396821", + "re_version": 0, + "total": 3776 + } +} +``` + +
+ +### 查询用户粉丝明细(旧) + +> *请求方式:GET* @@ -124,10 +303,10 @@ ```shell curl -G 'https://api.bilibili.com/x/relation/followers' \ - --data-urlencode 'vmid=293793435' \ - --data-urlencode 'ps=2' \ - --data-urlencode 'pn=1' \ - -b 'SESSDATA=xxx' + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -135,64 +314,107 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [{ - "mid": 387195656, - "attribute": 0, - "mtime": 1583839793, - "tag": null, - "special": 0, - "uname": "L_E_M_O_H_E", - "face": "https://i1.hdslb.com/bfs/face/8ec537db75eeb292faa8dc85a9ff8aba83148c86.jpg", - "sign": "暂时断更。。Back later", - "official_verify": { - "type": -1, - "desc": "" - }, - "vip": { - "vipType": 0, - "vipDueDate": 0, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 0, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }, { - "mid": 175989424, - "attribute": 0, - "mtime": 1583822019, - "tag": null, - "special": 0, - "uname": "哥本哈根iii", - "face": "https://i1.hdslb.com/bfs/face/e53c0fe9315176d48bd294b1f381f0da70131cd7.jpg", - "sign": "", - "official_verify": { - "type": -1, - "desc": "" - }, - "vip": { - "vipType": 0, - "vipDueDate": 0, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 0, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }], - "re_version": 3857745402, - "total": 365 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 289796932, + "attribute": 0, + "mtime": 1746199088, + "tag": null, + "special": 0, + "contract_info": { + + }, + "uname": "Astlinga_星灵", + "face": "https://i1.hdslb.com/bfs/face/005264524d05c0b8c132acc3ee88bb839351025b.jpg", + "sign": "", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1734278400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "avatar_subscript_url": "" + }, + "name_render": { + + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "", + "follow_time": "" + }, + { + "mid": 3494375621396821, + "attribute": 0, + "mtime": 1746098997, + "tag": null, + "special": 0, + "contract_info": { + + }, + "uname": "JSRCode", + "face": "https://i1.hdslb.com/bfs/face/f6c74700c72d27ae224c5311634b4a3770e3cdcf.jpg", + "sign": "一个喜欢码代码的高中牲", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 0, + "vipDueDate": 0, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "avatar_subscript_url": "" + }, + "name_render": { + + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "", + "follow_time": "" + } + ], + "re_version": 0, + "total": 3776 + } } ``` @@ -200,7 +422,7 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \ ### 查询用户关注明细 -> https://api.bilibili.com/x/relation/followings +> *请求方式:GET* @@ -253,11 +475,11 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \ ```shell curl -G 'https://api.bilibili.com/x/relation/followings' \ - --data-urlencode 'vmid=293793435' \ - --data-urlencode 'order_type=' \ - --data-urlencode 'ps=2' \ - --data-urlencode 'pn=1' \ - -b 'SESSDATA=xxx' + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'order_type=' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -265,64 +487,82 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [{ - "mid": 14082, - "attribute": 2, - "mtime": 1584271945, - "tag": null, - "special": 0, - "uname": "山新", - "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg", - "sign": "都说了是天依爹地,不是妈咪。\r私信有点多回复不过来~商业合作啥的请移步Weibo私信@山新 哦哦哦~", - "official_verify": { - "type": 0, - "desc": "配音演员、声优。洛天依声源提供者。" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1601654400000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }, { - "mid": 420831218, - "attribute": 2, - "mtime": 1584208169, - "tag": [207542], - "special": 0, - "uname": "支付宝Alipay", - "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", - "sign": "阿支来了,关注点赞转发投币四连走起!", - "official_verify": { - "type": 1, - "desc": "支付宝官方账号" - }, - "vip": { - "vipType": 1, - "vipDueDate": 1585065600000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }], - "re_version": 3228575555, - "total": 699 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [{ + "mid": 14082, + "attribute": 2, + "mtime": 1584271945, + "tag": null, + "special": 0, + "contract_info": {}, + "uname": "山新", + "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg", + "sign": "都说了是天依爹地,不是妈咪。\r私信有点多回复不过来~商业合作啥的请移步Weibo私信@山新 哦哦哦~", + "official_verify": { + "type": 0, + "desc": "配音演员、声优。洛天依声源提供者。" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1601654400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "avatar_subscript_url": "" + }, + "name_render": {}, + "nft_icon": "", + "rec_reason": "", + "track_id": "", + "follow_time": "" + }, { + "mid": 420831218, + "attribute": 2, + "mtime": 1584208169, + "tag": [207542], + "special": 0, + "contract_info": {}, + "uname": "支付宝Alipay", + "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", + "sign": "阿支来了,关注点赞转发投币四连走起!", + "official_verify": { + "type": 1, + "desc": "支付宝官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1585065600000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "avatar_subscript_url": "" + }, + "name_render": {}, + "nft_icon": "", + "rec_reason": "", + "track_id": "", + "follow_time": "" + }], + "re_version": 0, + "total": 1028 + } } ``` @@ -330,7 +570,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \ ### 查询用户关注明细2 -> https://app.biliapi.net/x/v2/relation/followings +> *请求方式:GET* @@ -386,7 +626,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \ | sign | str | 用户签名 | | | official_verify | obj | 认证信息 | | | vip | obj | 会员信息 | | -| live | num | 是否直播 | 0:未直播
1:直播中 | +| live | num | 是否直播 | 0:未直播
1:直播中 | 数组`list`中的对象中的`tag`数组: @@ -428,9 +668,9 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \ ```shell curl -G 'https://app.biliapi.net/x/v2/relation/followings' \ - --data-urlencode 'vmid=293793435' \ - --data-urlencode 'ps=2' \ - --data-urlencode 'pn=1' \ + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ ```
@@ -438,64 +678,66 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [{ - "mid": 14082, - "attribute": 2, - "mtime": 1584271945, - "tag": null, - "special": 0, - "uname": "山新", - "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg", - "sign": "都说了是天依爹地,不是妈咪。\r私信有点多回复不过来~商业合作啥的请移步Weibo私信@山新 哦哦哦~", - "official_verify": { - "type": 0, - "desc": "配音演员、声优。洛天依声源提供者。" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1601654400000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }, { - "mid": 420831218, - "attribute": 2, - "mtime": 1584208169, - "tag": [207542], - "special": 0, - "uname": "支付宝Alipay", - "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", - "sign": "阿支来了,关注点赞转发投币四连走起!", - "official_verify": { - "type": 1, - "desc": "支付宝官方账号" - }, - "vip": { - "vipType": 1, - "vipDueDate": 1585065600000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }], - "re_version": 3228575555, - "total": 699 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [{ + "mid": 14082, + "attribute": 2, + "mtime": 1584271945, + "tag": null, + "special": 0, + "uname": "山新", + "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg", + "sign": "都说了是天依爹地,不是妈咪。\r私信有点多回复不过来~商业合作啥的请移步Weibo私信@山新 哦哦哦~", + "official_verify": { + "type": 0, + "desc": "配音演员、声优。洛天依声源提供者。" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1601654400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + }, + "live": 0 + }, { + "mid": 420831218, + "attribute": 2, + "mtime": 1584208169, + "tag": [207542], + "special": 0, + "uname": "支付宝Alipay", + "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", + "sign": "阿支来了,关注点赞转发投币四连走起!", + "official_verify": { + "type": 1, + "desc": "支付宝官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1585065600000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + }, + "live": 0 + }], + "re_version": 3228575555, + "total": 699 + } } ``` @@ -503,7 +745,7 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \ ### 查询用户关注明细3 -> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list +> *请求方式:GET* @@ -545,12 +787,20 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \ 数组`list`中的对象: -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ---- | ----------- | --------------------------------------- | -| mid | str | 用户mid | | -| attribute | num | 关注属性 | 0:未关注
2:已关注
6:已互粉 | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | +| 字段 | 类型 | 内容 | 备注 | +| ----------------- | ---- | ------------------------------ | --------------------------------------- | +| mid | str | 用户mid | | +| attribute | num | 对方对于**目标用户**的关注属性 | 0:未关注
2:已关注
6:已互粉 | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| attention_display | obj | 用户认证信息 | | + +`attention_display`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ------------------------------------------------------------ | +| type | num | 是否认证 | 0:无
1:UP主专业认证
2:UP主认证
3:机构认证 | +| desc | str | 认证信息 | | **示例:** @@ -558,9 +808,9 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \ ```shell curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list' \ ---data-urlencode 'vmid=293793435' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' ```
@@ -568,22 +818,24 @@ curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationsh ```json { - "code": 0, - "data": { - "list": [{ - "mid": "14082", - "attribute": 2, - "uname": "山新", - "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg" - }, { - "mid": "420831218", - "attribute": 2, - "uname": "支付宝Alipay", - "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg" - }] - }, - "ts": 1677410818395, - "request_id": "d9d541b9f2d24e21821e2d6d2d16c17d" + "code": 0, + "data": { + "list": [{ + "mid": "14082", + "attribute": 2, + "uname": "山新", + "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg", + "attestation_display": { "type": 0, "desc": "" } + }, { + "mid": "420831218", + "attribute": 2, + "uname": "支付宝Alipay", + "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", + "attestation_display": { "type": 3, "desc": "bilibili机构认证:支付宝官方账号" } + }] + }, + "ts": 1677410818395, + "request_id": "d9d541b9f2d24e21821e2d6d2d16c17d" } ``` @@ -591,7 +843,7 @@ curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationsh ### 搜索关注明细 -> https://api.bilibili.com/x/relation/followings/search +> *请求方式:GET* @@ -616,7 +868,7 @@ curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationsh | ttl | num | 1 | | | data | obj | 信息本体 | | -data 对象: +`data` 对象: | 字段 | 类型 | 内容 | 备注 | | ---------- | ----- | -------- | ---- | @@ -638,11 +890,11 @@ data 对象: ```shell curl -G 'https://api.bilibili.com/x/relation/followings/search' \ - --data-urlencode 'vmid=293793435' \ - --data-urlencode 'name=warma' \ - --data-urlencode 'ps=2' \ - --data-urlencode 'pn=1' \ - -b 'SESSDATA=xxx' + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'name=warma' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -650,42 +902,42 @@ curl -G 'https://api.bilibili.com/x/relation/followings/search' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [ - { - "mid": 53456, - "attribute": 2, - "mtime": 1586415053, - "tag": [ - -10 - ], - "special": 1, - "uname": "Warma", - "face": "https://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg", - "sign": "我是沃玛,做点傻开心的视频。日常发在微博:@_warma_ ", - "official_verify": { - "type": 0, - "desc": "bilibili 知名UP主" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1637424000000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 53456, + "attribute": 2, + "mtime": 1586415053, + "tag": [ + -10 ], - "total": 1 - } + "special": 1, + "uname": "Warma", + "face": "https://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg", + "sign": "我是沃玛,做点傻开心的视频。日常发在微博:@_warma_ ", + "official_verify": { + "type": 0, + "desc": "bilibili 知名UP主" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1637424000000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + } + ], + "total": 1 + } } ``` @@ -693,7 +945,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings/search' \ ### 查询共同关注明细 -> https://api.bilibili.com/x/relation/same/followings +> *请求方式:GET* @@ -719,7 +971,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings/search' \ | ttl | num | 1 | | | data | obj | 信息本体 | | -data 对象: +`data` 对象: | 字段 | 类型 | 内容 | 备注 | | ---------- | ----- | -------- | ---- | @@ -741,10 +993,10 @@ data 对象: ```shell curl -G 'https://api.bilibili.com/x/relation/same/followings' \ ---data-urlencode 'vmid=2' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ --b 'SESSDATA=xxx' + --data-urlencode 'vmid=2' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -752,69 +1004,69 @@ curl -G 'https://api.bilibili.com/x/relation/same/followings' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [ - { - "mid": 116683, - "attribute": 2, - "mtime": 1564627532, - "tag": null, - "special": 0, - "uname": "=咬人猫=", - "face": "https://i0.hdslb.com/bfs/face/8fad84a4470f3d894d8f0dc95555ab8f2cb10a83.jpg", - "sign": "面瘫女仆酱~小粗腿~事业线什么的!!吐槽你就输了!喵~", - "official_verify": { - "type": 0, - "desc": "bilibili 2019百大UP主、高能联盟成员" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1618934400000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }, - { - "mid": 517717593, - "attribute": 2, - "mtime": 1592126052, - "tag": [ - 207542 - ], - "special": 0, - "uname": "上海爱丽丝幻乐团", - "face": "https://i0.hdslb.com/bfs/face/851a9191cbe93e66304d7577c0f6f83834e52109.jpg", - "sign": "日本同人社团 上海爱丽丝幻乐团", - "official_verify": { - "type": 0, - "desc": "上海爱丽丝幻乐团官方账号" - }, - "vip": { - "vipType": 1, - "vipDueDate": 1593792000000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 0, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 116683, + "attribute": 2, + "mtime": 1564627532, + "tag": null, + "special": 0, + "uname": "=咬人猫=", + "face": "https://i0.hdslb.com/bfs/face/8fad84a4470f3d894d8f0dc95555ab8f2cb10a83.jpg", + "sign": "面瘫女仆酱~小粗腿~事业线什么的!!吐槽你就输了!喵~", + "official_verify": { + "type": 0, + "desc": "bilibili 2019百大UP主、高能联盟成员" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1618934400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, + { + "mid": 517717593, + "attribute": 2, + "mtime": 1592126052, + "tag": [ + 207542 ], - "re_version": 2498273968, - "total": 38 - } + "special": 0, + "uname": "上海爱丽丝幻乐团", + "face": "https://i0.hdslb.com/bfs/face/851a9191cbe93e66304d7577c0f6f83834e52109.jpg", + "sign": "日本同人社团 上海爱丽丝幻乐团", + "official_verify": { + "type": 0, + "desc": "上海爱丽丝幻乐团官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1593792000000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + } + ], + "re_version": 2498273968, + "total": 38 + } } ``` @@ -822,7 +1074,7 @@ curl -G 'https://api.bilibili.com/x/relation/same/followings' \ ### 查询悄悄关注明细 -> https://api.bilibili.com/x/relation/whispers +> *请求方式:GET* @@ -845,7 +1097,7 @@ curl -G 'https://api.bilibili.com/x/relation/same/followings' \ | ttl | num | 1 | | | data | obj | 信息本体 | | -data 对象: +`data` 对象: | 字段 | 类型 | 内容 | 备注 | | ---------- | ----- | -------- | ---- | @@ -864,7 +1116,7 @@ data 对象: ```shell curl -G 'https://api.bilibili.com/x/relation/whispers' \ - -b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
@@ -872,47 +1124,48 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [ - { - "mid": 178429408, - "attribute": 1, - "mtime": 1605972105, - "tag": null, - "special": 0, - "uname": "老弟一号", - "face": "https://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg", - "sign": "萌新硬件玩家,前垃圾佬~(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328", - "official_verify": { - "type": 0, - "desc": "知识领域优质UP主" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1632499200000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - } - ], - "re_version": 2137574562 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 178429408, + "attribute": 1, + "mtime": 1605972105, + "tag": null, + "special": 0, + "uname": "老弟一号", + "face": "https://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg", + "sign": "萌新硬件玩家,前垃圾佬~(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328", + "official_verify": { + "type": 0, + "desc": "知识领域优质UP主" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1632499200000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + } + ], + "re_version": 2137574562 + } } ``` +
### 查询互相关注明细 -> https://api.bilibili.com/x/relation/friends +> *请求方式:GET* @@ -937,7 +1190,7 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \ | ttl | num | 1 | | | data | obj | 信息本体 | | -data 对象: +`data` 对象: | 字段 | 类型 | 内容 | 备注 | | ---------- | ----- | -------- | ---- | @@ -956,183 +1209,183 @@ data 对象: ```shell curl -G 'https://api.bilibili.com/x/relation/friends' \ - -b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
查看响应示例: -```json +```jsonc { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [ - { - "mid": 596000, - "attribute": 6, - "mtime": 1685110154, - "tag": null, - "special": 0, - "uname": "椛椛在睡觉", - "face": "https://i2.hdslb.com/bfs/face/365c1ef3b2a3afe21d6832796338fad5119b2592.jpg", - "sign": "欢迎来找椛椛玩~ https://blogs.momiji-jin.com/", - "face_nft": 0, - "official_verify": { - "type": -1, - "desc": "" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1702742400000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "", - "text": "年度大会员", - "label_theme": "annual_vip", - "text_color": "#FFFFFF", - "bg_style": 1, - "bg_color": "#FB7299", - "border_color": "" - }, - "avatar_subscript": 1, - "nickname_color": "#FB7299", - "avatar_subscript_url": "" - }, - "nft_icon": "", - "rec_reason": "", - "track_id": "" - }, - { - "mid": 24022863, - "attribute": 6, - "mtime": 1685026230, - "tag": [ - -10 - ], - "special": 1, - "uname": "黄禄轩电脑专用账号", - "face": "https://i0.hdslb.com/bfs/face/a70ec7d2a3822980a915ef4b30371af0cbc79132.jpg", - "sign": "若要私信,请私信「黄禄轩手机专用账号」http://space.bilibili.com/17640193/,群:410311648", - "face_nft": 0, - "official_verify": { - "type": -1, - "desc": "" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1686412800000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "", - "text": "年度大会员", - "label_theme": "annual_vip", - "text_color": "#FFFFFF", - "bg_style": 1, - "bg_color": "#FB7299", - "border_color": "" - }, - "avatar_subscript": 1, - "nickname_color": "#FB7299", - "avatar_subscript_url": "" - }, - "nft_icon": "", - "rec_reason": "", - "track_id": "" - }, - { - "mid": 85438718, - "attribute": 6, - "mtime": 1684759843, - "tag": [ - 194110 - ], - "special": 0, - "uname": "忘忧北萱草Official", - "face": "https://i2.hdslb.com/bfs/face/68d8cba01aab907dbb2cf2e17074f20947156237.jpg", - "sign": "现已加入 OrangeFire 豪华套餐!", - "face_nft": 0, - "official_verify": { - "type": -1, - "desc": "" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1691683200000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "", - "text": "年度大会员", - "label_theme": "annual_vip", - "text_color": "#FFFFFF", - "bg_style": 1, - "bg_color": "#FB7299", - "border_color": "" - }, - "avatar_subscript": 1, - "nickname_color": "#FB7299", - "avatar_subscript_url": "" - }, - "nft_icon": "", - "rec_reason": "", - "track_id": "" - }, - { - "mid": 41620134, - "attribute": 6, - "mtime": 1684759649, - "tag": null, - "special": 0, - "uname": "Tiggy_Chan", - "face": "https://i0.hdslb.com/bfs/face/8c8d9f43eda207f8cb8503bfdf6cc3802a1cd6c1.jpg", - "sign": "此号只发科技类视频,娱乐类转至:虎子酱233", - "face_nft": 0, - "official_verify": { - "type": -1, - "desc": "" - }, - "vip": { - "vipType": 1, - "vipDueDate": 1669219200000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 0, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "", - "text": "", - "label_theme": "", - "text_color": "", - "bg_style": 0, - "bg_color": "", - "border_color": "" - }, - "avatar_subscript": 0, - "nickname_color": "", - "avatar_subscript_url": "" - }, - "nft_icon": "", - "rec_reason": "", - "track_id": "" - }, - …… + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 596000, + "attribute": 6, + "mtime": 1685110154, + "tag": null, + "special": 0, + "uname": "椛椛在睡觉", + "face": "https://i2.hdslb.com/bfs/face/365c1ef3b2a3afe21d6832796338fad5119b2592.jpg", + "sign": "欢迎来找椛椛玩~ https://blogs.momiji-jin.com/", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1702742400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + }, + { + "mid": 24022863, + "attribute": 6, + "mtime": 1685026230, + "tag": [ + -10 ], - "re_version": 0 - } + "special": 1, + "uname": "黄禄轩电脑专用账号", + "face": "https://i0.hdslb.com/bfs/face/a70ec7d2a3822980a915ef4b30371af0cbc79132.jpg", + "sign": "若要私信,请私信「黄禄轩手机专用账号」http://space.bilibili.com/17640193/,群:410311648", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1686412800000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + }, + { + "mid": 85438718, + "attribute": 6, + "mtime": 1684759843, + "tag": [ + 194110 + ], + "special": 0, + "uname": "忘忧北萱草Official", + "face": "https://i2.hdslb.com/bfs/face/68d8cba01aab907dbb2cf2e17074f20947156237.jpg", + "sign": "现已加入 OrangeFire 豪华套餐!", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1691683200000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + }, + { + "mid": 41620134, + "attribute": 6, + "mtime": 1684759649, + "tag": null, + "special": 0, + "uname": "Tiggy_Chan", + "face": "https://i0.hdslb.com/bfs/face/8c8d9f43eda207f8cb8503bfdf6cc3802a1cd6c1.jpg", + "sign": "此号只发科技类视频,娱乐类转至:虎子酱233", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1669219200000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + }, + // …… + ], + "re_version": 0 + } } ``` @@ -1140,7 +1393,7 @@ curl -G 'https://api.bilibili.com/x/relation/friends' \ ### 查询黑名单明细 -> https://api.bilibili.com/x/relation/blacks +> *请求方式:GET* @@ -1165,7 +1418,7 @@ curl -G 'https://api.bilibili.com/x/relation/friends' \ | ttl | num | 1 | | | data | obj | 信息本体 | | -data 对象: +`data` 对象: | 字段 | 类型 | 内容 | 备注 | | ---------- | ----- | ------------ | ---- | @@ -1187,9 +1440,9 @@ data 对象: ```shell curl -G 'https://api.bilibili.com/x/relation/blacks' \ - --data-urlencode 'ps=2' \ - --data-urlencode 'pn=1' \ - -b 'SESSDATA=xxx' + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -1197,67 +1450,67 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [ - { - "mid": 22179720, - "attribute": 128, - "mtime": 1603032789, - "tag": null, - "special": 0, - "uname": "咩2016", - "face": "https://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg", - "sign": "", - "official_verify": { - "type": 0, - "desc": "" - }, - "vip": { - "vipType": 0, - "vipDueDate": 0, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 0, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }, - { - "mid": 16174624, - "attribute": 128, - "mtime": 1603026420, - "tag": null, - "special": 0, - "uname": "其实死亡没有那么痛", - "face": "https://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg", - "sign": "等我,我马上就来", - "official_verify": { - "type": 0, - "desc": "" - }, - "vip": { - "vipType": 0, - "vipDueDate": 0, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 0, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - } - ], - "re_version": 897205356, - "total": 2 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 22179720, + "attribute": 128, + "mtime": 1603032789, + "tag": null, + "special": 0, + "uname": "咩2016", + "face": "https://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg", + "sign": "", + "official_verify": { + "type": 0, + "desc": "" + }, + "vip": { + "vipType": 0, + "vipDueDate": 0, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, + { + "mid": 16174624, + "attribute": 128, + "mtime": 1603026420, + "tag": null, + "special": 0, + "uname": "其实死亡没有那么痛", + "face": "https://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg", + "sign": "等我,我马上就来", + "official_verify": { + "type": 0, + "desc": "" + }, + "vip": { + "vipType": 0, + "vipDueDate": 0, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + } + ], + "re_version": 897205356, + "total": 2 + } } ``` @@ -1269,7 +1522,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \ ### 操作用户关系 -> https://api.bilibili.com/x/relation/modify +> *请求方式:POST* @@ -1313,11 +1566,11 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \ ```shell curl 'https://api.bilibili.com/x/relation/modify' \ - --data-urlencode 'fid=14082' \ - --data-urlencode 'act=1' \ - --data-urlencode 're_src=11' \ - --data-urlencode 'csrf=xxx' \ - -b 'SESSDATA=xxx' + --data-urlencode 'fid=14082' \ + --data-urlencode 'act=1' \ + --data-urlencode 're_src=11' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -1325,9 +1578,9 @@ curl 'https://api.bilibili.com/x/relation/modify' \ ```json { - "code": 0, - "message": "0", - "ttl": 1 + "code": 0, + "message": "0", + "ttl": 1 } ``` @@ -1335,7 +1588,7 @@ curl 'https://api.bilibili.com/x/relation/modify' \ ### 批量操作用户关系 -> https://api.bilibili.com/x/relation/batch/modify +> *请求方式:POST* @@ -1384,11 +1637,11 @@ curl 'https://api.bilibili.com/x/relation/modify' \ ```shell curl 'https://api.bilibili.com/x/relation/batch/modify' \ - --data-urlencode 'fid=1,2,3,4,5' \ - --data-urlencode 'act=1' \ - --data-urlencode 're_src=11' \ - --data-urlencode 'csrf=xxx' \ - -b 'SESSDATA=xxx' + --data-urlencode 'fid=1,2,3,4,5' \ + --data-urlencode 'act=1' \ + --data-urlencode 're_src=11' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -1396,12 +1649,12 @@ curl 'https://api.bilibili.com/x/relation/batch/modify' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "failed_fids": [] - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "failed_fids": [] + } } ``` @@ -1429,7 +1682,7 @@ curl 'https://api.bilibili.com/x/relation/batch/modify' \ ### 查询用户与自己关系(仅关注) -> https://api.bilibili.com/x/relation +> *请求方式:GET* @@ -1459,8 +1712,8 @@ curl 'https://api.bilibili.com/x/relation/batch/modify' \ ```shell curl -G 'https://api.bilibili.com/x/relation' \ - --data-urlencode 'fid=258150656' \ - -b 'SESSDATA=xxx' + --data-urlencode 'fid=258150656' \ + -b 'SESSDATA=xxx' ```
@@ -1468,16 +1721,16 @@ curl -G 'https://api.bilibili.com/x/relation' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "mid": 258150656, - "attribute": 2, - "mtime": 1540659101, - "tag": [-10], - "special": 1 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 258150656, + "attribute": 2, + "mtime": 1540659101, + "tag": [-10], + "special": 1 + } } ``` @@ -1485,9 +1738,9 @@ curl -G 'https://api.bilibili.com/x/relation' \ ### 查询用户与自己关系(互相关系) -> 接口1:https://api.bilibili.com/x/space/wbi/acc/relation +> 接口1: -> 接口2:https://api.bilibili.com/x/web-interface/relation +> 接口2: *请求方式:GET* @@ -1495,7 +1748,7 @@ curl -G 'https://api.bilibili.com/x/relation' \ 鉴权方式(仅接口1):[Wbi 签名](../misc/sign/wbi.md) -~~该接口的旧版 API :https://api.bilibili.com/x/space/acc/relation~~(已废弃,不建议使用) +~~该接口的旧版 API :~~(已废弃,不建议使用) **url参数:** @@ -1532,10 +1785,10 @@ Wbi 签名的 `wts`、`w_rid`生成方式详见 [Wbi 签名](../misc/sign/wbi.md ```shell curl -G 'https://api.bilibili.com/x/space/acc/relation' \ - --data-urlencode 'mid=15858903' \ - --data-urlencode 'wts=1686015899' \ - --data-urlencode 'w_rid=e10a3c566c9be80a7cebe7bcdf262588' \ - -b 'SESSDATA=xxx' + --data-urlencode 'mid=15858903' \ + --data-urlencode 'wts=1686015899' \ + --data-urlencode 'w_rid=e10a3c566c9be80a7cebe7bcdf262588' \ + -b 'SESSDATA=xxx' ```
@@ -1543,32 +1796,32 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "relation": { - "mid": 15858903, - "attribute": 6, - "mtime": 1548311059, - "tag": [ - -10, - 194110, - 248468 - ], - "special": 1 - }, - "be_relation": { - "mid": 293793435, - "attribute": 6, - "mtime": 1548311059, - "tag": [ - 56502, - -10 - ], - "special": 1 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "relation": { + "mid": 15858903, + "attribute": 6, + "mtime": 1548311059, + "tag": [ + -10, + 194110, + 248468 + ], + "special": 1 + }, + "be_relation": { + "mid": 293793435, + "attribute": 6, + "mtime": 1548311059, + "tag": [ + 56502, + -10 + ], + "special": 1 } + } } ``` @@ -1576,7 +1829,7 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \ ### 批量查询用户与自己关系 -> https://api.bilibili.com/x/relation/relations +> *请求方式:GET* @@ -1584,10 +1837,10 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \ **url参数:** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ------------------- | -| access_key | str | APP 登录 Token | APP 方式必要 | | -| fids | nums | 目标用户 mid | 必要 | 每个之间用`,`间隔 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ----------------------------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| fids | nums | 目标用户 mid | 必要 | 每个之间用`,`间隔,无成员限制 | **json回复:** @@ -1613,8 +1866,8 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \ ```shell curl -G 'https://api.bilibili.com/x/relation/relations' \ ---data-urlencode 'fid=258150656' \ --b 'SESSDATA=xxx' + --data-urlencode 'fid=258150656' \ + -b 'SESSDATA=xxx' ```
@@ -1622,25 +1875,25 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "1": { - "mid": 1, - "attribute": 2, - "mtime": 1601654227, - "tag": null, - "special": 0 - }, - "2": { - "mid": 2, - "attribute": 2, - "mtime": 1601654225, - "tag": null, - "special": 0 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "1": { + "mid": 1, + "attribute": 2, + "mtime": 1601654227, + "tag": null, + "special": 0 + }, + "2": { + "mid": 2, + "attribute": 2, + "mtime": 1601654225, + "tag": null, + "special": 0 } + } } ``` @@ -1657,7 +1910,7 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \ ### 查询关注分组列表 -> https://api.bilibili.com/x/relation/tags +> *请求方式:GET* @@ -1703,44 +1956,44 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \ ```shell curl 'https://api.bilibili.com/x/relation/tags' \ - -b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
查看响应示例: -```json +```jsonc { - "code": 0, - "message": "0", - "ttl": 1, - "data": [ - { - "tagid": -10, - "name": "特别关注", - "count": 19, - "tip": "第一时间收到该分组下用户更新稿件的通知" - }, - { - "tagid": 0, - "name": "默认分组", - "count": 340, - "tip": "" - }, - { - "tagid": 194110, - "name": "基友们", - "count": 127, - "tip": "" - }, - { - "tagid": 194111, - "name": "我的同学", - "count": 22, - "tip": "" - }, - ………… - ] + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + { + "tagid": -10, + "name": "特别关注", + "count": 19, + "tip": "第一时间收到该分组下用户更新稿件的通知" + }, + { + "tagid": 0, + "name": "默认分组", + "count": 340, + "tip": "" + }, + { + "tagid": 194110, + "name": "基友们", + "count": 127, + "tip": "" + }, + { + "tagid": 194111, + "name": "我的同学", + "count": 22, + "tip": "" + }, + // …… + ] } ``` @@ -1748,7 +2001,7 @@ curl 'https://api.bilibili.com/x/relation/tags' \ ### 查询关注分组明细 -> https://api.bilibili.com/x/relation/tag +> *请求方式:GET* @@ -1770,54 +2023,77 @@ curl 'https://api.bilibili.com/x/relation/tags' \ 根对象: -| 字段 | 类型 | 内容 | 备注 | -| ------- | ------ | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误
22104:该分组不存在 | -| message | str | 错误信息 | 默认为 0 | -| ttl | num | 1 | | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误
22104:该分组不存在 | +| message | str | 错误信息 | 默认为 0 | +| ttl | num | 1 | | | data | array | 成员列表 | | `data`数组: -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------- | -------------------------------- | -| 0 | obj | 成员信息 1 | 见 [关系列表对象](#关系列表对象) | -| n | obj | 成员信息(n+1) | 按照添加顺序排序 | -| …… | obj | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | --------------------------------------- | +| 0 | obj | 成员信息 1 | 与[关系列表对象](#关系列表对象)**不同** | +| n | obj | 成员信息(n+1) | 按照添加顺序排序 | +| …… | obj | …… | …… | -`data` 中的对象: +`data` 数组中的对象: -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ---- | ----------- | -------------- | -| mid | num | 用户id | | -| attribute | num | 0 | | -| tag | null | null | | -| special | num | 0 | | -| contract_info | json | 空的 | | -| uname | str | 用户名 | | -| face | str | 头像地址 | | -| sign | str | 个人简介 | | -| face_nft | int | ntf头像 | | -| official_verify | json | 官方认证 | 具体见下 | -| vip | json | 大会员 | 参考大会员文档 | -| live | json | 直播状态 | 具体见下 | -| nft_icon | str | 显示nft角标 | | -| rec_reason | str | | | -| track_id | str | | | +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | --------------- | -------------- | +| mid | num | 用户mid | | +| attribute | num | 关系属性 | 恒为 `0` | +| tag | null | 关注分组id | 恒为 `null` | +| special | num | 是否特别关注 | 恒为 `0` | +| contract_info | obj | 契约计划信息 | | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| face_nft | num | 是否为 NFT 头像 | | +| official_verify | obj | 认证信息 | 具体见下 | +| vip | obj | 会员信息 | | +| live | obj | 直播状态 | 具体见下 | +| nft_icon | str | (?) | | +| rec_reason | str | (?) | | +| track_id | str | (?) | | +| follow_time | str | (?) | | -`data`对象中的`official_verify`: +`data`中的对象中的`official_verify`对象: -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ---- | -| type | num | 0 | | -| desc | str | 官方认证内容 | | +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1:无
0:UP 主认证
1:机构认证 | +| desc | str | 用户认证信息 | 无为空 | -`data`对象中的`live`: +`data`中的对象中的`vip`对象: -| 字段 | 类型 | 内容 | 备注 | -| ----------- | ---- | -------- | -------------------- | -| live_status | num | 0或1 | 0:未开播,1:已直播 | -| jump_url | str | 直播链接 | +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0:无
1:月度大会员
2:年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | (?) | | +| accessStatus | num | (?) | | +| vipStatus | num | 大会员状态 | 0:无
1:有 | +| vipStatusWarn | str | (?) | | +| themeType | num | (?) | | +| label | obj | (?) | | + +`data`数组中的对象中的`live`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | -------- | ------------------------ | +| live_status | num | 直播状态 | 0:未开播
1:已直播 | +| jump_url | str | 直播链接 | | + +`data`数组中的对象中的`contract_info`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------------------------ | ----------------------------------------------------------- | +| is_contract | bool | 目标用户是否为对方的契约者 | 仅当为 `true` 时才有此项 | +| is_contractor | bool | 对方是否为目标用户的契约者 | 仅当为 `true` 时才有此项 | +| ts | num | 对方成为目标用户的契约者的时间 | 秒级时间戳,仅当 `is_contractor` 项的值为 `true` 时才有此项 | +| user_attr | num | 对方作为目标用户的契约者的属性 | 1:老粉
否则为原始粉丝
仅当有特殊属性时才有此项 | **示例:** @@ -1825,11 +2101,11 @@ curl 'https://api.bilibili.com/x/relation/tags' \ ```shell curl -G 'https://api.bilibili.com/x/relation/tag' \ - --data-urlencode 'tagid=207542' \ - --data-urlencode 'order_type=' \ - --data-urlencode 'ps=2' \ - --data-urlencode 'pn=1' \ - -b 'SESSDATA=xxx' + --data-urlencode 'tagid=207542' \ + --data-urlencode 'order_type=' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -1837,60 +2113,60 @@ curl -G 'https://api.bilibili.com/x/relation/tag' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": [{ - "mid": 420831218, - "uname": "支付宝Alipay", - "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", - "sign": "阿支来了,关注点赞转发投币四连走起!", - "official_verify": { - "type": 1, - "desc": "支付宝官方账号" - }, - "vip": { - "vipType": 1, - "vipDueDate": 1585065600000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }, { - "mid": 125086406, - "uname": "MSI微星科技", - "face": "https://i1.hdslb.com/bfs/face/a844760e4e491677615b39399bc761e74c579bb4.jpg", - "sign": "你好,这里是微星显卡官方!专注显卡三十年,欢迎私信咨询或提问MSI", - "official_verify": { - "type": 1, - "desc": "微星科技官方账号" - }, - "vip": { - "vipType": 1, - "vipDueDate": 1540656000000, - "dueRemark": "", - "accessStatus": 0, - "vipStatus": 0, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "" - } - } - }] + "code": 0, + "message": "0", + "ttl": 1, + "data": [{ + "mid": 420831218, + "uname": "支付宝Alipay", + "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", + "sign": "阿支来了,关注点赞转发投币四连走起!", + "official_verify": { + "type": 1, + "desc": "支付宝官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1585065600000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, { + "mid": 125086406, + "uname": "MSI微星科技", + "face": "https://i1.hdslb.com/bfs/face/a844760e4e491677615b39399bc761e74c579bb4.jpg", + "sign": "你好,这里是微星显卡官方!专注显卡三十年,欢迎私信咨询或提问MSI", + "official_verify": { + "type": 1, + "desc": "微星科技官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1540656000000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }] } ```
-### 查询目标用户所在的分组 +### 查询目标用户所在的分组 -> https://api.bilibili.com/x/relation/tag/user +> *请求方式:GET* @@ -1927,8 +2203,8 @@ curl -G 'https://api.bilibili.com/x/relation/tag' \ ```shell curl -G 'https://api.bilibili.com/x/relation/tag/user' \ - --data-urlencode 'fid=319214221' \ - -b 'SESSDATA=xxx' + --data-urlencode 'fid=319214221' \ + -b 'SESSDATA=xxx' ```
@@ -1936,13 +2212,13 @@ curl -G 'https://api.bilibili.com/x/relation/tag/user' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "-10": "特别关注", - "194111": "我的同学" - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "-10": "特别关注", + "194111": "我的同学" + } } ``` @@ -1950,7 +2226,7 @@ curl -G 'https://api.bilibili.com/x/relation/tag/user' \ ### 查询所有特别关注 mid -> https://api.bilibili.com/x/relation/tag/special +> *请求方式:GET* @@ -1985,7 +2261,7 @@ curl -G 'https://api.bilibili.com/x/relation/tag/user' \ ```shell curl 'https://api.bilibili.com/x/relation/tag/special' \ - -b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
@@ -1993,29 +2269,29 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": [ - 500716647, - 32832243, - 53456, - 25944552, - 301839556, - 427494870, - 319214221, - 31949159, - 382666849, - 258318451, - 15858903, - 54992199, - 3379951, - 392279807, - 23215368, - 258150656, - 20165629, - 22179720 - ] + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + 500716647, + 32832243, + 53456, + 25944552, + 301839556, + 427494870, + 319214221, + 31949159, + 382666849, + 258318451, + 15858903, + 54992199, + 3379951, + 392279807, + 23215368, + 258150656, + 20165629, + 22179720 + ] } ``` @@ -2025,7 +2301,7 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \ -> https://api.bilibili.com/x/relation/tag/create +> *请求方式:POST* @@ -2062,9 +2338,9 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \ ```shell curl 'https://api.bilibili.com/x/relation/tag/create' \ - --data-urlencode 'tag=测试' \ - --data-urlencode 'csrf=xxx' \ - -b 'SESSDATA=xxx' + --data-urlencode 'tag=测试' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2072,12 +2348,12 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "tagid": 216677 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "tagid": 216677 + } } ``` @@ -2085,7 +2361,7 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \ ### 重命名分组 -> https://api.bilibili.com/x/relation/tag/update +> *请求方式:POST* @@ -2116,10 +2392,10 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \ ```shell curl 'https://api.bilibili.com/x/relation/tag/update' \ - --data-urlencode 'tagid=194112' \ - --data-urlencode 'name=膜法师' \ - --data-urlencode 'csrf=xxx' \ - -b 'SESSDATA=xxx' + --data-urlencode 'tagid=194112' \ + --data-urlencode 'name=膜法师' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2127,9 +2403,9 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \ ```json { - "code": 0, - "message": "0", - "ttl": 1 + "code": 0, + "message": "0", + "ttl": 1 } ``` @@ -2139,7 +2415,7 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \ -> https://api.bilibili.com/x/relation/tag/del +> *请求方式:POST* @@ -2169,9 +2445,9 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \ ```shell curl 'https://api.bilibili.com/x/relation/tag/del' \ - --data-urlencode 'tagid=216699' \ - --data-urlencode 'csrf=xxx' \ - -b 'SESSDATA=xxx' + --data-urlencode 'tagid=216699' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2179,9 +2455,9 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \ ```json { - "code": 0, - "message": "0", - "ttl": 1 + "code": 0, + "message": "0", + "ttl": 1 } ``` @@ -2191,7 +2467,7 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \ -> https://api.bilibili.com/x/relation/tags/addUsers +> *请求方式:POST* @@ -2224,10 +2500,10 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \ ```shell curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ - --data-urlencode 'fids=205631797' \ - --data-urlencode 'tagids=-10,207542' \ - --data-urlencode 'csrf=xxx' \ - -b 'SESSDATA=xxx' + --data-urlencode 'fids=205631797' \ + --data-urlencode 'tagids=-10,207542' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2235,9 +2511,9 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ ```json { - "code": 0, - "message": "0", - "ttl": 1 + "code": 0, + "message": "0", + "ttl": 1 } ``` @@ -2245,7 +2521,7 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ ### 复制关注到分组 -> https://api.bilibili.com/x/relation/tags/copyUsers +> *请求方式:POST* @@ -2276,10 +2552,10 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ ```shell curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ - --data-urlencode 'fids=4856007,326499679' \ - --data-urlencode 'tagids=231305' \ - --data-urlencode 'csrf=xxx' \ - -b 'SESSDATA=xxx' + --data-urlencode 'fids=4856007,326499679' \ + --data-urlencode 'tagids=231305' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2287,9 +2563,9 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ ```json { - "code":0, - "message":"0", - "ttl":1 + "code": 0, + "message": "0", + "ttl": 1 } ``` @@ -2297,7 +2573,7 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ ### 移动关注到分组 -> https://api.bilibili.com/x/relation/tags/moveUsers +> *请求方式:POST* @@ -2329,11 +2605,11 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ ```shell curl 'https://api.bilibili.com/x/relation/tags/moveUsers' \ - --data-urlencode 'beforeTagids=207542' \ - --data-urlencode 'afterTagids=23130' \ - --data-urlencode 'fids=321173469,327086920' \ - --data-urlencode 'csrf=xxx' \ - -b 'SESSDATA=xxx' + --data-urlencode 'beforeTagids=207542' \ + --data-urlencode 'afterTagids=23130' \ + --data-urlencode 'fids=321173469,327086920' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2341,9 +2617,9 @@ curl 'https://api.bilibili.com/x/relation/tags/moveUsers' \ ```json { - "code":0, - "message":"0", - "ttl":1 + "code": 0, + "message": "0", + "ttl": 1 } ```