# B站接口为什么返回 412（2026）

412 是 B站的风控：请求被判成机器，直接拒绝。常见原因是请求太快、该带 WBI 签名（wts、w_rid）的接口没带或签错、或者接口突然收紧。用 XTikAPI 不用管签名：带你的 Key 调就行，一次 $0.002，被拒的调用不收费。 XTikAPI 有 10 个B站接口，一次 $0.002 起，失败不收费；验证过邮箱的新账号送 $0.50 试用额度，不用绑卡。

更新于 2026-11-18

## 怎么判断是哪种

按 bilibili-API-collect 社区的 issue 和讨论。

| 看到什么 | 多半是 | 怎么办 |
| 偶尔 412，过一会儿好了 | 请求太快 | 降频 |
| 每次都 412 | WBI 签名缺了或算错（讨论 1010 里维护者先问的就是这个） | 检查 wts、w_rid |
| 一直正常的接口突然 412 | 风控收紧，比如 issue 1018 的用户投稿搜索 | 等社区更新 |
| 带了签名还 412 | bili_ticket 在风控里权重变高（issue 1007） | 补 ticket |

## XTikAPI 能拿到什么

`bilibili.videos.search` 按搜索词取视频；`bilibili.videos.detail` 和 `bilibili.comments.list` 用 BV 号；`bilibili.videos.list` 按 uid 取 UP 主的视频。不需要你的 Cookie、WBI 密钥或 ticket。

## 为什么用 XTikAPI

- 先看再用：229 个接口里有 192 个在接口页上放了一份录制的真实返回（B站 10/10），字段一目了然。
- 一种返回格式：19 个平台的内容、评论、账号都是同一种对象，作者在 author，互动数在 metrics，换平台不用重写解析。
- 花钱可控：失败和超时不收费，返回里写着 charged: false；X-Max-Price 限定一次最多花多少，同一个 Idempotency-Key 24 小时内不重复扣费。
- 预付余额，不订阅：余额不过期，没用完的充值 14 天内可退。
- 接 AI 方便：每页都有 Markdown 版，另有 llms.txt 和 OpenAPI，ChatGPT、Claude、Cursor 能直接读。

## 用到的接口

- [B站视频搜索](https://xtikapi.com/zh/apis/bilibili/videos/search) ($0.002 / 次): 按搜索词取一页 B站视频，可按综合、播放、发布时间排，可限定时长和发布时间段。
- [B站视频详情](https://xtikapi.com/zh/apis/bilibili/videos/detail) ($0.002 / 次): 按 BV 号取一个视频：标题、简介、UP 主、播放、点赞、投币、收藏、分 P 的 cid。
- [B站视频评论](https://xtikapi.com/zh/apis/bilibili/comments/list) ($0.002 / 次): 按 BV 号取一页视频评论：正文、评论者、点赞数、回复数、发布时间。
- [B站 UP 主视频列表](https://xtikapi.com/zh/apis/bilibili/videos/list) ($0.002 / 次): 按 UP 主的 uid 取他发布的视频，可按最新或最多播放排。

## B站的更多问题

- [B站 API](https://xtikapi.com/zh/apis/bilibili)
- [B站视频字幕和 AI 字幕怎么用接口获取](https://xtikapi.com/zh/answers/bilibili-ai-subtitles-api)
- [B站视频评论怎么批量导出](https://xtikapi.com/zh/answers/bilibili-comments-export)
- [B站热搜和热门榜有接口吗](https://xtikapi.com/zh/answers/bilibili-hot-ranking-api)
- [B站 BV 号怎么转 AV 号](https://xtikapi.com/zh/answers/bilibili-bv-to-aid)
- [MediaCrawler 有不用自己部署的替代吗](https://xtikapi.com/zh/answers/mediacrawler-alternative)

## 出处

本页写到的别家的情况，都来自对方自己的页面和文档，读取于 2026-11-18。

- bilibili-API-collect issue 1018：wbi/arc/search 返回 412
- bilibili-API-collect 讨论 1010：WBI 参数
- bilibili-API-collect issue 1007：bili_ticket
- Agent Reach 文档：怎么处理 B 站 412

---

XTikAPI: one API key for public social media data, prepaid per call. [HTML version](https://xtikapi.com/zh/answers/bilibili-412-error) · [llms.txt](https://xtikapi.com/llms.txt) · [OpenAPI](https://xtikapi.com/openapi.json)
