B站视频在线人数接口详解：哔哩哔哩-API收集整理中的热度监控功能

B站视频在线人数接口详解：哔哩哔哩-API收集整理中的热度监控功能

在B站内容运营中，实时掌握视频在线人数是评估内容热度、优化推广策略的关键指标。本文基于开源项目GitHub_Trending/bi/bilibili-API-collect提供的接口文档，详细解析视频在线人数的获取方式及数据应用场景，帮助运营人员快速接入并利用这一核心数据能力。

接口功能概述

B站视频在线人数接口（Online Viewers API）是哔哩哔哩-API收集整理项目中收录的核心功能之一，用于获取指定视频在Web端和APP端的实时观看数据。该接口返回的信息包括跨终端总在线人数、Web端实时人数及数据展示控制参数，支持通过稿件ID（avid/bvid）和分P ID（cid）精准定位视频资源。

项目中与视频相关的图标资源：assets/img/video_up.svg

Web端接口调用指南

基础信息

• 请求地址：https://api.bilibili.com/x/player/online/total
• 请求方式：GET
• 文档路径：docs/video/online.md

参数说明

参数名	类型	内容	必要性	备注
aid	num	稿件avid	必要(可选)	avid与bvid任选一个
bvid	str	稿件bvid	必要(可选)	avid与bvid任选一个
cid	num	视频cid	必要	用于选择目标分P

调用示例

查询视频av759949922（BV1y64y1q757）中1P（cid=392402545）的在线人数：

curl -G 'https://api.bilibili.com/x/player/online/total' \
--data-urlencode 'aid=759949922' \
--data-urlencode 'cid=392402545'

响应解析

查看响应示例

{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "total": "9.4万+",
        "count": "50953",
        "show_switch": {
            "total": true,
            "count": true
        }
    }
}

核心字段	说明
total	所有终端总计人数（含模糊处理，如"9.4万+"）
count	Web端实时精确人数（整数）
show_switch	数据展示权限控制（布尔值）

热度排名相关图标：assets/img/ranking.svg

APP端接口调用指南

基础信息

• 请求地址：https://app.bilibili.com/x/v2/view/video/online
• 请求方式：GET
• 权限要求：需APP密钥（appkey）及签名（sign）

参数说明

参数名	类型	内容	必要性	备注
aid	num	稿件avid	必要
appkey	str	APP密钥	APP方式必要	获取方式
cid	num	视频cid	必要	用于选择目标分P
ts	num	当前时间戳	APP方式必要
sign	str	APP签名	APP方式必要	签名算法

调用示例

curl -G 'https://app.bilibili.com/x/v2/view/video/online' \
--data-urlencode 'aid=759949922' \
--data-urlencode 'appkey=1d8b6e7d45233436' \
--data-urlencode 'cid=392402545' \
--data-urlencode 'ts=0' \
--data-urlencode 'sign=172dfd9941a01275eb93ce6246cd8556'

响应解析

查看响应示例

{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "online": {
            "total_text": "8.8万+人在看"
        }
    }
}

APP端响应相比Web端更简洁，直接返回格式化的总在线人数文本（如"8.8万+人在看"），适合移动端UI展示。

错误码参考

调用接口时可能遇到的常见错误：

错误码	含义	解决方案
0	请求成功	-
-400	请求错误	检查参数完整性（如cid是否缺失）
-404	无视频	确认avid/bvid/cid是否有效

完整错误码列表可参考项目文档：docs/misc/errcode.md

错误状态相关图标：assets/img/ban.png

应用场景与最佳实践

1. 实时热度监控
   通过定时轮询（建议间隔30-60秒）获取在线人数，绘制热度曲线，识别视频流量高峰时段。结合视频推荐接口数据，可优化发布时间策略。

2. 分P内容效果对比
   对多P视频（如系列教程）分别调用接口，比较各分P的在线人数差异，辅助评估内容质量。

3. 异常流量告警
   设置人数阈值，当检测到在线人数突增/突降时触发通知，及时发现视频被推荐或下架等异常情况。

接口文档维护与更新

该接口文档由哔哩哔哩-API收集整理项目团队持续维护，最新变更记录可通过以下途径获取：

• 项目贡献指南：CONTRIBUTING.md
• 视频接口目录：docs/video/
• 实时更新日志：项目README.md的"最近更新"部分

文档更新相关图标：assets/img/add.svg

总结

B站视频在线人数接口为内容创作者和运营人员提供了直接的热度监测工具，Web端接口适合快速调试和轻量应用，APP端接口则提供更完整的终端覆盖数据。通过合理利用这些接口，结合项目中其他API（如弹幕历史接口、评论列表接口），可构建全方位的B站内容运营分析体系。

项目地址：https://gitcode.com/GitHub_Trending/bi/bilibili-API-collect