用户粉丝

开发中

GET

https://api.bilibili.com/x/relation/fans

最后修改时间：2026-01-30 16:48:25

本接口只有登录、标头 referer 为 bilibili.com 下的子域名、UA 不含 python 时才会返回列表

当请求参数 from=main 且目标用户为自己时，返回列表按照智能推荐算法排序，仅返回前 1000 名粉丝，且返回的列表中不含 mtime 字段

否则，返回列表按关注时间排序，此时当前用户仅返回前 1000 名粉丝，其他用户仅返回前 100 名粉丝，若继续往后查询则返回空列表

请求参数

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.bilibili.com/x/relation/fans?vmid=2&ps&pn&offset&last_access_ts&from=main'

响应示例

{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "list": [
            {
                "mid": 631536855,
                "attribute": 0,
                "tag": null,
                "special": 0,
                "contract_info": {},
                "uname": "直到凌晨也无法安眠",
                "face": "https://i0.hdslb.com/bfs/face/b63de8559b4ee61ce6868cd258895c4170c1ccb8.jpg",
                "sign": "\n一般路过作编\nq群875413415 qq2678182776\n音乐wyy独家 ID:直到凌晨也无法安眠。\n标注作者的情况下允许二创",
                "face_nft": 0,
                "handle": "",
                "official_verify": {
                    "type": -1,
                    "desc": ""
                },
                "vip": {
                    "vipType": 2,
                    "vipDueDate": 1780675200000,
                    "dueRemark": "",
                    "accessStatus": 0,
                    "vipStatus": 1,
                    "vipStatusWarn": "",
                    "themeType": 0,
                    "label": {
                        "path": "http://i0.hdslb.com/bfs/vip/label_annual.png",
                        "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": ""
                },
                "name_render": {},
                "nft_icon": "",
                "rec_reason": "2.6万粉丝 15视频",
                "track_id": "up_rec_0.router-main-2479592-9fxdm.1769791590341.681",
                "follow_time": ""
            },
            {
                "mid": 15217592,
                "attribute": 0,
                "tag": null,
                "special": 0,
                "contract_info": {},
                "uname": "雷电红叶",
                "face": "https://i2.hdslb.com/bfs/face/bb1c7c78f086726ab961947d148b5fec7485dce7.jpg",
                "sign": "如梦如幻，亦去留心",
                "face_nft": 0,
                "handle": "",
                "official_verify": {
                    "type": -1,
                    "desc": ""
                },
                "vip": {
                    "vipType": 2,
                    "vipDueDate": 1778169600000,
                    "dueRemark": "",
                    "accessStatus": 0,
                    "vipStatus": 1,
                    "vipStatusWarn": "",
                    "themeType": 0,
                    "label": {
                        "path": "http://i0.hdslb.com/bfs/vip/label_annual.png",
                        "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": ""
                },
                "name_render": {},
                "nft_icon": "",
                "rec_reason": "1.6万粉丝 21视频",
                "track_id": "up_rec_0.router-main-2479592-9fxdm.1769791590341.681",
                "follow_time": ""
            },
            {
                "mid": 519430390,
                "attribute": 0,
                "tag": null,
                "special": 0,
                "contract_info": {},
                "uname": "APEX_银澜",
                "face": "https://i1.hdslb.com/bfs/face/d1f4a1f8f75dfb6a9827e6c7c41a16edf154848b.jpg",
                "sign": "UID:519430390",
                "face_nft": 0,
                "handle": "",
                "official_verify": {
                    "type": -1,
                    "desc": ""
                },
                "vip": {
                    "vipType": 1,
                    "vipDueDate": 1739894400000,
                    "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": "794粉丝 37视频",
                "track_id": "up_rec_0.router-main-2479592-9fxdm.1769791590341.681",
                "follow_time": ""
            },
            {

修改于 2026-01-30 16:48:25

移动关注到分组

用户粉丝 (旧)