适用场景在社交媒体监控、创作者数据分析、自动化内容采集等场景中获取指定B站用户的最新动态是常见需求。动态包含视频投稿、图文、纯文本转发等多种类型还附带互动统计点赞、评论、转发数。通过该API开发者可以批量拉取动态列表构建自定义监控面板或数据仓库而不需要模拟浏览器登录或抓取HTML页面。接口能力边界接口暴露的是B站官方公开的动态数据每个请求可获取指定用户最近的动态列表默认返回5条具体数量受限于服务端分页策略。QPS限制为5次/秒不建议高频轮询单个用户。数据覆盖范围为动态创建时间、内容文本、附件信息如视频封面、图片列表以及互动统计。需要注意该接口不返回用户的全部历史动态仅返回最近活跃的动态若用户设置为隐私保护或关闭动态公开则可能返回空列表。请求参数与鉴权接口地址https://v1.apizero.cn/api/bili-dynamic请求方法GETQuery 参数参数类型必填说明示例uidstring是B站用户UID纯数字208259鉴权方式需要在请求头中携带X-API-Key值为你的API密钥通过API平台获取。密钥用于身份认证和用量统计请妥善保管不要泄露到公开仓库或客户端代码中。curl 接入示例以下示例使用环境变量APIZERO_API_KEY存储密钥替换为目标UIDcurl -sS \ -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/bili-dynamic?uid208259成功返回后可通过jq工具格式化输出curl -sS -X GET -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/bili-dynamic?uid208259 | jq .Python 代码接入示例如果需要集成到后端服务推荐使用requests库import requests import os API_KEY os.environ.get(APIZERO_API_KEY) UID 208259 url https://v1.apizero.cn/api/bili-dynamic headers {X-API-Key: API_KEY} params {uid: UID} try: resp requests.get(url, headersheaders, paramsparams, timeout10) resp.raise_for_status() data resp.json() print(data) except requests.exceptions.RequestException as e: print(f请求失败: {e})返回值解读成功的HTTP状态码为200响应体为JSON对象外层结构{ code: 0, msg: 成功, data: { uid: 208259, count: 5, list: [ { dynamic_id: 8xxx, type: DYNAMIC_TYPE_AV, text: 动态的文本内容..., stats: { likes: 1000, comments: 100, forwards: 50 } } ] } }关键字段说明code: 业务状态码0表示成功非0表示异常具体业务错误码请参考文档msg: 状态描述信息data.uid: 请求的UID可用于校验data.count: 返回的动态条数data.list: 动态对象数组每个元素包含dynamic_id: 动态唯一标识可用于去重或后续详情查询type: 动态类型常见枚举值包括DYNAMIC_TYPE_AV– 视频投稿DYNAMIC_TYPE_FORWARD– 转发DYNAMIC_TYPE_WORD– 纯文本动态DYNAMIC_TYPE_DRAW– 图文动态text: 动态的文字内容可能包含Emoji或HTML实体需做转义处理stats: 互动统计数据likes: 点赞数comments: 评论数forwards: 转发数注意stats中的数值为动态实时快照并非持续实时更新。对于视频类动态视频本身的播放量等指标不在本接口返回范围内。常见错误与排查HTTP层面错误状态码原因解决方案401 UnauthorizedAPI Key无效或未提供检查X-API-Key头是否正确403 Forbidden密钥权限不足确认密钥是否针对该接口开通429 Too Many Requests超过QPS限制降低请求频率加入重试退避逻辑500 Internal Server Error服务端异常等待后重试若持续报错请联系平台业务错误码code字段-1: 参数错误例如uid为空或包含非数字字符-2: 用户不存在或UID无效-3: 该用户动态不可见隐私设置或封禁状态当code不为0时msg字段会提供简要错误描述建议记录日志并通知调用方。工程化注意事项1. API Key安全管理使用环境变量或密钥管理服务如Vault存储API Key绝不要硬编码在代码中。若在客户端如浏览器前端使用必须通过后端代理转发避免密钥暴露。2. 频率控制与重试策略接口QPS为5意味着每秒钟最多发送5个请求。如果监控多个用户建议使用令牌桶或延迟队列控制并发。若收到429响应可采用指数退避重试初始等待1秒逐步增加至30秒。3. 数据缓存与更新动态列表不包含分页游标每次请求返回最近5条具体数量可能调整。若需要持久化存储建议将dynamic_id作为主键每次比较本地最大dynamic_id与返回列表中的ID仅插入新数据避免重复。缓存TTL可设为510分钟降低API调用量。4. 动态类型处理不同type的动效在UI展示上差异较大。建议在业务代码中建立类型枚举映射例如DYNAMIC_TYPE_AV→ 渲染为视频卡片DYNAMIC_TYPE_DRAW→ 图文混排DYNAMIC_TYPE_WORD→ 纯文本DYNAMIC_TYPE_FORWARD→ 引用原始动态并显示转发评论如果某些类型不在已知枚举中应将其归类为“未知动态”避免前端崩溃。5. 错误监控与告警在生产环境中对code ! 0或HTTP错误进行指标统计并通过Prometheus/Grafana、Sentry等工具触发告警以便及时发现API稳定性问题。参考文档B站用户动态API文档原始文档本文所有接口参数与示例均基于上述文档如有更新请以文档为准。