适用场景B站用户动态API允许开发者通过公开接口获取指定用户的最新动态列表包括视频投稿、图文、纯文本、转发等多种类型并附带发布时间、点赞/评论/转发统计等数据。典型使用场景包括个人站点或博客展示自己的B站最新动态内容监控与分析工具定时采集目标UP主动态第三方社交平台或机器人转发B站动态数据归档与历史备份需注意合规性需要特别注意的是该接口适用于非恶意、低频次的数据获取场景大规模商业爬取或超量调用既违反B站用户协议也容易触发API服务端的限流机制。接口能力边界数据源B站官方公开API通过第三方代理服务封装此处为v1.apizero.cn请求方法GETQPS限制5次/秒即单API Key每秒最多发起5次请求超出后将返回HTTP 429状态码返回数据量每次请求返回指定用户的最新动态列表data.count字段表示本次返回的动态数量最大数量以文档为准实际测试约为20条左右建议查看文档页确认数据实时性由于存在多层缓存动态发布时间与实际请求时间之间可能有几分钟延迟不适合强实时场景区域与网络仅支持中国大陆网络访问海外节点可能因DNS或防火墙问题失败请求参数与鉴权请求URLGET https://v1.apizero.cn/api/bili-dynamic查询参数参数名类型必填描述示例值uidstring是B站用户UID纯数字字符串208259说明uid参数必须为纯数字不可包含字母或特殊符号。如果传入非法格式API会返回400错误。鉴权方式请求时需要在HTTP头部添加X-API-Key字段值为申请到的API密钥。密钥由API服务平台提供需妥善保管不要泄露到公开仓库或客户端代码中。请求示例curl以下是一个可复制的curl请求示例请将$APIZERO_API_KEY替换为你自己的密钥curl -sS \ -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/bili-dynamic?uid208259执行成功后返回JSON格式数据。如果未设置API Key或Key无效将返回401错误。返回字段解读响应结构{ code: 0, msg: 成功, data: { count: 5, list: [ { dynamic_id: 8xxx, stats: { comments: 100, forwards: 50, likes: 1000 }, text: ..., type: DYNAMIC_TYPE_AV } ], uid: 208259 } }字段说明字段路径类型描述codeint业务状态码0表示成功非0表示失败msgstring状态描述文本data.countint本次返回的动态数量data.uidstring请求的UID回显data.list[].dynamic_idstring动态唯一ID可用于后续接口如动态详情data.list[].typestring动态类型枚举常见值DYNAMIC_TYPE_AV视频、DYNAMIC_TYPE_DRAW图文、DYNAMIC_TYPE_WORD纯文本、DYNAMIC_TYPE_FORWARD转发data.list[].textstring动态文本内容可能包含换行符和表情符号注意转义data.list[].stats.commentsint评论数data.list[].stats.forwardsint转发数data.list[].stats.likesint点赞数提示除了上述示例字段外实际返回中可能还包含timestamp发布时间、origin转发来源等字段以原始文档为准。常见错误与排查HTTP状态码codemsg示例原因与排查步骤4001001参数错误检查uid是否为空、是否包含非数字字符4011002未授权API Key缺失或错误检查请求头X-API-Key是否正确传递4291003请求过于频繁超过QPS限制5/s需降低请求频率或使用令牌桶限流5009999服务器内部错误服务端临时异常可等待几秒后重试排查建议使用curl -v查看详细请求与响应头若收到429实现指数退避重试如等待1s、2s、4s…若持续500检查网络是否为纯大陆IP或联系API服务支持工程化注意事项1. 本地限流保护由于QPS为5客户端需要主动控制请求频率避免突发请求被限流。推荐使用令牌桶算法import time import requests from threading import Lock class TokenBucket: def __init__(self, rate, capacity): self.rate rate # 每秒填充令牌数 self.capacity capacity # 桶容量 self.tokens capacity self.last_refill time.time() self.lock Lock() def consume(self, tokens1): with self.lock: now time.time() elapsed now - self.last_refill self.tokens min(self.capacity, self.tokens elapsed * self.rate) self.last_refill now if self.tokens tokens: self.tokens - tokens return True return False bucket TokenBucket(5, 5) # 每秒5个桶容量5 def fetch_dynamic(uid): while not bucket.consume(): time.sleep(0.05) resp requests.get( https://v1.apizero.cn/api/bili-dynamic, params{uid: uid}, headers{X-API-Key: YOUR_KEY} ) return resp.json()2. 缓存策略对于相同UID的请求结果设置一个合适的缓存时间如60秒避免在短时间内重复拉取相同数据。可以使用内存缓存如Python的cachetools或Redis。3. 错误重试与退避对非400/401的错误429、5xx进行重试最多重试3次每次间隔递增1s, 2s, 4s。对于400/401错误不要重试直接记录日志。4. 日志与监控记录每次请求的URL、耗时、状态码、返回code。当失败率code非0或网络错误超过阈值时发送告警。建议使用结构化日志如JSON格式方便后续分析。5. 合规使用只获取你自己账号或公开UP主的动态不要尝试爬取隐私数据如私信遵守B站开发者协议不以任何形式出售数据对获取的数据做脱敏处理如去掉用户ID后缀参考文档接口文档页https://apizero.cn/aidocs/bili-dynamic原始文档Raw Markdownhttps://apizero.cn/aidocs/bili-dynamic/raw.md
