bilibili-API-collect/docs/live/user.md

直播间用户实用 API

获取自己持有的粉丝勋章信息

https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal (旧) https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

url 参数：

参数名	类型	内容	必要性	备注
page_size	num	每页的数量	必要	最大为 10，超出 1002002：参数异常
page	num	返回结果页数	必要	两个参数不填返回空，只 page 不填或错误则 500 异常

json 回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -1002002：参数异常 -500：服务器异常
message	str	错误信息	默认为 "0"
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
count	num	勋章数量
items	array	粉丝勋章信息本体
page_info	obj	页码信息

items数组中的对象：

字段	类型	内容	备注
can_delete	bool	可否删除
day_limit	num	日经验上限（原力值）	eg: 1500
guard_level	num
guard_medal_title	str	加成状态
intimacy	num	当前已得亲密度
is_lighted	num	是否点亮	0：未点亮 1：点亮
level	num	勋章等级
medal_name	str	勋章名
medal_color_border	num	勋章边框颜色信息	颜色数值为 10 进制的 16 进制值（下同）
medal_color_start	num	勋章起始颜色	从右往左渐变（20 级+勋章）
medal_color_end	num	勋章结束颜色	从右往左渐变（20 级+勋章）
medal_id	num	粉丝勋章 id
next_intimacy	num	升级所需经验
today_feed	num	本日亲密度
roomid	num	直播间房间号
status	num
target_id	number	up 主 mid
target_name	str	up 主用户名
uname	str	up 主用户名

page_info对象：

字段	类型	内容	备注
total_page	num	页码总长度
cur_page	num	当前返回的页码

示例：

curl https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals?page=1&page_size=10 \
-b "SESSDATA=xxx"

查看响应示例：

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "items": [
      {
        "can_deleted": true,
        "day_limit": 1500,
        "guard_level": 0,
        "guard_medal_title": "未开启加成",
        "intimacy": 9617,
        "is_lighted": 0,
        "level": 11,
        "medal_name": "锦依卫",
        "medal_color_border": 12632256,
        "medal_color_end": 12632256,
        "medal_color_start": 12632256,
        "medal_id": 29245,
        "next_intimacy": 10000,
        "today_feed": 0,
        "roomid": 1546736,
        "status": 0,
        "target_id": 36081646,
        "target_name": "洛天依",
        "uname": "洛天依"
      }
    ],
    "page_info": {
      "cur_page": 1,
      "total_page": 1
    },
    "count": 1
  }
}

佩戴勋章

https://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear

请求方式：POST

表单参数：

参数名	类型	内容	必要性	备注
medal_id	num	勋章 id	必要
csrf	num	cookie 中 bili_jct 字段	必要
csrf_token	num	同上	必要

json 回复：

根对象：

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

示例：

佩戴勋章 id 为 1 的勋章

var madelForm = new FormData();
madelForm.append("medal_id", 1);
madelForm.append("csrf", bili_jct);
madelForm.append("csrf_token", bili_jct);
$.ajax({
    url: "https://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear",
    type: "POST",
    data: madelForm,
    dataType: "JSON",
    processData: false,
    contentType: false,
    cache: false,
    xhrFields: {
        withCredentials: true
    },
    success: function (){

    }
})

查看响应示例：

{
  "code": 0,
  "message": "佩戴成功",
  "ttl": 1,
  "data": {}
}

直播签到（已下线）

https://api.live.bilibili.com/xlive/web-ucenter/v1/sign/DoSign

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

json 回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 1：参数错误
ttl	num	1
message	str	错误信息	默认为当日签到奖励内容
data	obj	信息本体	默认为空

（目前已下线）

查看响应示例（下线后）：

{
    "code": 1,
    "message": "签到活动已下线，无法使用。",
    "ttl": 1,
    "data": null
}

本月直播签到信息

https://api.live.bilibili.com/xlive/web-ucenter/v1/sign/WebGetSignInfo

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

json 回复：

根对象：

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

data对象：

字段	类型	内容	备注
text	str	今日签到奖励信息	默认为空
specialText	str	连续签到奖励信息	默认为空
status	num	签到状态	0：未签到 1：已签到
allDays	num	当月天数
curMonth	num	当前月
curYear	num	当前年
curDay	num	当前日
curData	str	当前日期（格式化）	eg: 2023-2-19
hadSignDays	num	当月已签到天数	默认为0
newTask	num	作用未知	默认为0
signDaysList	array	当月已签到日列表	默认为空
signBonusDaysList	array	当月已签到且有特殊奖励日列表	默认为空

查看响应示例：

{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "text": "3000点用户经验,2根辣条",
        "specialText": "再签到7天可以获得50根辣条",
        "status": 1,
        "allDays": 28,
        "curMonth": 2,
        "curYear": 2023,
        "curDay": 19,
        "curDate": "2023-2-19",
        "hadSignDays": 13,
        "newTask": 0,
        "signDaysList": [
            2,
            3,
            4,
            5,
            6,
            7,
            11,
            13,
            14,
            15,
            17,
            18,
            19
        ],
        "signBonusDaysList": [
            6
        ]
    }
}

上月直播签到信息

https://api.live.bilibili.com/sign/getLastMonthSignDays

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

json 回复：

根对象：

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

data对象：

字段	类型	内容	备注
days	num	上月天数
month	num	上月月份值
hadSignDays	num	上月已签到天数	默认为0
signDaysList	array	上月已签到日列表	默认为空
signBonusDaysList	array	上月已签到且有特殊奖励日列表	默认为空

查看响应示例：

{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "month": 1,
        "days": 31,
        "hadSignDays": 20,
        "signDaysList": [
            1,
            2,
            3,
            6,
            7,
            8,
            10,
            12,
            13,
            14,
            15,
            18,
            20,
            23,
            24,
            25,
            26,
            27,
            30,
            31
        ],
        "signBonusDaysList": [
            7,
            31
        ]
    }
}

查询直播间贡献榜

https://api.live.bilibili.com//xlive/general-interface/v1/rank/getOnlineGoldRank

请求方式：GET

认证方式：无

url 参数：

参数名	类型	内容	必要性	备注
roomId	num	房间号	必要
page	num	返回结果页数	必要
pageSize	num	返回结果页大小	必要	最大50
ruid	num	主播uid	必要

json 回复：

根对象：

字段	类型	内容	备注
code	num	返回值
message	str	错误信息
ttl	num	1
data	obj	信息本体

data中的对象：

字段	类型	内容	备注
onlineNum	num	在线观众数量
OnlineRankItem	array	结果

OnlineRankItem数组中的对象：

字段	类型	内容	备注
userRank	num	贡献值排名
uid	num	用户id
name	str	用户名字
face	str	用户头像
score	num	贡献值
medalInfo	obj	粉丝牌对象
guard_level	num	大航海类型
wealth_level	num	荣耀等级
guard_level	num	大航海类型
uinfo	obj	用户详细信息

uinfo对象：

字段	类型	内容	备注
uid	num	用户uid
base	obj	用户基本信息
medal	obj	用户粉丝牌
face	str	用户头像
guard	obj	大航海

guard对象：

字段	类型	内容	备注
level	num	大航海类型
expired_str	str	大航海到期时间

示例：

查询23174842直播间的大航海成员

curl  'https://api.live.bilibili.com//xlive/general-interface/v1/rank/getOnlineGoldRank?roomId=26854650&ruid=3493118494116797&page=3&pageSize=20'

查看响应示例：

{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "onlineNum": 45,
        "OnlineRankItem": [
            {
                "userRank": 1,
                "uid": 36136895,
                "name": "四月hallu",
                "face": "https://i2.hdslb.com/bfs/face/5e5166ecc4c17d4dbc7a09dbb6bb749d9f537985.jpg",
                "score": 3768,
                "medalInfo": {
                    "guardLevel": 3,
                    "medalColorStart": 2951253,
                    "medalColorEnd": 10329087,
                    "medalColorBorder": 6809855,
                    "medalName": "钢板鹿",
                    "level": 29,
                    "targetId": 3493118494116797,
                    "isLight": 1
                },
                "guard_level": 3,
                "wealth_level": 41,
                "is_mystery": false,
                "uinfo": {
                    "uid": 36136895,
                    "base": {
                        "name": "四月hallu",
                        "face": "https://i2.hdslb.com/bfs/face/5e5166ecc4c17d4dbc7a09dbb6bb749d9f537985.jpg",
                        "name_color": 0,
                        "is_mystery": false,
                        "risk_ctrl_info": {
                            "name": "四月hallu",
                            "face": "https://i2.hdslb.com/bfs/face/5e5166ecc4c17d4dbc7a09dbb6bb749d9f537985.jpg"
                        },
                        "origin_info": {
                            "name": "四月hallu",
                            "face": "https://i2.hdslb.com/bfs/face/5e5166ecc4c17d4dbc7a09dbb6bb749d9f537985.jpg"
                        },
                        "official_info": {
                            "role": 0,
                            "title": "",
                            "desc": "",
                            "type": -1
                        },
                        "name_color_str": ""
                    },
                    "medal": {
                        "name": "钢板鹿",
                        "level": 29,
                        "color_start": 2951253,
                        "color_end": 10329087,
                        "color_border": 6809855,
                        "color": 2951253,
                        "id": 0,
                        "typ": 0,
                        "is_light": 1,
                        "ruid": 3493118494116797,
                        "guard_level": 3,
                        "score": 50422604,
                        "guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
                        "honor_icon": "",
                        "v2_medal_color_start": "#9660E5CC",
                        "v2_medal_color_end": "#9660E5CC",
                        "v2_medal_color_border": "#D47AFFFF",
                        "v2_medal_color_text": "#FFFFFFFF",
                        "v2_medal_color_level": "#6C00A099",
                        "user_receive_count": 0
                    },
                    "wealth": {
                        "level": 41,
                        "dm_icon_key": "ChronosWealth_4.png"
                    },
                    "title": null,
                    "guard": {
                        "level": 3,
                        "expired_str": "2025-07-07 23:59:59"
                    },
                    "uhead_frame": null,
                    "guard_leader": null
                }
            },
            {
                "userRank": 2,
                "uid": 1182882611,
                "name": "重生指令",
                "face": "https://i2.hdslb.com/bfs/face/6762c39b424e6de5bf0292fd12a019201a501fb9.jpg",
                "score": 1546,
                "medalInfo": {
                    "guardLevel": 0,
                    "medalColorStart": 12632256,
                    "medalColorEnd": 12632256,
                    "medalColorBorder": 12632256,
                    "medalName": "雪狐咕",
                    "level": 24,
                    "targetId": 477792,
                    "isLight": 0
                },
                "guard_level": 3,
                "wealth_level": 22,
                "is_mystery": false,
                "uinfo": {
                    "uid": 1182882611,
                    "base": {
                        "name": "重生指令",
                        "face": "https://i2.hdslb.com/bfs/face/6762c39b424e6de5bf0292fd12a019201a501fb9.jpg",
                        "name_color": 0,
                        "is_mystery": false,
                        "risk_ctrl_info": {
                            "name": "重生指令",
                            "face": "https://i2.hdslb.com/bfs/face/6762c39b424e6de5bf0292fd12a019201a501fb9.jpg"
                        },
                        "origin_info": {
                            "name": "重生指令",
                            "face": "https://i2.hdslb.com/bfs/face/6762c39b424e6de5bf0292fd12a019201a501fb9.jpg"
                        },
                        "official_info": {
                            "role": 0,
                            "title": "",
                            "desc": "",
                            "type": -1
                        },
                        "name_color_str": ""
                    },
                    "medal": {
                        "name": "雪狐咕",
                        "level": 24,
                        "color_start": 12632256,
                        "color_end": 12632256,
                        "color_border": 12632256,
                        "color": 1725515,
                        "id": 0,
                        "typ": 0,
                        "is_light": 0,
                        "ruid": 477792,
                        "guard_level": 0,
                        "score": 50010220,
                        "guard_icon": "",
                        "honor_icon": "",
                        "v2_medal_color_start": "#919298CC",
                        "v2_medal_color_end": "#919298CC",
                        "v2_medal_color_border": "#919298CC",
                        "v2_medal_color_text": "#FFFFFFFF",
                        "v2_medal_color_level": "#6C6C7299",
                        "user_receive_count": 0
                    },
                    "wealth": {
                        "level": 22,
                        "dm_icon_key": ""
                    },
                    "title": null,
                    "guard": {
                        "level": 3,
                        "expired_str": "2025-06-29 23:59:59"
                    },
                    "uhead_frame": null,
                    "guard_leader": null
                }
            },
            {
                "userRank": 3,
                "uid": 35007043,
                "name": "_单推哈鹿halluの狐狸",
                "face": "https://i1.hdslb.com/bfs/face/6373a98189480661fc725494ab5ab68253522b8f.jpg",
                "score": 1543,
                "medalInfo": {
                    "guardLevel": 2,
                    "medalColorStart": 2951253,
                    "medalColorEnd": 10329087,
                    "medalColorBorder": 16771156,
                    "medalName": "钢板鹿",
                    "level": 29,
                    "targetId": 3493118494116797,
                    "isLight": 1
                },
                "guard_level": 2,
                "wealth_level": 40,
                "is_mystery": false,
                "uinfo": {
                    "uid": 35007043,
                    "base": {
                        "name": "_单推哈鹿halluの狐狸",
                        "face": "https://i1.hdslb.com/bfs/face/6373a98189480661fc725494ab5ab68253522b8f.jpg",
                        "name_color": 0,
                        "is_mystery": false,
                        "risk_ctrl_info": {
                            "name": "_单推哈鹿halluの狐狸",
                            "face": "https://i1.hdslb.com/bfs/face/6373a98189480661fc725494ab5ab68253522b8f.jpg"
                        },
                        "origin_info": {
                            "name": "_单推哈鹿halluの狐狸",
                            "face": "https://i1.hdslb.com/bfs/face/6373a98189480661fc725494ab5ab68253522b8f.jpg"
                        },
                        "official_info": {
                            "role": 0,
                            "title": "",
                            "desc": "",
                            "type": -1
                        },
                        "name_color_str": ""
                    },
                    "medal": {
                        "name": "钢板鹿",
                        "level": 29,
                        "color_start": 2951253,
                        "color_end": 10329087,
                        "color_border": 16771156,
                        "color": 2951253,
                        "id": 0,
                        "typ": 0,
                        "is_light": 1,
                        "ruid": 3493118494116797,
                        "guard_level": 2,
                        "score": 50360413,
                        "guard_icon": "https://i0.hdslb.com/bfs/live/98a201c14a64e860a758f089144dcf3f42e7038c.png",
                        "honor_icon": "",
                        "v2_medal_color_start": "#9660E5CC",
                        "v2_medal_color_end": "#9660E5CC",
                        "v2_medal_color_border": "#D47AFFFF",
                        "v2_medal_color_text": "#FFFFFFFF",
                        "v2_medal_color_level": "#6C00A099",
                        "user_receive_count": 0
                    },
                    "wealth": {
                        "level": 40,
                        "dm_icon_key": "ChronosWealth_4.png"
                    },
                    "title": null,
                    "guard": {
                        "level": 2,
                        "expired_str": "2025-07-30 23:59:59"
                    },
                    "uhead_frame": null,
                    "guard_leader": null
                }
            },
            {
                "userRank": 7,
                "uid": 44152084,
                "name": "_柚_子_hallu",
                "face": "https://i1.hdslb.com/bfs/face/137498c2c6a3231e5b6047af12a64bbd19627dcb.jpg",
                "score": 324,
                "medalInfo": {
                    "guardLevel": 3,
                    "medalColorStart": 398668,
                    "medalColorEnd": 6850801,
                    "medalColorBorder": 6809855,
                    "medalName": "钢板鹿",
                    "level": 26,
                    "targetId": 3493118494116797,
                    "isLight": 1
                },
                "guard_level": 3,
                "wealth_level": 32,
                "is_mystery": false,
                "uinfo": {
                    "uid": 44152084,
                    "base": {
                        "name": "_柚_子_hallu",
                        "face": "https://i1.hdslb.com/bfs/face/137498c2c6a3231e5b6047af12a64bbd19627dcb.jpg",
                        "name_color": 0,
                        "is_mystery": false,
                        "risk_ctrl_info": {
                            "name": "_柚_子_hallu",
                            "face": "https://i1.hdslb.com/bfs/face/137498c2c6a3231e5b6047af12a64bbd19627dcb.jpg"
                        },
                        "origin_info": {
                            "name": "_柚_子_hallu",
                            "face": "https://i1.hdslb.com/bfs/face/137498c2c6a3231e5b6047af12a64bbd19627dcb.jpg"
                        },
                        "official_info": {
                            "role": 0,
                            "title": "",
                            "desc": "",
                            "type": -1
                        },
                        "name_color_str": ""
                    },
                    "medal": {
                        "name": "钢板鹿",
                        "level": 26,
                        "color_start": 398668,
                        "color_end": 6850801,
                        "color_border": 6809855,
                        "color": 398668,
                        "id": 0,
                        "typ": 0,
                        "is_light": 1,
                        "ruid": 3493118494116797,
                        "guard_level": 3,
                        "score": 50057285,
                        "guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
                        "honor_icon": "",
                        "v2_medal_color_start": "#4775EFCC",
                        "v2_medal_color_end": "#4775EFCC",
                        "v2_medal_color_border": "#58A1F8FF",
                        "v2_medal_color_text": "#FFFFFFFF",
                        "v2_medal_color_level": "#000B7099",
                        "user_receive_count": 0
                    },
                    "wealth": {
                        "level": 32,
                        "dm_icon_key": ""
                    },
                    "title": null,
                    "guard": {
                        "level": 3,
                        "expired_str": "2025-06-27 23:59:59"
                    },
                    "uhead_frame": null,
                    "guard_leader": null
                }
            },
            {
                "userRank": 8,
                "uid": 8242366,
                "name": "翟赧hallu",
                "face": "https://i1.hdslb.com/bfs/face/9b312f4146ca2c8a1d2e5468e345ecfb60be3874.jpg",
                "score": 276,
                "medalInfo": {
                    "guardLevel": 3,
                    "medalColorStart": 398668,
                    "medalColorEnd": 6850801,
                    "medalColorBorder": 6809855,
                    "medalName": "钢板鹿",
                    "level": 28,
                    "targetId": 3493118494116797,
                    "isLight": 1
                },
                "guard_level": 3,
                "wealth_level": 35,
                "is_mystery": false,
                "uinfo": {
                    "uid": 8242366,
                    "base": {
                        "name": "翟赧hallu",
                        "face": "https://i1.hdslb.com/bfs/face/9b312f4146ca2c8a1d2e5468e345ecfb60be3874.jpg",
                        "name_color": 0,
                        "is_mystery": false,
                        "risk_ctrl_info": {
                            "name": "翟赧hallu",
                            "face": "https://i1.hdslb.com/bfs/face/9b312f4146ca2c8a1d2e5468e345ecfb60be3874.jpg"
                        },
                        "origin_info": {
                            "name": "翟赧hallu",
                            "face": "https://i1.hdslb.com/bfs/face/9b312f4146ca2c8a1d2e5468e345ecfb60be3874.jpg"
                        },
                        "official_info": {
                            "role": 0,
                            "title": "",
                            "desc": "",
                            "type": -1
                        },
                        "name_color_str": ""
                    },
                    "medal": {
                        "name": "钢板鹿",
                        "level": 28,
                        "color_start": 398668,
                        "color_end": 6850801,
                        "color_border": 6809855,
                        "color": 398668,
                        "id": 0,
                        "typ": 0,
                        "is_light": 1,
                        "ruid": 3493118494116797,
                        "guard_level": 3,
                        "score": 50208414,
                        "guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
                        "honor_icon": "",
                        "v2_medal_color_start": "#4775EFCC",
                        "v2_medal_color_end": "#4775EFCC",
                        "v2_medal_color_border": "#58A1F8FF",
                        "v2_medal_color_text": "#FFFFFFFF",
                        "v2_medal_color_level": "#000B7099",
                        "user_receive_count": 0
                    },
                    "wealth": {
                        "level": 35,
                        "dm_icon_key": ""
                    },
                    "title": null,
                    "guard": {
                        "level": 3,
                        "expired_str": "2025-08-05 23:59:59"
                    },
                    "uhead_frame": null,
                    "guard_leader": null
                }
            },
            {
                "userRank": 9,
                "uid": 418232,
                "name": "lug7",
                "face": "http://i2.hdslb.com/bfs/face/5d2c92beb774a4bb30762538bb102d23670ae9c0.gif",
                "score": 171,
                "medalInfo": {
                    "guardLevel": 3,
                    "medalColorStart": 398668,
                    "medalColorEnd": 6850801,
                    "medalColorBorder": 6809855,
                    "medalName": "钢板鹿",
                    "level": 26,
                    "targetId": 3493118494116797,
                    "isLight": 1
                },
                "guard_level": 3,
                "wealth_level": 28,
                "is_mystery": false,
                "uinfo": {
                    "uid": 418232,
                    "base": {
                        "name": "lug7",
                        "face": "http://i2.hdslb.com/bfs/face/5d2c92beb774a4bb30762538bb102d23670ae9c0.gif",
                        "name_color": 0,
                        "is_mystery": false,
                        "risk_ctrl_info": {
                            "name": "lug7",
                            "face": "http://i2.hdslb.com/bfs/face/5d2c92beb774a4bb30762538bb102d23670ae9c0.gif"
                        },
                        "origin_info": {
                            "name": "lug7",
                            "face": "http://i2.hdslb.com/bfs/face/5d2c92beb774a4bb30762538bb102d23670ae9c0.gif"
                        },
                        "official_info": {
                            "role": 0,
                            "title": "",
                            "desc": "",
                            "type": -1
                        },
                        "name_color_str": ""
                    },
                    "medal": {
                        "name": "钢板鹿",
                        "level": 26,
                        "color_start": 398668,
                        "color_end": 6850801,
                        "color_border": 6809855,
                        "color": 398668,
                        "id": 0,
                        "typ": 0,
                        "is_light": 1,
                        "ruid": 3493118494116797,
                        "guard_level": 3,
                        "score": 50050050,
                        "guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
                        "honor_icon": "",
                        "v2_medal_color_start": "#4775EFCC",
                        "v2_medal_color_end": "#4775EFCC",
                        "v2_medal_color_border": "#58A1F8FF",
                        "v2_medal_color_text": "#FFFFFFFF",
                        "v2_medal_color_level": "#000B7099",
                        "user_receive_count": 0
                    },
                    "wealth": {
                        "level": 28,
                        "dm_icon_key": ""
                    },
                    "title": null,
                    "guard": {
                        "level": 3,
                        "expired_str": "2025-06-15 23:59:59"
                    },
                    "uhead_frame": null,
                    "guard_leader": null
                }
            },
            {
                "userRank": 10,
                "uid": 452228643,
                "name": "很糊的小龔鬱hallu",
                "face": "https://i0.hdslb.com/bfs/face/996fa85fe42d582dd013dcb435de3f3ff4d33f6c.jpg",
                "score": 35,
                "medalInfo": {
                    "guardLevel": 0,
                    "medalColorStart": 6126494,
                    "medalColorEnd": 6126494,
                    "medalColorBorder": 6126494,
                    "medalName": "牧斯",
                    "level": 6,
                    "targetId": 3493087074585126,
                    "isLight": 1
                },
                "guard_level": 3,
                "wealth_level": 35,
                "is_mystery": false,
                "uinfo": {
                    "uid": 452228643,
                    "base": {
                        "name": "很糊的小龔鬱hallu",
                        "face": "https://i0.hdslb.com/bfs/face/996fa85fe42d582dd013dcb435de3f3ff4d33f6c.jpg",
                        "name_color": 0,
                        "is_mystery": false,
                        "risk_ctrl_info": {
                            "name": "很糊的小龔鬱hallu",
                            "face": "https://i0.hdslb.com/bfs/face/996fa85fe42d582dd013dcb435de3f3ff4d33f6c.jpg"
                        },
                        "origin_info": {
                            "name": "很糊的小龔鬱hallu",
                            "face": "https://i0.hdslb.com/bfs/face/996fa85fe42d582dd013dcb435de3f3ff4d33f6c.jpg"
                        },
                        "official_info": {
                            "role": 0,
                            "title": "",
                            "desc": "",
                            "type": -1
                        },
                        "name_color_str": ""
                    },
                    "medal": {
                        "name": "牧斯",
                        "level": 6,
                        "color_start": 6126494,
                        "color_end": 6126494,
                        "color_border": 6126494,
                        "color": 6126494,
                        "id": 0,
                        "typ": 0,
                        "is_light": 1,
                        "ruid": 3493087074585126,
                        "guard_level": 0,
                        "score": 3400,
                        "guard_icon": "",
                        "honor_icon": "",
                        "v2_medal_color_start": "#5866C799",
                        "v2_medal_color_end": "#5866C799",
                        "v2_medal_color_border": "#5866C799",
                        "v2_medal_color_text": "#FFFFFFFF",
                        "v2_medal_color_level": "#000B7099",
                        "user_receive_count": 0
                    },
                    "wealth": {
                        "level": 35,
                        "dm_icon_key": ""
                    },
                    "title": null,
                    "guard": {
                        "level": 3,
                        "expired_str": "2025-06-19 23:59:59"
                    },
                    "uhead_frame": null,
                    "guard_leader": null
                }
            },
            {
                "userRank": 11,
                "uid": 164871173,
                "name": "奶浴-bllss",
                "face": "https://i2.hdslb.com/bfs/face/f48dd7c1e432eb91e5fd286757c4e2600930f4c5.jpg",
                "score": 26,
                "medalInfo": null,
                "guard_level": 3,
                "wealth_level": 36,
                "is_mystery": false,
                "uinfo": {
                    "uid": 164871173,
                    "base": {
                        "name": "奶浴-bllss",
                        "face": "https://i2.hdslb.com/bfs/face/f48dd7c1e432eb91e5fd286757c4e2600930f4c5.jpg",
                        "name_color": 0,
                        "is_mystery": false,
                        "risk_ctrl_info": {
                            "name": "奶浴-bllss",
                            "face": "https://i2.hdslb.com/bfs/face/f48dd7c1e432eb91e5fd286757c4e2600930f4c5.jpg"
                        },
                        "origin_info": {
                            "name": "奶浴-bllss",
                            "face": "https://i2.hdslb.com/bfs/face/f48dd7c1e432eb91e5fd286757c4e2600930f4c5.jpg"
                        },
                        "official_info": {
                            "role": 0,
                            "title": "",
                            "desc": "",
                            "type": -1
                        },
                        "name_color_str": ""
                    },
                    "medal": null,
                    "wealth": {
                        "level": 36,
                        "dm_icon_key": ""
                    },
                    "title": null,
                    "guard": {
                        "level": 3,
                        "expired_str": "2025-07-20 23:59:59"
                    },
                    "uhead_frame": null,
                    "guard_leader": null
                }
            },
        ],
        "ownInfo": {
            "uid": 0,
            "name": "",
            "face": "",
            "rank": -1,
            "needScore": 0,
            "score": 0,
            "guard_level": 0,
            "wealth_level": 0,
            "is_mystery": false,
            "uinfo": null
        },
        "tips_text": "投喂、点赞、发弹幕、持续观看均可上榜",
        "value_text": "贡献值",
        "ab": {
            "guard_accompany_list": 1
        },
        "onlineNumText": "45"
    }
}

查询自己在某直播间观看时长

https://api.live.bilibili.com/xlive/general-interface/v1/guard/GuardActive

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

url 参数：

参数名	类型	内容	必要性	备注
platform	str	android	必要
ruid	num	主播uid	必要

json 回复：

根对象：

字段	类型	内容	备注
code	num	返回值
message	str	错误信息
ttl	num	1
data	obj	信息本体

data中的对象：

字段	类型	内容	备注
ruid	num	主播uid
rusername	str	主播用户名
rface	str	主播头像
username	str	自己的用户名
accomany	int	大航海陪伴天数	似乎b站程序员把这个单词拼错了
rusername	str	主播用户名
watch_time	num	观看时长	单位是秒
up_medal	obj	粉丝牌
guard_num_3	num	主播舰长数量
guard_num_2	num	主播提督数量
guard_num_1	num	主播总督数量
is_live	num	直播状态

查询用户在直播间的信息

https://api.live.bilibili.com/xlive/app-ucenter/v2/card/user

请求方式：GET

认证方式：无

url 参数：

参数名	类型	内容	必要性	备注
uid	num	目标用户uid	必要
ruid	num	主播uid	必要

json 回复：

根对象：

字段	类型	内容	备注
code	num	返回值
message	str	错误信息
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
uid	num	目标用户id
uname	str	目标用户名
desc	str	目标用户认证信息
face	str	目标用户头像
follow_num	num	目标用户粉丝数
attention_num	num	目标用户关注数
main_vip	num	目标用户大会员状态	0：无 2：大会员
is_block	num	是否被拉黑？	始终为0？
is_admin	num	是否房管
is_black	num	是否被关小黑屋
wealth_info	obj	荣耀等级
fans_medal	obj	粉丝牌	如果目标用户隐藏粉丝牌则为null

wealth_info对象：

字段	类型	内容	备注
level	num	荣耀等级
level_total_score	num	下一等级的荣耀值
cur_score	num	当前荣耀值
upgrade_need_score	num	升到下一等级还差多少荣耀值

示例：

curl  'https://api.live.bilibili.com/xlive/app-ucenter/v2/card/user?ruid=504140200&uid=504140200'

查看响应示例：

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"uid": 504140200,
		"uname": "软软riu",
		"face": "https://i1.hdslb.com/bfs/face/2d083d686b704eb7010e3d94595d47f5a89c8aef.jpg",
		"verify_type": 0,
		"desc": "bilibili UP主认证：bilibili 知名虚拟UP主、直播高能主播",
		"uname_color": 2171169,
		"room_id": 23174842,
		"pendant": "https://i1.hdslb.com/bfs/garb/open/8806f97581082d68edcf2207368290b3fb3491bb.png",
		"pendant_from": 2,
		"follow_num": 214882,
		"attention_num": 202,
		"relation_status": 1,
		"privilege_type": 3,
		"fans_medal": null,
		"title_sum": 10,
		"wearing_title": "",
		"main_vip": 0,
		"is_block": 0,
		"is_admin": 0,
		"fans_medal_list_url": "https://live.bilibili.com/p/html/live-fansmedal-wall/index.html?tId=504140200#/medal",
		"wearing": {},
		"is_black": 0,
		"admin_level": 0,
		"head_picture": "http://i0.hdslb.com/bfs/live/3f536f59e337a731c5367f623bca79b32197ddd5.png",
		"head_text": "大航海舰长",
		"head_url": "",
		"head_business": 1,
		"head_skin_icon": "http://i0.hdslb.com/bfs/live/d44e103f424f5ae01ef3d0133ef812f8241d15b0.png",
		"privilege_center": {},
		"is_nft": 0,
		"nft_dmark": "https://i0.hdslb.com/bfs/live/9f176ff49d28c50e9c53ec1c3297bd1ee539b3d6.gif",
		"is_real_fans": false,
		"wealth_info": {
			"uid": 504140200,
			"level": 35,
			"level_total_score": 6000000,
			"cur_score": 5012900,
			"upgrade_need_score": 987100,
			"status": 1,
			"dm_icon_key": ""
		},
		"guard": {
			"accompany": 0,
			"accompany_slake": 0
		},
		"chat_url_android": "activity://im/conversation/?conversation_type=1&reciveid=504140200",
		"chat_url_ios": "bilibili://link/chat?session_id=s504140200",
		"gift_star": null,
		"is_mystery": false,
		"text_control": null,
		"uinfo_medal": null,
		"guard_attire": {},
		"flash_buy": 0,
		"flash_buy_url": ""
	}
}