logo

B 站视频数据采集

按关键词搜索或按视频链接,采集 B 站(哔哩哔哩)视频的播放、点赞、投币、收藏、分享、弹幕、评论、UP 主与分区等数据

发布者
价格
¥0.001 / 条
最近更新
2026-11-18

概览

给一个关键词,或者一批视频链接,它会把 B 站上对应的视频找出来,整理成一张视频表现表:标题、播放量、点赞、投币、收藏、分享、弹幕、评论、时长、分区、发布时间和 UP 主。

做内容运营和选题研究的人,最费时间的往往不是判断,而是把一条条视频页上的播放、点赞、收藏抄进表格。这个应用把这一步变成一次运行:给关键词就按站内搜索排名往下取,给链接就直接按链接取。

怎么填输入

按关键词搜索:采集方式选「关键词搜索」,填一个词(比如 猫咪),再用「最多采集条数」控制要多少条。默认就是这种方式。

按视频链接:采集方式选「视频链接」,然后在「视频链接」框里填一个 JSON 数组,可以直接复制这个改:

["https://www.bilibili.com/video/BV17x411w7KC", "BV1jFUkBPEZA"]

多个地址就照这样用英文逗号隔开、每项加引号。下面这些写法都认:

写法例子
完整链接https://www.bilibili.com/video/BV17x411w7KC
手机端链接https://m.bilibili.com/video/BV17x411w7KC
纯 BV 号(大小写都行)BV1jFUkBPEZA、bv1jFUkBPEZA
av 号或纯数字 aidav170001、170001
短链https://b23.tv/BV17x411w7KC
分享文案整段粘贴【某个视频】 https://b23.tv/BV17x411w7KC

如果运行时提示 start_urls: '...' is not of type 'array',说明这个框被填成了普通文本,按上面的例子补上方括号和引号即可。

注意两件事:什么都不填直接点运行,会按默认值去搜 cat、取 50 条,会真的跑出数据;填「最多采集条数」1000 时实际通常只出 900 多条,原因见下。

数据说明

一条视频一条记录,用「视频 BV 号」去重,同一批输入重复运行不会产生重复行。两种取数方式落的是同一张表,区别只在来源列:「命中关键词」和「搜索名次」只有在按关键词搜索时才有值,按链接采集时前者为空、后者是 -1。

按关键词搜索时,程序会一直往下翻页,直到取够「最多采集条数」为止,而不是取固定几页就收工——站内搜索的相邻页经常出现同一条视频,取固定页数去重后必然短一截。也正因为跳过了重复项,「搜索名次」会出现跳号(比如取 100 条,名次可能排到 119),那是视频在搜索结果里的真实位置,不是漏采。站内搜索最多只能翻到第 50 页,所以填 1000 时通常拿到 900 多条;关键词本身结果不足时也会少于目标,这两种情况日志里都会写明。

播放、点赞、投币、收藏、分享、弹幕、评论都是采集当刻的累计值,会随视频热度实时变化,要对比趋势请隔几天用同样的输入再跑一次,用「采集时间」区分批次。时长统一换算成秒。发布时间和采集时间都是 UTC 时区,直接按北京时间看会差 8 小时。

站内搜索接口本身不返回投币数和分享数,这两列会用视频详情补齐;某条详情没取到时记 -1 表示「未取到」,不要当成 0。同理,点赞、评论等列也沿用这个约定。

「分享数」直接取 B 站详情接口里的原始值,是平台自己的统计口径(疑似把外部转发也算了进去),所以个别视频会出现千万级的数字,那是 B 站返回的原始数据,不是解析出错。如果用它和别的工具做对账,这一列对不上是正常的。

「分区」两种模式都会尽量填:按关键词搜索时直接取站内搜索给的分区名;按链接采集时,上游详情只回分区编号不回名称,程序会用相关推荐里同分区视频的名字反查,绝大多数能补上,极少数(相关推荐里没有同分区视频)为空,这时可以用「视频标签」判断内容类型。同一条视频用 BV 号和 av 号各写一遍只出一条记录。

仅粉丝可见、已删除、已下架以及需要付费解锁的视频取不到数据,会在日志里跳过,不影响同一批里的其他视频。评论区只给数量,不返回评论正文;弹幕也只给条数。

结果长这样

每条记录是一个视频在采集当刻的表现快照。

视频标题播放量点赞数收藏数弹幕数UP 主昵称
给我家猫咪看的动画149211611818129021569猫老大的世界
【MV】保加利亚妖王AZIS视频合辑45851017943944876717915703冰封.虾子

除上表外还有投币数、分享数、评论数、时长、封面图、分区、发布时间、UP 主 ID 与头像、视频地址、命中关键词、搜索名次、标签、分P数量等列。

应用场景

  • 选题研究:按关键词搜一批视频,把「播放量」按「分区」分组,看哪类内容在这个话题下更容易起量,再结合「时长」判断是短平快还是长视频更吃香。
  • 互动质量评估:算「点赞数」「投币数」「收藏数」与「播放量」的比值,投币和收藏占比高的视频说明内容认可度强,比只看播放量更接近真实口碑。
  • 榜单追踪:同一关键词每隔几天跑一次,用「搜索名次」和「播放量」看哪条视频在往上冲,「发布时间」帮你排除老视频的自然累积。
  • UP 主表现盘点:按「UP 主昵称」汇总同一批结果,看单个账号在本话题下的产出数量和平均播放水平。

适用边界

只采集 B 站公开视频的展示与互动数据,不含用户隐私、不下载视频文件、不抓取评论正文

  • 适合用于
  • 要按关键词批量拿一批 B 站视频的播放/点赞/投币等互动数据做内容分析
  • 盯某个话题或某个 UP 主的视频表现,需要按时间反复跑同一批关键词做对比
  • 手上有一批 B 站链接,要批量转成一张结构化视频表
  • 不要用于
  • 需要评论正文、弹幕正文或用户画像,本应用只给数量不给内容
  • 需要下载视频文件或音频
  • 需要私密、仅粉丝可见或已下架视频的数据

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1上游返回 HTTP 412 或 code -412 表示出口 IP 被风控,请换出口 IP 或稍后重试
  2. 2单个视频被删除或不可见时会跳过并记日志,不影响其他记录
  3. 3中途被拦时已采集的记录照常保留,运行不会整体失败

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • 采集方式mode必填string(enum)
    按关键词搜索视频,还是采集指定的视频链接。填 search 时看「搜索关键词」,填 url 时看「视频链接」
    可选值关键词搜索search视频链接url默认值search
  • 搜索关键词query选填string
    在 B 站站内搜索这个关键词,按综合排序取结果。支持中文、英文、多个词用空格分隔;只在「关键词搜索」方式下生效
    默认值cat
  • 视频链接start_urls选填array<string>
    要采集的视频地址。必须是 JSON 数组,形如 ["https://www.bilibili.com/video/BV17x411w7KC"];多个地址写成 ["地址1", "地址2"]。支持:完整链接、m.bilibili.com 移动端链接、纯 BV 号(大小写都认)、av 号或纯数字 aid、b23.tv 短链,也可以直接粘 App 分享出来的一整段话;带 ?p= 的分P链接按整条视频采集。若提示「is not of type 'array'」,说明填成了普通文本,请补上方括号和引号。只在「视频链接」方式下生效
    数量最多 1000 项示例["https://www.bilibili.com/video/BV17x411w7KC"]
  • 最多采集条数max_results选填integer
    关键词搜索方式下最多返回多少条视频,按搜索排名从小到大取。实际产出可能少于这个数:B 站搜索最多只翻到 50 页,且相邻页会重复推同一条视频(重复项已去重),填 1000 通常拿到 900 多条。视频链接方式下按填了几条链接采集,不受这个数字影响
    范围1–1000默认值50

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • 视频 BV 号bvidstring
    视频在 B 站的 BV 编号,同一条视频的稳定标识,也用作去重键
    示例BV1jFUkBPEZA
  • av 号aidinteger
    视频的旧版数字编号 aid,BV 号与之等价
    示例115603541137064
  • 视频标题titlestring
    视频标题原文,已去掉搜索结果里的关键词高亮标签
    示例给我家猫咪看的动画
  • 视频简介descriptionstring
    UP 主填写的视频简介原文,可能为空

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "bvid": "BV1jFUkBPEZA",
  "aid": 115603541137064,
  "title": "给我家猫咪看的动画",
  "description": "<description>",
  "views": 1492116,
  "likes": 11818,
  "coins": 5123,
  "favorites": 12902,
  "shares": 8923,
  "danmaku": 1569,
  "comments": 899,
  "duration": 2089,
  "thumbnail": "https://i2.hdslb.com/bfs/archive/319020c06956b003db3ec42fd87726cdd270e671.jpg",
  "category": "喵星人",
  "publish_date": "2025-11-24T10:00:00+00:00",
  "author_name": "猫老大的世界",
  "author_mid": 385510297,
  "author_face": "https://i1.hdslb.com/bfs/face/248296d6c84008ab65fbea71eaf20d560b6a6868.jpg",
  "url": "https://www.bilibili.com/video/BV1jFUkBPEZA",
  "fetched_at": "2026-11-17T06:37:54.750309+00:00",
  "search_keyword": "猫咪",
  "search_rank": 1,
  "tags": "<tags>",
  "part_count": 1
}

调用方式

本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。

通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "bazhuayu_datahub": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=slzc81gz/bilibili-video-scraper",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。

如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。

价格

按条计费

按实际成功返回的数据条数计费,任务失败不计费。

¥0.001/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.001 / 条