BAC Document

包月充电

常量说明

充电档位代码（privilege_type）与定价

代码定价（单位：元人民币）
106
2030
3050
4088
50128
60288
70588
80998
10018
110238
13068

获取包月充电列表

https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecordopen in new window

请求方式：GET

认证方式：Cookie(SESSDATA)或APP

url参数：

参数名类型内容必要性备注
pagenum页码必要
typenum充电状态必要1：使用中
2：已过期

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-101：账号未登录
-400：请求错误
25100004：参数错误
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象：

字段类型内容备注
list有内容时：array
无内容时：null		包月充电UP主列表最多10个
pagenum当前页数
page_sizenum当前分页大小一般为10
total_pagenum总页数
total_numnum用户总数
is_morenum是否有更多用户0：否
1：是

data中的list数组：

项类型内容备注
0obj用户1
nobj用户(n+1)
……obj…………

数组list中的对象：

字段类型内容备注
up_uidnum充电UP主mid
user_namestr充电UP主昵称
user_facestr充电UP主头像url
itemarray充电详情
startnum开始充电时间秒级时间戳
high_level_statenum是否可对UP主进行高档充电
elec_reply_statenum是否可对UP主进行专属问答0：否
1：是
2：状态未知

数组list中的对象中的item数组：

项类型内容备注
0obj充电档位1
nobj充电档位(n+1)
……obj…………

数组item中的对象：

字段类型内容备注
privilege_typenum充电档位代码详见充电档位代码与定价
iconstr充电图标
namestr充电档位名称
expire_timenum该档位过期时间秒级时间戳
renew开启自动续费时：obj
关闭自动续费时：null		充电自动续费详情
start_timenum该档位生效时间秒级时间戳
renew_list开启自动续费时：array
关闭自动续费时：null		充电自动续费列表

renew对象、renew_list数组中的对象：

字段类型内容备注
uidnum自己的mid
ruidnumUP主的mid
goods_idnum充电类型172：一个月
173：连续包月
174：连续包年
statusnum充电状态1
next_execute_timenum下次续费时间秒级时间戳
signed_timenum签约时间秒级时间戳
signed_pricenum下次续费金额单位为千分之一元人民币
pay_channelnum签约平台2：微信支付
4：支付宝
periodnum下次充电天数
mobile_appstr充电渠道可为android等

示例：

获取自己正在使用的包月充电的列表

curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
  --data-urlencode 'page=1' \
  --data-urlencode 'type=1' \
  -b 'SESSDATA=xxx'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "list": [
      {
        "up_uid": 2233,
        "user_name": "2233",
        "user_face": "https://i0.hdslb.com/bfs/face/noface.jpg",
        "item": [
          {
            "privilege_type": 10,
            "icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png",
            "name": "为TA充电",
            "expire_time": 1703519999,
            "renew": {
              "uid": 425503913,
              "ruid": 2233,
              "goods_id": 174,
              "status": 1,
              "next_execute_time": 1703174400,
              "signed_time": 1671618921,
              "signed_price": 36000,
              "pay_channel": 2,
              "period": 366,
              "mobile_app": "android"
            },
            "start_time": 1671618921,
            "renew_list": [
              {
                "uid": 425503913,
                "ruid": 2233,
                "goods_id": 174,
                "status": 1,
                "next_execute_time": 1703174400,
                "signed_time": 1671618921,
                "signed_price": 36000,
                "pay_channel": 2,
                "period": 366,
                "mobile_app": "android"
              }
            ]
          }
        ],
        "start": 1669183804,
        "high_level_state": 1,
        "elec_reply_state": 1
      },
      {
        "up_uid": 293793435,
        "user_name": "社会易姐QwQ",
        "user_face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
        "item": [
          {
            "privilege_type": 10,
            "icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png",
            "name": "为TA充电",
            "expire_time": 1681401599,
            "renew": {
              "uid": 425503913,
              "ruid": 293793435,
              "goods_id": 173,
              "status": 1,
              "next_execute_time": 1680364800,
              "signed_time": 1677760921,
              "signed_price": 5000,
              "pay_channel": 4,
              "period": 31,
              "mobile_app": "android"
            },
            "start_time": 1677760921,
            "renew_list": [
              {
                "uid": 425503913,
                "ruid": 293793435,
                "goods_id": 173,
                "status": 1,
                "next_execute_time": 1680364800,
                "signed_time": 1677760921,
                "signed_price": 5000,
                "pay_channel": 4,
                "period": 31,
                "mobile_app": "android"
              }
            ]
          }
        ],
        "start": 1676033795,
        "high_level_state": 1,
        "elec_reply_state": 1
      }
    ],
    "page": 1,
    "page_size": 10,
    "total_page": 3,
    "total_num": 22,
    "is_more": 1
  }
}

表示自己从2022-11-23 14:10:04开始给“2233”包月充电，并且在2022-12-21 18:35:21在微信开通了连续包年充电，在2023-12-22 00:00:00的时候会自动续费36元，并继续充电366天；

自己从2023-02-10 20:56:35开始给“社会易姐QwQ”包月充电，并且在2023-03-02 20:42:01在支付宝开通了连续包月充电，在2023-04-02 00:00:00的时候会自动续费5元，并继续充电31天。

UP主包月充电详情

https://api.bilibili.com/x/upower/item/detailopen in new window

请求方式：GET

url参数：

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

json回复：

根对象：

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

data对象：

字段类型内容备注
upower_rankobj充电详情
itemobj充电欢迎语信息
user_cardobjUP主信息
upower_levelnumUP主开通的充电等级1：非高档充电
2：高档充电
elec_reply_statenum是否可对UP主进行专属问答
voucher_stateobj包月充电券信息详细信息有待补充
upower_right_countobj不同充电档位下的充电权益数
only_contain_medalbool享有的权益仅为粉丝勋章
privilege_typenum当前给该UP主包月充电的档位见充电档位代码与定价，若从未给该UP主包月充电过则为0

data中的upower_rank对象：

字段类型内容备注
totalnum充电用户总数
total_descstr充电总数文字说明示例：“1+”
listarray充电用户列表最多展示30个

upower_rank中的list数组：

项类型内容备注
0obj用户1
nobj用户(n+1)按照最初充电时间排序（？）
……obj…………

list数组中的对象：

字段类型内容备注
ranknum充电用户索引
midnum充电用户mid
nicknamestr充电用户昵称
avatarstr充电用户头像url

data中的item对象：

字段类型内容备注
intro_video_aidstr充电介绍视频AV号
welcomesstr充电介绍语

data中的user_card对象：

字段类型内容备注
avatarstrUP主头像url
nicknamestrUP主昵称

data中的upower_right_count对象：

字段类型内容备注
{充电档位代码}num该档位下的充电权益数

示例：

获取mid=1265680561的包月充电详情

curl 'https://api.bilibili.com/x/upower/item/detail' \
  --data-urlencode 'up_mid=1265680561' \
  -b 'SESSDATA=xxx'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "upower_rank": {
      "total": 5082,
      "total_desc": "5000+",
      "list": [
        {
          "rank": 1,
          "mid": 1476475459,
          "nickname": "一只屑椒",
          "avatar": "https://i1.hdslb.com/bfs/face/dc721da215f4651e0472d566b146ee8fdf198dbe.jpg"
        },
        {
          "rank": 2,
          "mid": 275365317,
          "nickname": "-陪我去看海吧i",
          "avatar": "https://i0.hdslb.com/bfs/face/dd7547b13020e7f47549ad7908fd3fc58efadefc.jpg"
        },
        {
          "rank": 3,
          "mid": 401909111,
          "nickname": "Vege5able",
          "avatar": "https://i2.hdslb.com/bfs/face/46b1fdc94c7851ec0c47817adeec13e3225da559.jpg"
        }
      ]
    },
    "item": {
      "intro_video_aid": "",
      "welcomes": "哈喽b站的小伙伴们，我的充电计划升级啦！ 感兴趣就多多支持我吧~(゜-゜)つロ"
    },
    "user_card": {
      "avatar": "https://i1.hdslb.com/bfs/face/5ddddba98f0265265662a8f7d5383e528a98412b.jpg",
      "nickname": "永雏塔菲"
    },
    "upower_level": 1,
    "elec_reply_state": 1,
    "voucher_state": {
      "voucher_order_id": "95843e812210c455d1ea6e4714bf105a00",
      "user_voucher_state": 2,
      "vip_action": 0,
      "voucher_name": "包月充电券（6元档）",
      "validate_price": 0,
      "validate_level": 0,
      "activity": "",
      "common_time": 0,
      "high_level_time": 0,
      "specify_up": 0,
      "specify_level": 0
    },
    "upower_right_count": {
      "10": 3
    },
    "only_contain_medal": false,
    "privilege_type": 0
  }
}

与UP主的包月充电关系

https://api.bilibili.com/x/upower/charge/follow/infoopen in new window

请求方式：GET

认证方式：Cookie(SESSDATA)或APP

url参数：

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

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-101：账号未登录
-400：请求错误
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象：

字段类型内容备注
daysnum已保持多少天包月充电状态
up_cardobjUP主信息
user_cardobj自己的信息
remain_daysnum剩余天数未处于包月充电状态为-1
remain_less_1daynum剩余的天数是否小于1天0：否
1：是
未处于包月充电状态为0
upower_rankobj充电详情
upower_iconstr充电图标url仅在处于包月充电状态时有内容
upower_right_countobj当前自己享有该UP主的充电权益数
only_contain_medalbool享有的权益仅为粉丝勋章
privilege_typenum当前给该UP主包月充电的档位代码见充电档位代码与定价，若未处于包月充电状态为0
challenge_infoobj充电挑战信息详细信息有待补充

data中的up_card对象：

字段类型内容备注
midnumUP主mid
nicknamestrUP主昵称
official_titlestrUP主认证信息
avatarstrUP主头像url

data中的user_card对象：

字段类型内容备注
avatarstr用户头像url
nicknamestr用户昵称

data中的upower_rank对象：

字段类型内容备注
totalnum充电用户总数
total_descstr充电总数文字说明示例：“1+”
listarray充电用户列表最多展示6个

upower_rank中的list数组：

项类型内容备注
0obj用户1
nobj用户(n+1)按照充电时间排序
……obj…………

数组list中的对象：

字段类型内容备注
ranknum充电用户索引
midnum充电用户mid
nicknamestr充电用户昵称
avatarstr充电用户头像url

示例：

获取与mid=293793435的包月充电关系

curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
  --data-urlencode 'up_mid=293793435' \
  -b 'SESSDATA=xxx'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "days": 17,
    "up_card": {
      "mid": 293793435,
      "nickname": "社会易姐QwQ",
      "official_title": "",
      "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"
    },
    "user_card": {
      "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg",
      "nickname": "晨叶梦春"
    },
    "remain_days": 15,
    "remain_less_1day": 0,
    "upower_rank": {
      "total": 1,
      "total_desc": "1+",
      "list": [
        {
          "rank": 1,
          "mid": 425503913,
          "nickname": "晨叶梦春",
          "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg"
        }
      ]
    },
    "upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png",
    "upower_right_count": 2,
    "only_contain_medal": false,
    "privilege_type": 10,
    "challenge_info": {
      "challenge_id": "",
      "description": "",
      "challenge_type": 0,
      "remaining_days": 0,
      "end_time": "",
      "progress": 0,
      "targets": [],
      "state": 0,
      "end_time_unix": 0,
      "pub_dyn": 0,
      "dyn_content": ""
    }
  }
}

表示自己已保持17天对“社会易姐QwQ”的包月充电，剩余15天过期。

包月充电用户排名

https://api.bilibili.com/x/upower/up/member/rank/v2open in new window

请求方式：GET

认证方式：Cookie(SESSDATA)或APP

url参数：

参数名类型内容必要性备注
up_midnum目标用户mid必要
psnum每页项数必要最大为101
pnnum页码必要
privilege_typenum充电档位代码非必要见充电档位代码与定价，默认为可以显示排名的档位中最高定价的档位

json回复：

根对象：

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

data对象：

字段类型内容备注
up_infoobjUP主信息
rank_infoarray当前档位的充电用户排名
user_infoobj自己在该档位下与UP主的充电关系
member_totalnum当前档位的充电用户总数
privilege_typenum当前充电档位代码见充电档位代码与定价
is_chargebool自己是否给该UP主包月充电过无论档位
tabsarray可显示排名的充电档位代码列表
level_infoarray可显示排名的充电档位信息

data中的up_info对象：

字段类型内容备注
midnumUP主mid
nicknamestrUP主昵称
avatarstrUP主头像url
typenumUP主认证类型-1：无
0：UP主认证
1：机构认证
titlestrUP主认证文字
upower_statenumUP主充电功能开启状态0：未开通充电功能
1：已开通自定义充电
2：已开通包月、自定义充电
3：已开通包月高档、自定义充电

data中的rank_info数组：

项类型内容备注
0obj用户1
nobj用户(n+1)按照充电排名排列
……obj…………

rank_info数组中的对象：

字段类型内容备注
midnum充电用户mid
nicknamestr充电用户昵称
avatarstr充电用户头像url
ranknum充电用户排名
daynum包月充电天数
expire_atnum包月充电过期时间恒为0
remain_daysnum剩余天数恒为0

data中的user_info对象：

字段类型内容备注
midnum用户mid
nicknamestr用户昵称
avatarstr用户头像url
ranknum包月充电排名不在该充电档位用户列表里为-1
daynum包月充电天数
expire_atnum包月充电过期时间秒级时间戳，若从未给UP主在该档位下包月充电过为0
remain_daysnum剩余天数若该档位充电状态已失效为0

data中的tabs数组：

项类型内容备注
0num档位代码1
nnum档位代码(n+1)
……num…………

data中的level_info数组：

项类型内容备注
0obj档位1
nobj档位(n+1)
……obj…………

level_info数组中的对象：

字段类型内容备注
privilege_typenum当前充电档位代码见充电档位代码与定价
namestr档位名称
pricenum档位价格单位为百分之一元人民币
member_totalnum当前档位的用户总数

示例：

获取给mid=686127包月充电的用户排名

curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
  --data-urlencode 'up_mid=686127' \
  --data-urlencode 'ps=3' \
  --data-urlencode 'pn=1' \
  -b 'SESSDATA=xxx'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "up_info": {
      "mid": 686127,
      "nickname": "籽岷",
      "avatar": "https://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp",
      "type": 0,
      "title": "2024百大UP主、知名游戏UP主",
      "upower_state": 3
    },
    "rank_info": [
      {
        "mid": 187012867,
        "nickname": "是我灬不配",
        "avatar": "https://i1.hdslb.com/bfs/face/ad4d2ce0705fd766a0ade315f5a6a5984ce479f4.jpg",
        "rank": 1,
        "day": 682,
        "expire_at": 0,
        "remain_days": 0
      },
      {
        "mid": 20135495,
        "nickname": "和平时一样鸽",
        "avatar": "https://i2.hdslb.com/bfs/face/0eef725964105f39b1f000a59f232d9094017544.jpg",
        "rank": 2,
        "day": 620,
        "expire_at": 0,
        "remain_days": 0
      },
      {
        "mid": 490065730,
        "nickname": "乔治Y-GYhaha",
        "avatar": "https://i1.hdslb.com/bfs/face/e1753e1e43d7a7df5333c5a2f4d3ec1d0334ebe6.jpg",
        "rank": 3,
        "day": 527,
        "expire_at": 0,
        "remain_days": 0
      }
    ],
    "user_info": {
      "mid": 425503913,
      "nickname": "晨叶梦春",
      "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg",
      "rank": -1,
      "day": 0,
      "expire_at": 0,
      "remain_days": 0
    },
    "member_total": 46881,
    "privilege_type": 50,
    "is_charge": false,
    "tabs": [50, 10],
    "level_info": [
      {
        "privilege_type": 50,
        "name": "审稿",
        "price": 12800,
        "member_total": 1082
      },
      {
        "privilege_type": 10,
        "name": "石粒",
        "price": 600,
        "member_total": 46158
      }
    ]
  }
}