万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

B站

B站 API

检索 B 站视频，用 mid 定位 UP 主、用 BV 视频链接读取稿件、评论、第一分 P 弹幕和语音转写；弹幕偏移与评论时间分开，转写不等于人工字幕。 调用 POST /api/v1/social ；返回结构化 JSON，$0.56 / 千次；失败不计费。

免费开始 看文档

7

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

B站 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordsort默认 20 · 最多 50同步$0.56 / 千次id · url · title · text · duration_seconds · duration_text · view_count · like_count · comment_count · danmaku_count · favorite_count · coin_count · share_count · thumbnail_url · posted_at · category · author_name · author_id · author_url · platform · tags
profileuser_id——同步$0.56 / 千次user_id · name · url · bio · avatar_url · gender · level · follower_count · following_count · video_count · like_count · is_verified · verified_title · is_vip · vip_label · birthday · school · platform · recent_videos
user_postsuser_id—默认 20 · 最多 50同步$0.56 / 千次id · url · title · text · duration_seconds · duration_text · view_count · like_count · comment_count · danmaku_count · favorite_count · coin_count · share_count · thumbnail_url · posted_at · category · author_name · author_id · author_url · platform · tags
videourl——同步$0.56 / 千次id · url · title · text · duration_seconds · duration_text · view_count · like_count · comment_count · danmaku_count · favorite_count · coin_count · share_count · thumbnail_url · posted_at · category · author_name · author_id · author_url · platform · tags
commentsurl—默认 20 · 最多 50同步$0.56 / 千次id · text · like_count · reply_count · author_name · author_id · author_url · posted_at · video_id · platform
danmakuurl——同步$0.56 / 千次id · text · video_id · video_time · video_time_seconds · mode · color · pool · sent_at · platform
subtitlesurl——同步$0.56 / 千次video_id · title · author_name · duration_seconds · language · text · platform · segments

B站 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 B站 主页或对象详情 API？

profile

使用 platform="bilibili"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 user_id、name、url、bio、avatar_url、gender 等 19 个字段。

B站 profile 的参数分别是什么意思？

user_id必填
B 站 UP 主的数字 mid，即 https://space.bilibili.com/<mid> 中的数字。将数字放入 user_id，不要把昵称、BV 号或整个主页链接填入这个参数。

哔哩哔哩开放平台说明，在用户或 UP 主授权场景中，关联开发者可能取得昵称、头像、OpenID 等基础资料。EveryInfra user_id 当前要求空间页中的数字 mid，它不是开放平台 OpenID；该来源也不证明能够绕过授权查询任意用户或取得全部账户资料。官方来源：哔哩哔哩：授权用户资料与数字 mid 的边界来源核查：

B站 特有返回字段与含义（8）
video_count
视频数。
is_vip
是否为大会员。
vip_label
会员标签。
level
用户等级（0–6）。
gender
性别。
birthday
生日。
school
学校。
verified_title
认证头衔（如「知名UP主」）。

怎么调用 B站 用户内容 API？

user_posts

使用 platform="bilibili"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、url、title、text、duration_seconds、duration_text 等 21 个字段。

B站 user_posts 的参数分别是什么意思？

user_id必填
B 站 UP 主的数字 mid，即 https://space.bilibili.com/<mid> 中的数字。将数字放入 user_id，不要把昵称、BV 号或整个主页链接填入这个参数。

哔哩哔哩开放平台提供与稿件发布、删除、查询及关联 UP 主有关的能力。EveryInfra user_posts 使用数字 mid 定位用户是自身公开契约；该来源不证明可查询任意用户的全部投稿，也不证明 category、duration 或视频排序枚举。官方来源：哔哩哔哩：UP 主稿件查询具有授权边界来源核查：

B站 特有返回字段与含义（4）
duration_text
时长的展示文本（如 12:34）。
danmaku_count
弹幕数。B站特有的互动指标，与评论数并列看活跃度。
coin_count
投币数。B站的付费级好评，比点赞含金量高。
favorite_count
收藏数。

怎么调用 B站 视频详情 API？

video

使用 platform="bilibili"、action="video" 调用“视频详情”能力；返回单个对象，主要包含 id、url、title、text、duration_seconds、duration_text 等 21 个字段。

B站 video 的参数分别是什么意思？

url必填
B 站视频完整链接，建议 https://www.bilibili.com/video/<BV号>。comments 查评论区，danmaku 查播放弹幕且当前只取第一分 P，subtitles 查语音转写；三者不是同一种文字数据。弹幕入口需要能从该路径提取 BV 号。

哔哩哔哩的 2020 年公告将 BV 号定义为包含数字和大小写字母的视频稿件标识，与原先纯数字 AV 号区分。这里只解释视频标识；本接口按上方格式接收链接，不因此承诺所有旧链接或分 P 都可解析。官方来源：哔哩哔哩：AV 号升级为 BV 号的官方公告来源核查：

B站 特有返回字段与含义（4）
duration_text
时长的展示文本（如 12:34）。
danmaku_count
弹幕数。B站特有的互动指标，与评论数并列看活跃度。
coin_count
投币数。B站的付费级好评，比点赞含金量高。
favorite_count
收藏数。

怎么调用 B站 评论 API？

comments

使用 platform="bilibili"、action="comments" 调用“评论”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、text、like_count、reply_count、author_name、author_id 等 10 个字段。

B站 comments 的参数分别是什么意思？

url必填
B 站视频完整链接，建议 https://www.bilibili.com/video/<BV号>。comments 查评论区，danmaku 查播放弹幕且当前只取第一分 P，subtitles 查语音转写；三者不是同一种文字数据。弹幕入口需要能从该路径提取 BV 号。

哔哩哔哩的 2020 年公告将 BV 号定义为包含数字和大小写字母的视频稿件标识，与原先纯数字 AV 号区分。这里只解释视频标识；本接口按上方格式接收链接，不因此承诺所有旧链接或分 P 都可解析。官方来源：哔哩哔哩：AV 号升级为 BV 号的官方公告来源核查：

B站 特有返回字段与含义（1）
video_id
视频 BV 号。

怎么调用 B站 弹幕 API？

danmaku

使用 platform="bilibili"、action="danmaku" 调用“弹幕”能力；返回列表，主要包含 id、text、video_id、video_time、video_time_seconds、mode 等 10 个字段。

B站 danmaku 的参数分别是什么意思？

url必填
B 站视频完整链接，建议 https://www.bilibili.com/video/<BV号>。comments 查评论区，danmaku 查播放弹幕且当前只取第一分 P，subtitles 查语音转写；三者不是同一种文字数据。弹幕入口需要能从该路径提取 BV 号。

哔哩哔哩的 2020 年公告将 BV 号定义为包含数字和大小写字母的视频稿件标识，与原先纯数字 AV 号区分。这里只解释视频标识；本接口按上方格式接收链接，不因此承诺所有旧链接或分 P 都可解析。官方来源：哔哩哔哩：AV 号升级为 BV 号的官方公告来源核查：

B站 特有返回字段与含义（7）
video_id
视频 BV 号。
video_time
视频内时间点。
video_time_seconds
视频内时间点，秒。
sent_at
弹幕发送时间。
mode
弹幕模式（滚动/顶部/底部）。
pool
弹幕池。
color
弹幕颜色。

怎么调用 B站 字幕 API？

subtitles

使用 platform="bilibili"、action="subtitles" 调用“字幕”能力；返回单个对象，主要包含 video_id、title、author_name、duration_seconds、language、text 等 8 个字段。

B站 subtitles 的参数分别是什么意思？

url必填
B 站视频完整链接，建议 https://www.bilibili.com/video/<BV号>。comments 查评论区，danmaku 查播放弹幕且当前只取第一分 P，subtitles 查语音转写；三者不是同一种文字数据。弹幕入口需要能从该路径提取 BV 号。

哔哩哔哩的 2020 年公告将 BV 号定义为包含数字和大小写字母的视频稿件标识，与原先纯数字 AV 号区分。这里只解释视频标识；本接口按上方格式接收链接，不因此承诺所有旧链接或分 P 都可解析。官方来源：哔哩哔哩：AV 号升级为 BV 号的官方公告来源核查：

B站 特有返回字段与含义（1）
video_id
视频 BV 号。
B站 search 调用流程一次 B站 search 调用的全过程：向 POST /api/v1/social 发送 platform="bilibili"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、duration_seconds 等字段；返回列表，单次最多 50 条，计费 $0.56 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "bilibili"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表idurltitletextduration_seconds
一次 B站 search 调用的全过程：向 POST /api/v1/social 发送 platform="bilibili"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、duration_seconds 等字段；返回列表，单次最多 50 条，计费 $0.56 / 千次，失败与空结果不计费。

B站 原始字段名

EveryInfra 统一字段名

左边是 B站 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

B站 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 13 个字段名只在 B站 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • duration_text
  • danmaku_count
  • coin_count
  • level
  • verified_title
  • vip_label
  • birthday
  • school
  • video_time
  • video_time_seconds
  • mode
  • pool
  • sent_at

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时（如纯文本帖）为 null。
text
正文内容，已去除 HTML 标签。长文可能被截断。
duration_seconds
时长，单位秒。非视频/音频内容为 null。
duration_text
时长的展示文本（如 12:34）。
view_count
浏览/播放数。null 表示不公开，不等于 0。
like_count
点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
comment_count
评论数。null 表示不公开，不等于 0。
danmaku_count
弹幕数。B站特有的互动指标，与评论数并列看活跃度。
favorite_count
收藏数。
coin_count
投币数。B站的付费级好评，比点赞含金量高。
share_count
分享/转发数。null 表示不公开，不等于 0。
thumbnail_url
缩略图链接，分辨率低于 image_url。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
category
分类名称，取值为原平台的分类体系，未做跨平台归一。
author_name
作者昵称（显示名）。
author_id
作者在原平台的唯一 ID。
author_url
作者在原平台的主页链接。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
tags
标签数组。无标签时为空数组，不是 null。
user_id
用户在原平台的唯一 ID。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
gender
性别。
level
用户等级（0–6）。
follower_count
粉丝数。null 表示不公开，不等于 0。
following_count
关注数。null 表示不公开，不等于 0。
video_count
视频数。
is_verified
是否为平台认证账号（蓝V等）。null 表示无法判定。
verified_title
认证头衔（如「知名UP主」）。
is_vip
是否为大会员。
vip_label
会员标签。
birthday
生日。
school
学校。
reply_count
回复数，通常用于评论的子回复。null 表示不公开。
video_id
视频 BV 号。
video_time
视频内时间点。
video_time_seconds
视频内时间点，秒。
mode
弹幕模式（滚动/顶部/底部）。
color
弹幕颜色。
pool
弹幕池。
sent_at
弹幕发送时间。
language
内容语言代码（如 zh、en），由平台判定，可能不准。

当前目录另列出 recent_videos · segments，这些字段尚无逐项释义；请先核对 B站 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

按视频主题搜索；详情、评论与弹幕需要视频目标。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

bilibili_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"bilibili","action":"search","params":{"keyword":"摄影入门"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "duration_seconds": null,
  "duration_text": null,
  "view_count": null,
  "like_count": null,
  "comment_count": null,
  "danmaku_count": null,
  "favorite_count": null,
  "coin_count": null,
  "share_count": null,
  "thumbnail_url": null,
  "posted_at": null,
  "category": null,
  "author_name": null,
  "author_id": null,
  "author_url": null,
  "platform": null,
  "tags": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

按主题检索 B 站视频，分清收藏与点赞

用 search 找视频候选，再按稿件和 UP 主标识关联后续查询。

查看 search 的 sort 参数 →
  • keyword 搜视频标题或主题，不是 UP 主昵称精确查询；sort=most_liked 在本接口实际映射为收藏优先，不能解释成点赞排序。favorite_count、like_count、coin_count 分别保留。
  • id 标识视频稿件，author_id 标识 UP 主；播放、评论、弹幕、收藏和投币是不同互动，不能相加后当作独立用户数。缺失计数不补零。

用数字 mid 核对 B 站 UP 主资料

用 profile 读取账号资料，避免拿视频 BV 号查询创作者。

查看 profile 的 user_id 参数 →
  • user_id 填 space.bilibili.com/<mid> 中的数字，不填昵称、BV 号或整个主页链接；user_id、name、url 与 bio 用于核对账号。
  • level、is_vip / vip_label 与 is_verified / verified_title 分别描述账号等级、会员和认证信息，不是同一种资质；follower_count 是数量，不是粉丝名单。

整理指定 UP 主的 B 站投稿

用 user_posts 获取视频列表，将作者账号与每条投稿分别建档。

查看 user_posts 的 user_id 参数 →
  • user_id 使用 UP 主数字 mid；id、title、url、posted_at 与 author_id 对应视频和作者。不是动态、收藏夹、关注列表或全量历史归档。
  • 目录中的 category / duration 是视频分区和时长区间，不是作者分类或请求超时；这些可选筛选尚未完成逐执行路径效果验证，不保证返回结果满足全部条件。

读取单条 B 站稿件的互动与时长

用 video 查看具体稿件元数据，不把计数当成评论或弹幕正文。

查看 video 的 url 参数 →
  • url 使用 /video/<BV号> 的完整视频链接；duration_seconds 是数值秒，duration_text 是时长文本，按实际返回分别处理。
  • comment_count / danmaku_count 只有数量；需要正文时分别用 comments / danmaku，需要语音文稿时用 subtitles。此处不交付视频下载文件。

读取 B 站视频评论区，而不是播放弹幕

用 comments 收集稿件下的评论文字，保留评论与视频对应关系。

查看 comments 的 url 参数 →
  • url 指向目标 BV 视频；id、text、author_id、posted_at 与 video_id 描述评论记录，reply_count 是回复数量，并不表示已经返回全部楼中楼。
  • 评论没有视频内出现时间，不能当作弹幕时间轴；当前 sort 映射的是视频排序，不能保证评论按热度或时间顺序排列，也不承诺覆盖全部评论。

把 B 站弹幕对齐到播放时间点

用 danmaku 整理观众在视频中某一时刻出现的文字。

查看 danmaku 的 url 参数 →
  • url 必须能从 /video/<BV号> 提取稿件标识，当前只取第一分 P；video_time_seconds 是视频内偏移秒，sent_at 是发送日期，二者不能混用。
  • mode 描述滚动、顶端或底端等显示方式，pool 描述弹幕池；pool=subtitle 仍是弹幕分类，不是语音转写。返回不包含发送者身份，也不保证取得完整历史弹幕。

用 B 站语音转写制作可检索文稿

用 subtitles 取得音轨转写文字，再由调用方做摘要或检索。

查看 subtitles 的 url 参数 →
  • url 指向视频，text 是文稿，language 按实际返回读取；有分段时 segments 数组包含 start、end、text，不把叶子字段当成全文只有一个起止时间。
  • 这是语音转写，不保证是 UP 主手工校对字幕；没有文稿或分段时不能把标题、播放量当作转写成功，也不返回音视频下载直链。

B站 API 常见问题

B站 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="bilibili"、action 和 params。以 search 为例，必填 keyword，可选 sort。按视频主题搜索；详情、评论与弹幕需要视频目标。 B站 共 7 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

B站 API 怎么收费？

$0.56 / 千次，B站 全部 7 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,798 次 B站 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

B站 API 一次能返回多少条数据？

B站 有 4 个列表接口，包括 search、user_posts、comments、danmaku。其余 3 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

B站 API 返回哪些字段？

当前目录为 search 列出 id、url、title、text、duration_seconds、duration_text 等 21 个字段名。按全站当前目录统计，13 个字段名只在 B站 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按主题检索 B 站视频，分清收藏与点赞」怎样接入 B站 API？

用 search 找视频候选，再按稿件和 UP 主标识关联后续查询。 keyword 搜视频标题或主题，不是 UP 主昵称精确查询；sort=most_liked 在本接口实际映射为收藏优先，不能解释成点赞排序。favorite_count、like_count、coin_count 分别保留。 id 标识视频稿件，author_id 标识 UP 主；播放、评论、弹幕、收藏和投币是不同互动，不能相加后当作独立用户数。缺失计数不补零。

「用数字 mid 核对 B 站 UP 主资料」怎样接入 B站 API？

用 profile 读取账号资料，避免拿视频 BV 号查询创作者。 user_id 填 space.bilibili.com/<mid> 中的数字，不填昵称、BV 号或整个主页链接；user_id、name、url 与 bio 用于核对账号。 level、is_vip / vip_label 与 is_verified / verified_title 分别描述账号等级、会员和认证信息，不是同一种资质；follower_count 是数量，不是粉丝名单。

「整理指定 UP 主的 B 站投稿」怎样接入 B站 API？

用 user_posts 获取视频列表，将作者账号与每条投稿分别建档。 user_id 使用 UP 主数字 mid；id、title、url、posted_at 与 author_id 对应视频和作者。不是动态、收藏夹、关注列表或全量历史归档。 目录中的 category / duration 是视频分区和时长区间，不是作者分类或请求超时；这些可选筛选尚未完成逐执行路径效果验证，不保证返回结果满足全部条件。

「读取单条 B 站稿件的互动与时长」怎样接入 B站 API？

用 video 查看具体稿件元数据，不把计数当成评论或弹幕正文。 url 使用 /video/<BV号> 的完整视频链接；duration_seconds 是数值秒，duration_text 是时长文本，按实际返回分别处理。 comment_count / danmaku_count 只有数量；需要正文时分别用 comments / danmaku，需要语音文稿时用 subtitles。此处不交付视频下载文件。

可以先免费试用 B站 API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 B站 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 7 个能力。无需信用卡。

更多社交内容 API

Behance APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 APIDribbble API全部 89 平台 ↗

开始调用 B站 API

加微信领 $1 免费额度，先选一个 B站 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始