哔哩哔哩-API收集整理：用户状态数接口调用与数据分析-CSDN博客

哔哩哔哩-API收集整理：用户状态数接口调用与数据分析

在哔哩哔哩（Bilibili）平台的运营和数据分析中，用户状态数（如粉丝数、播放量、投稿数等核心指标）是评估用户影响力、内容传播效果的关键依据。本文将系统介绍哔哩哔哩-API收集整理项目中与用户状态数相关的接口调用方法，帮助运营人员和开发者快速获取并分析用户数据。

接口概览与应用场景

哔哩哔哩用户状态数接口主要分布在docs/user/status_number.md文档中，涵盖四大类核心功能：

关系状态数：获取用户关注数、粉丝数、黑名单数等社交关系数据
UP主状态数：统计视频播放量、专栏阅读量、获赞数等内容创作指标
导航栏状态数：查询投稿视频数、追番追剧数、收藏夹等综合数据
相簿投稿数：专项统计绘画、摄影、日常图片等视觉内容的发布量

这些接口广泛应用于创作者数据看板、粉丝画像分析、竞品监测等场景。例如：运营人员可通过UP主状态数接口追踪视频播放量增长趋势，或通过关系状态数接口分析用户社交网络结构。

核心接口调用详解

1. 关系状态数接口

该接口位于docs/user/status_number.md第3-66行，用于获取用户的社交关系数据，包括关注数、粉丝数、悄悄关注数和黑名单数。

请求示例：

curl -G 'https://api.bilibili.com/x/relation/stat' \
--data-urlencode 'vmid=332704117' \
-b 'SESSDATA=xxx'

参数说明： | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | | vmid | num | 目标用户mid | 必要 | |

响应解析：成功调用后返回JSON数据，核心字段包括：

following：关注用户数
follower：粉丝总数
whisper：悄悄关注数（需登录本人账号）
black：黑名单用户数（需登录本人账号）

2. UP主状态数接口

位于docs/user/status_number.md第68-146行，专为内容创作者设计，提供视频播放量、专栏阅读量和获赞数的统计数据。

认证要求：必须通过Cookie（SESSDATA）或APP登录认证，未登录状态下将无法获取数据。

请求示例：

curl -G 'https://api.bilibili.com/x/space/upstat' \
--data-urlencode 'mid=456664753' \
-b 'SESSDATA=xxx'

响应结构：

{
  "code": 0,
  "data": {
    "archive": {"view": 213567370},  // 视频总播放量
    "article": {"view": 3230808},    // 专栏总阅读量
    "likes": 20295095                // 累计获赞数
  }
}

3. 导航栏状态数接口

位于docs/user/status_number.md第148-245行，提供用户综合数据概览，包括投稿内容数量、追番追剧数、收藏夹等信息。

关键指标： | 字段 | 说明 | 隐私特性 | |-----------|----------------------|------------------------| | video | 投稿视频数 | 公开数据 | | bangumi | 追番数 | 无视隐私设置 | | cinema | 追剧数 | 无视隐私设置 | | favourite | 收藏夹数（主/客） | 主人视角需登录认证 |

请求示例：

curl -G 'https://api.bilibili.com/x/space/navnum' \
--data-urlencode 'mid=645769214'

4. 相簿投稿数接口

位于docs/user/status_number.md第247-305行，专项统计用户在相簿功能中发布的视觉内容数据，包括绘画、摄影和日常图片三类。

数据分类：

draw_count：绘画作品数量
photo_count：摄影作品数量
daily_count：日常图片动态数量
all_count：总相簿数量（三者之和）

请求示例：

curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/upload_count' \
--data-urlencode 'uid=53456'

数据分析与应用案例

典型应用场景

创作者成长追踪
通过定期调用UP主状态数接口，记录archive.view（播放量）和likes（获赞数）的变化趋势，可绘制创作者成长曲线。例如：某UP主30天内播放量从100万增长至500万，结合投稿频率分析内容优化效果。
粉丝画像构建
利用关系状态数接口的follower（粉丝数）和导航栏状态数的bangumi（追番数），可分析粉丝群体的兴趣偏好。如：粉丝追番数TOP3的番剧类型，可指导创作者调整内容方向。
竞品对标分析
同时调用多个目标用户的状态数接口，对比分析粉丝增长率、互动率等指标。例如：通过follower字段差值计算竞品用户的粉丝增长速度，结合内容发布频率找出运营差异点。

数据可视化建议

mermaid

接口调用注意事项

认证机制
- 涉及用户隐私数据（如悄悄关注数、黑名单）需提供SESSDATA Cookie
- APP端调用需使用access_key参数进行认证
- 公开数据（如公开粉丝数）可无需认证直接调用
请求限制
- 单IP建议控制QPS在10以内，避免触发反爬机制
- 批量查询时建议添加随机间隔（1-3秒）
- 敏感操作（如频繁查询同一用户）可能导致临时IP限制
错误处理
常见错误码处理参考docs/misc/errcode.md：
- -400：请求参数错误（检查vmid格式）
- -403：权限不足（补充认证信息）
- -101：账号未登录（Cookie失效）

总结与扩展

哔哩哔哩用户状态数接口为平台运营和数据分析提供了标准化的数据获取方式。通过本文介绍的四个核心接口，可全面掌握用户的社交关系、内容创作、兴趣偏好等多维度数据。实际应用中，建议结合docs/dynamic/action.md（动态操作接口）和docs/comment/action.md（评论互动接口），构建更完整的用户行为分析体系。

项目完整接口文档请参考docs/user/status_number.md，更多API使用技巧可关注项目更新日志。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考