哔哩哔哩视频详情 API (V2)
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…
检索由BVID标识的哔哩哔哩视频详情。用于查找已知视频以进行内容审核、编目或后续互动分析。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | API 的访问令牌。 |
bvid | query | string | 是 | - | 哔哩哔哩 视频 ID (BVID)。 |
代码示例
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/bilibili/get-video-detail/v2?token=YOUR_API_KEY&bvid=VALUE'text
我想使用 JustOneAPI 提供的“视频详情 (V2)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/bilibili/get-video-detail/v2?token=YOUR_API_KEY&bvid=VALUE
接口地址: BASE_URL + /api/bilibili/get-video-detail/v2?token=YOUR_API_KEY&bvid=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/bilibili/video-details-v2-zh.json
请求参数说明:
- token (query): API 的访问令牌。 (必填)
- bvid (query): 哔哩哔哩 视频 ID (BVID)。 (必填)
返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。
响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败,请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 账户余额不足
- 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。
请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。python
import requests
BASE_URL = "https://api.justoneapi.com" # 由 OpenAPI servers 提供
url = BASE_URL + "/api/bilibili/get-video-detail/v2?token=YOUR_API_KEY&bvid=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
content_type = response.headers.get("content-type", "").lower()
if "json" in content_type:
try:
print(response.json())
except ValueError:
print(response.text)
elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
print(response.text)
else:
with open("response.bin", "wb") as output:
output.write(response.content)
print(f"Saved {len(response.content)} bytes to response.bin")js
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/bilibili/get-video-detail/v2?token=YOUR_API_KEY&bvid=VALUE";
const response = await fetch(url, {
method: "GET",
signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
const contentType = (response.headers.get("content-type") || "").toLowerCase();
const mediaType = contentType.split(";", 1)[0].trim();
const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
if (textual) {
const responseText = new TextDecoder().decode(responseBytes);
let data = responseText;
if (contentType.includes("json")) {
try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
}
console.log(data);
} else {
console.log(`Received ${responseBytes.byteLength} binary bytes`);
}
}java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
final String url = BASE_URL + "/api/bilibili/get-video-detail/v2?token=YOUR_API_KEY&bvid=VALUE";
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
HttpRequest.Builder builder = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(120))
.method("GET", HttpRequest.BodyPublishers.noBody());
HttpRequest request = builder.build();
HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
System.out.println(response.statusCode());
String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
String mediaType = contentType.split(";", 2)[0].trim();
if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
} else {
Files.write(Path.of("response.bin"), response.body());
System.out.println("Saved " + response.body().length + " bytes to response.bin");
}
}
}go
package main
import (
"fmt"
"io"
"os"
"strings"
"net/http"
"time"
)
const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供
func main() {
client := &http.Client{Timeout: 120 * time.Second}
url := BASE_URL + "/api/bilibili/get-video-detail/v2?token=YOUR_API_KEY&bvid=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
fmt.Println(resp.StatusCode)
bodyBytes, _ := io.ReadAll(resp.Body)
contentType := strings.ToLower(resp.Header.Get("Content-Type"))
mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
fmt.Println(string(bodyBytes))
} else {
os.WriteFile("response.bin", bodyBytes, 0600)
fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
}
}php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/bilibili/get-video-detail/v2?token=YOUR_API_KEY&bvid=VALUE';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
echo $response;
} else {
file_put_contents('response.bin', $response);
echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}返回字段
业务成功时(code = 0)的主要返回字段。
视频基本信息19 个字段
data.videoData
所查询的哔哩哔哩稿件详情。
| 字段 | 类型 | 说明 |
|---|---|---|
bvid | string | 哔哩哔哩视频 ID(BV 号)。 |
aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
videos | integer | 本稿件的分 P 数量。 |
tid | integer | 内容分区的数字 ID。 |
tid_v2 | integer | 第二套分区分类中的数字 ID。 |
tname | string | 内容分区名称。 |
tname_v2 | string | 第二套分区分类中的分区名称。 |
pic | string | 视频封面图片地址。 |
title | string | 视频标题。 |
pubdate | integer | 发布时间,Unix 时间戳,单位为秒。 |
ctime | integer | 稿件创建时间,Unix 时间戳,单位为秒。 |
desc | string | 视频的纯文本简介。 |
desc_v2 | array | null | 结构化简介条目,无可用数据时可为 null。 |
desc_v2[] | object | - |
desc_v2[].raw_text | string | 该简介条目的文本。 |
desc_v2[].type | integer | 该简介条目的数字类型。 |
desc_v2[].biz_id | integer | 该简介条目关联的引用 ID。 |
state | integer | 哔哩哔哩记录的稿件状态码。 |
duration | integer | 稿件总时长,单位为秒。多 P 稿件包含所有分 P 的时长。 |
分 P 与导航22 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
bvid | string | 哔哩哔哩视频 ID(BV 号)。 |
cid | integer | 当前分 P 的内容 ID。 |
p | integer | 当前分 P 序号,从 1 开始。 |
cidMap | object | 视频及分 P ID 的查找表,键名随所查询的视频变化。 |
availableVideoList | array | 当前页面可切换的视频条目,范围可能超出所查询视频的分 P。 |
availableVideoList[] | object | - |
availableVideoList[].aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
availableVideoList[].bvid | string | 哔哩哔哩视频 ID(BV 号)。 |
availableVideoList[].cid | integer | 列表视频关联的内容 ID。 |
availableVideoList[].title | string | 视频标题。 |
availableVideoList[].cover | string | 视频封面图片地址。 |
availableVideoList[].upid | integer | 投稿者的哔哩哔哩数字用户 ID。 |
availableVideoList[].is_lesson_video | boolean | 哔哩哔哩是否将此条目标记为课程视频。 |
availableVideoList[].redirect_url | string | 打开此列表视频的跳转地址。 |
availableVideoList[].list | array | 此视频条目中可跳转的子条目。 |
availableVideoList[].list[] | object | - |
availableVideoList[].list[].aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
availableVideoList[].list[].bvid | string | 哔哩哔哩视频 ID(BV 号)。 |
availableVideoList[].list[].cid | integer | 当前分 P 的内容 ID。 |
availableVideoList[].list[].p | integer | 分 P 序号,从 1 开始。 |
availableVideoList[].list[].title | string | 当前分 P 的显示标题。 |
分 P 详情12 个字段
data.videoData.pages[]
此稿件的各个分 P。
| 字段 | 类型 | 说明 |
|---|---|---|
cid | integer | 当前分 P 的内容 ID。 |
page | integer | 分 P 序号,从 1 开始。 |
part | string | 当前分 P 的显示标题。 |
duration | integer | 当前分 P 的时长,单位为秒。 |
first_frame | string | 当前分 P 的首帧图片地址。 |
ctime | integer | 分 P 创建时间,Unix 时间戳,单位为秒。 |
asr_language | string | 与此分 P 自动语音识别关联的语言代码。 |
weblink | string | 此分 P 关联的网页链接,存在时可用。 |
dimension | object | 视频画面尺寸和旋转信息。 |
dimension.width | integer | 视频画面宽度,单位为像素。 |
dimension.height | integer | 视频画面高度,单位为像素。 |
dimension.rotate | integer | 视频画面旋转角度,单位为度。 |
互动统计11 个字段
data.videoData.stat
此稿件的互动统计。
| 字段 | 类型 | 说明 |
|---|---|---|
aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
view | integer | 哔哩哔哩返回的播放量。 |
danmaku | integer | 哔哩哔哩返回的弹幕数。 |
reply | integer | 哔哩哔哩返回的评论数。 |
favorite | integer | 哔哩哔哩返回的收藏数。 |
coin | integer | 哔哩哔哩返回的投币数。 |
share | integer | 哔哩哔哩返回的分享数。 |
like | integer | 哔哩哔哩返回的点赞数。 |
dislike | integer | 哔哩哔哩返回的点踩数。 |
now_rank | integer | 哔哩哔哩返回的当前排名值。 |
his_rank | integer | 哔哩哔哩返回的历史排名值。 |
作者与合作成员12 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
staffData | array | 视频页面返回的合作成员列表,可能为空。 |
upData | object | 投稿者的公开资料。 |
upData.mid | string | 以文本表示的哔哩哔哩用户 ID。 |
upData.name | string | 投稿者显示名称。 |
upData.face | string | 投稿者头像地址。 |
upData.fans | integer | 返回的投稿者粉丝数。 |
upData.sign | string | 公开资料中的个性签名。 |
upData.archiveCount | integer | 返回的投稿者稿件数。 |
upData.is_senior_member | integer | 资深会员数字标记。 |
upData.official_verify | object | 投稿者认证信息。 |
upData.official_verify.type | integer | 认证的数字类型。 |
upData.official_verify.desc | string | 个人资料展示的认证说明。 |
作者基本信息3 个字段
data.videoData.owner
稿件作者的公开信息。
| 字段 | 类型 | 说明 |
|---|---|---|
mid | integer | 哔哩哔哩用户的数字 ID。 |
name | string | 投稿者显示名称。 |
face | string | 投稿者头像地址。 |
版权与观看权限28 个字段
data.videoData
| 字段 | 类型 | 说明 |
|---|---|---|
copyright | integer | 哔哩哔哩为此稿件记录的数字版权分类。 |
rights | object | 哔哩哔哩返回的观看与互动相关数字标记。 |
rights.elec | integer | 充电支持的数字标记。 |
rights.download | integer | 下载的数字标记。 |
rights.movie | integer | 电影内容数字标记。 |
rights.pay | integer | 付费访问的数字标记。 |
rights.no_reprint | integer | 平台禁止转载设置的数字标记。 |
rights.autoplay | integer | 自动播放的数字标记。 |
rights.ugc_pay | integer | 创作者内容付费访问的数字标记。 |
rights.is_cooperation | integer | 联合投稿数字标记。 |
rights.ugc_pay_preview | integer | 付费创作者内容的试看数字标记。 |
rights.no_background | integer | 限制后台播放的数字标记。 |
rights.clean_mode | integer | 清爽模式数字标记。 |
rights.is_stein_gate | integer | 互动视频数字标记。 |
rights.is_360 | integer | 360 度视频数字标记。 |
rights.no_share | integer | 限制分享的数字标记。 |
rights.arc_pay | integer | 此稿件付费访问的数字标记。 |
rights.free_watch | integer | 免费观看的数字标记。 |
argue_info | object | 如平台返回,表示与此视频关联的提示信息。 |
argue_info.argue_msg | string | 平台提示文字。 |
argue_info.argue_type | integer | 平台提示的数字类型。 |
argue_info.argue_link | string | 与平台提示关联的链接。 |
is_chargeable_season | boolean | 哔哩哔哩是否将合集标记为付费。 |
is_upower_exclusive | boolean | 此视频是否标记为充电档位专属。 |
is_upower_play | boolean | 当前页面上下文是否可以播放充电专属视频。 |
is_upower_preview | boolean | 哔哩哔哩是否将此视频标记为可在当前页面上下文中试看。 |
is_upower_exclusive_with_qa | boolean | 哔哩哔哩是否将此充电专属视频标记为关联问答。 |
teenage_mode | integer | 此视频的青少年模式数字标记。 |
充电与互动限制14 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
elecFullInfo | object | 视频页面返回的充电和支持信息。 |
elecFullInfo.show_info | object | 充电信息展示设置。 |
elecFullInfo.show_info.show | boolean | 页面是否显示充电信息。 |
elecFullInfo.show_info.state | integer | 充电信息展示的状态码。 |
elecFullInfo.show_info.title | string | 充电信息的显示标题。 |
elecFullInfo.show_info.high_level | object | 充电档位的展示信息。 |
elecFullInfo.show_info.high_level.title | string | 充电档位的显示标题。 |
elecFullInfo.show_info.high_level.sub_title | string | 充电档位的显示副标题。 |
elecFullInfo.show_info.high_level.intro | string | 充电档位的展示简介。 |
emergencyBan | object | 当前页面上下文中的互动操作限制。 |
emergencyBan.no_like | boolean | 此页面是否限制点赞。 |
emergencyBan.no_coin | boolean | 此页面是否限制投币。 |
emergencyBan.no_fav | boolean | 此页面是否限制收藏。 |
emergencyBan.no_share | boolean | 此页面是否限制分享。 |
稿件所属合集93 个字段
data.videoData.ugc_season
此稿件所在的创作者合集,存在时可用。
| 字段 | 类型 | 说明 |
|---|---|---|
id | integer | 合集的数字 ID。 |
title | string | 合集标题。 |
cover | string | 合集封面图片地址。 |
mid | integer | 投稿者的哔哩哔哩数字用户 ID。 |
intro | string | 合集简介文本。 |
ep_count | integer | 返回的合集剧集数。 |
season_type | integer | 合集的数字类型。 |
is_pay_season | boolean | 哔哩哔哩是否将此合集标记为付费。 |
stat | object | 此合集的互动统计。 |
stat.season_id | integer | 合集的数字 ID。 |
stat.view | integer | 哔哩哔哩返回的播放量。 |
stat.danmaku | integer | 哔哩哔哩返回的弹幕数。 |
stat.reply | integer | 哔哩哔哩返回的评论数。 |
stat.fav | integer | 哔哩哔哩返回的收藏数。 |
stat.coin | integer | 哔哩哔哩返回的投币数。 |
stat.share | integer | 哔哩哔哩返回的分享数。 |
stat.like | integer | 哔哩哔哩返回的点赞数。 |
stat.now_rank | integer | 哔哩哔哩返回的当前排名值。 |
stat.his_rank | integer | 哔哩哔哩返回的历史排名值。 |
sections | array | 此合集下的分组。 |
sections[] | object | - |
sections[].id | integer | 合集分组的数字 ID。 |
sections[].title | string | 合集分组标题。 |
sections[].season_id | integer | 合集的数字 ID。 |
sections[].type | integer | 该合集分组的数字类型。 |
sections[].episodes | array | 此合集中该分组的视频列表。 |
sections[].episodes[] | object | - |
sections[].episodes[].id | integer | 合集剧集的数字 ID。 |
sections[].episodes[].aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
sections[].episodes[].bvid | string | 哔哩哔哩视频 ID(BV 号)。 |
sections[].episodes[].cid | integer | 合集剧集关联的内容 ID。 |
sections[].episodes[].title | string | 合集剧集标题。 |
sections[].episodes[].season_id | integer | 合集的数字 ID。 |
sections[].episodes[].section_id | integer | 合集分组的数字 ID。 |
sections[].episodes[].page | object | 剧集附带的分 P 元数据。 |
sections[].episodes[].page.cid | integer | 当前分 P 的内容 ID。 |
sections[].episodes[].page.page | integer | 分 P 序号,从 1 开始。 |
sections[].episodes[].page.part | string | 当前分 P 的显示标题。 |
sections[].episodes[].page.duration | integer | 当前分 P 的时长,单位为秒。 |
sections[].episodes[].page.weblink | string | 此分 P 关联的网页链接,存在时可用。 |
sections[].episodes[].page.dimension | object | 视频画面尺寸和旋转信息。 |
sections[].episodes[].page.dimension.width | integer | 视频画面宽度,单位为像素。 |
sections[].episodes[].page.dimension.height | integer | 视频画面高度,单位为像素。 |
sections[].episodes[].page.dimension.rotate | integer | 视频画面旋转角度,单位为度。 |
sections[].episodes[].pages | array | 此剧集返回的分 P。 |
sections[].episodes[].pages[] | object | - |
sections[].episodes[].pages[].cid | integer | 当前分 P 的内容 ID。 |
sections[].episodes[].pages[].page | integer | 分 P 序号,从 1 开始。 |
sections[].episodes[].pages[].part | string | 当前分 P 的显示标题。 |
sections[].episodes[].pages[].duration | integer | 当前分 P 的时长,单位为秒。 |
sections[].episodes[].pages[].weblink | string | 此分 P 关联的网页链接,存在时可用。 |
sections[].episodes[].pages[].dimension | object | 视频画面尺寸和旋转信息。 |
sections[].episodes[].pages[].dimension.width | integer | 视频画面宽度,单位为像素。 |
sections[].episodes[].pages[].dimension.height | integer | 视频画面高度,单位为像素。 |
sections[].episodes[].pages[].dimension.rotate | integer | 视频画面旋转角度,单位为度。 |
sections[].episodes[].arc | object | 剧集附带的稿件摘要。 |
sections[].episodes[].arc.aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
sections[].episodes[].arc.videos | integer | 本稿件的分 P 数量。 |
sections[].episodes[].arc.type_id | integer | 内容分区的数字 ID。 |
sections[].episodes[].arc.type_name | string | 内容分区名称。 |
sections[].episodes[].arc.type_id_v2 | integer | 第二套分区分类中的数字 ID。 |
sections[].episodes[].arc.type_name_v2 | string | 第二套分区分类中的分区名称。 |
sections[].episodes[].arc.copyright | integer | 哔哩哔哩为此稿件记录的数字版权分类。 |
sections[].episodes[].arc.pic | string | 视频封面图片地址。 |
sections[].episodes[].arc.title | string | 视频标题。 |
sections[].episodes[].arc.pubdate | integer | 发布时间,Unix 时间戳,单位为秒。 |
sections[].episodes[].arc.ctime | integer | 稿件创建时间,Unix 时间戳,单位为秒。 |
sections[].episodes[].arc.desc | string | 视频的纯文本简介。 |
sections[].episodes[].arc.state | integer | 哔哩哔哩记录的稿件状态码。 |
sections[].episodes[].arc.duration | integer | 稿件总时长,单位为秒。多 P 稿件包含所有分 P 的时长。 |
sections[].episodes[].arc.author | object | 稿件作者的公开信息。 |
sections[].episodes[].arc.author.mid | integer | 哔哩哔哩用户的数字 ID。 |
sections[].episodes[].arc.author.name | string | 投稿者显示名称。 |
sections[].episodes[].arc.author.face | string | 投稿者头像地址。 |
sections[].episodes[].arc.stat | object | 此稿件的互动统计。 |
sections[].episodes[].arc.stat.aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
sections[].episodes[].arc.stat.view | integer | 哔哩哔哩返回的播放量。 |
sections[].episodes[].arc.stat.danmaku | integer | 哔哩哔哩返回的弹幕数。 |
sections[].episodes[].arc.stat.reply | integer | 哔哩哔哩返回的评论数。 |
sections[].episodes[].arc.stat.fav | integer | 哔哩哔哩返回的收藏数。 |
sections[].episodes[].arc.stat.coin | integer | 哔哩哔哩返回的投币数。 |
sections[].episodes[].arc.stat.share | integer | 哔哩哔哩返回的分享数。 |
sections[].episodes[].arc.stat.like | integer | 哔哩哔哩返回的点赞数。 |
sections[].episodes[].arc.stat.dislike | integer | 哔哩哔哩返回的点踩数。 |
sections[].episodes[].arc.stat.now_rank | integer | 哔哩哔哩返回的当前排名值。 |
sections[].episodes[].arc.stat.his_rank | integer | 哔哩哔哩返回的历史排名值。 |
sections[].episodes[].arc.dimension | object | 视频画面尺寸和旋转信息。 |
sections[].episodes[].arc.dimension.width | integer | 视频画面宽度,单位为像素。 |
sections[].episodes[].arc.dimension.height | integer | 视频画面高度,单位为像素。 |
sections[].episodes[].arc.dimension.rotate | integer | 视频画面旋转角度,单位为度。 |
sections[].episodes[].arc.is_chargeable_season | boolean | 哔哩哔哩是否将合集标记为付费。 |
sections[].episodes[].arc.is_blooper | boolean | 哔哩哔哩是否将此视频标记为花絮。 |
sections[].episodes[].arc.is_lesson_video | integer | 课程视频数字标记。 |
页面合集95 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
sectionsInfo | object | 视频页面返回的合集信息,存在时可用。 |
sectionsInfo.id | integer | 合集的数字 ID。 |
sectionsInfo.title | string | 合集标题。 |
sectionsInfo.cover | string | 合集封面图片地址。 |
sectionsInfo.mid | integer | 投稿者的哔哩哔哩数字用户 ID。 |
sectionsInfo.intro | string | 合集简介文本。 |
sectionsInfo.ep_count | integer | 返回的合集剧集数。 |
sectionsInfo.season_type | integer | 合集的数字类型。 |
sectionsInfo.is_pay_season | boolean | 哔哩哔哩是否将此合集标记为付费。 |
sectionsInfo.stat | object | 此合集的互动统计。 |
sectionsInfo.stat.season_id | integer | 合集的数字 ID。 |
sectionsInfo.stat.view | integer | 哔哩哔哩返回的播放量。 |
sectionsInfo.stat.danmaku | integer | 哔哩哔哩返回的弹幕数。 |
sectionsInfo.stat.reply | integer | 哔哩哔哩返回的评论数。 |
sectionsInfo.stat.fav | integer | 哔哩哔哩返回的收藏数。 |
sectionsInfo.stat.coin | integer | 哔哩哔哩返回的投币数。 |
sectionsInfo.stat.share | integer | 哔哩哔哩返回的分享数。 |
sectionsInfo.stat.like | integer | 哔哩哔哩返回的点赞数。 |
sectionsInfo.stat.now_rank | integer | 哔哩哔哩返回的当前排名值。 |
sectionsInfo.stat.his_rank | integer | 哔哩哔哩返回的历史排名值。 |
sectionsInfo.sections | array | 此合集下的分组。 |
sectionsInfo.sections[] | object | - |
sectionsInfo.sections[].id | integer | 合集分组的数字 ID。 |
sectionsInfo.sections[].title | string | 合集分组标题。 |
sectionsInfo.sections[].season_id | integer | 合集的数字 ID。 |
sectionsInfo.sections[].type | integer | 该合集分组的数字类型。 |
sectionsInfo.sections[].episodes | array | 此合集中该分组的视频列表。 |
sectionsInfo.sections[].episodes[] | object | - |
sectionsInfo.sections[].episodes[].id | integer | 合集剧集的数字 ID。 |
sectionsInfo.sections[].episodes[].aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
sectionsInfo.sections[].episodes[].bvid | string | 哔哩哔哩视频 ID(BV 号)。 |
sectionsInfo.sections[].episodes[].cid | integer | 合集剧集关联的内容 ID。 |
sectionsInfo.sections[].episodes[].title | string | 合集剧集标题。 |
sectionsInfo.sections[].episodes[].season_id | integer | 合集的数字 ID。 |
sectionsInfo.sections[].episodes[].section_id | integer | 合集分组的数字 ID。 |
sectionsInfo.sections[].episodes[].page | object | 剧集附带的分 P 元数据。 |
sectionsInfo.sections[].episodes[].page.cid | integer | 当前分 P 的内容 ID。 |
sectionsInfo.sections[].episodes[].page.page | integer | 分 P 序号,从 1 开始。 |
sectionsInfo.sections[].episodes[].page.part | string | 当前分 P 的显示标题。 |
sectionsInfo.sections[].episodes[].page.duration | integer | 当前分 P 的时长,单位为秒。 |
sectionsInfo.sections[].episodes[].page.weblink | string | 此分 P 关联的网页链接,存在时可用。 |
sectionsInfo.sections[].episodes[].page.dimension | object | 视频画面尺寸和旋转信息。 |
sectionsInfo.sections[].episodes[].page.dimension.width | integer | 视频画面宽度,单位为像素。 |
sectionsInfo.sections[].episodes[].page.dimension.height | integer | 视频画面高度,单位为像素。 |
sectionsInfo.sections[].episodes[].page.dimension.rotate | integer | 视频画面旋转角度,单位为度。 |
sectionsInfo.sections[].episodes[].pages | array | 此剧集返回的分 P。 |
sectionsInfo.sections[].episodes[].pages[] | object | - |
sectionsInfo.sections[].episodes[].pages[].cid | integer | 当前分 P 的内容 ID。 |
sectionsInfo.sections[].episodes[].pages[].page | integer | 分 P 序号,从 1 开始。 |
sectionsInfo.sections[].episodes[].pages[].part | string | 当前分 P 的显示标题。 |
sectionsInfo.sections[].episodes[].pages[].duration | integer | 当前分 P 的时长,单位为秒。 |
sectionsInfo.sections[].episodes[].pages[].weblink | string | 此分 P 关联的网页链接,存在时可用。 |
sectionsInfo.sections[].episodes[].pages[].dimension | object | 视频画面尺寸和旋转信息。 |
sectionsInfo.sections[].episodes[].pages[].dimension.width | integer | 视频画面宽度,单位为像素。 |
sectionsInfo.sections[].episodes[].pages[].dimension.height | integer | 视频画面高度,单位为像素。 |
sectionsInfo.sections[].episodes[].pages[].dimension.rotate | integer | 视频画面旋转角度,单位为度。 |
sectionsInfo.sections[].episodes[].arc | object | 剧集附带的稿件摘要。 |
sectionsInfo.sections[].episodes[].arc.aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
sectionsInfo.sections[].episodes[].arc.videos | integer | 本稿件的分 P 数量。 |
sectionsInfo.sections[].episodes[].arc.type_id | integer | 内容分区的数字 ID。 |
sectionsInfo.sections[].episodes[].arc.type_name | string | 内容分区名称。 |
sectionsInfo.sections[].episodes[].arc.type_id_v2 | integer | 第二套分区分类中的数字 ID。 |
sectionsInfo.sections[].episodes[].arc.type_name_v2 | string | 第二套分区分类中的分区名称。 |
sectionsInfo.sections[].episodes[].arc.copyright | integer | 哔哩哔哩为此稿件记录的数字版权分类。 |
sectionsInfo.sections[].episodes[].arc.pic | string | 视频封面图片地址。 |
sectionsInfo.sections[].episodes[].arc.title | string | 视频标题。 |
sectionsInfo.sections[].episodes[].arc.pubdate | integer | 发布时间,Unix 时间戳,单位为秒。 |
sectionsInfo.sections[].episodes[].arc.ctime | integer | 稿件创建时间,Unix 时间戳,单位为秒。 |
sectionsInfo.sections[].episodes[].arc.desc | string | 视频的纯文本简介。 |
sectionsInfo.sections[].episodes[].arc.state | integer | 哔哩哔哩记录的稿件状态码。 |
sectionsInfo.sections[].episodes[].arc.duration | integer | 稿件总时长,单位为秒。多 P 稿件包含所有分 P 的时长。 |
sectionsInfo.sections[].episodes[].arc.author | object | 稿件作者的公开信息。 |
sectionsInfo.sections[].episodes[].arc.author.mid | integer | 哔哩哔哩用户的数字 ID。 |
sectionsInfo.sections[].episodes[].arc.author.name | string | 投稿者显示名称。 |
sectionsInfo.sections[].episodes[].arc.author.face | string | 投稿者头像地址。 |
sectionsInfo.sections[].episodes[].arc.stat | object | 此稿件的互动统计。 |
sectionsInfo.sections[].episodes[].arc.stat.aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
sectionsInfo.sections[].episodes[].arc.stat.view | integer | 哔哩哔哩返回的播放量。 |
sectionsInfo.sections[].episodes[].arc.stat.danmaku | integer | 哔哩哔哩返回的弹幕数。 |
sectionsInfo.sections[].episodes[].arc.stat.reply | integer | 哔哩哔哩返回的评论数。 |
sectionsInfo.sections[].episodes[].arc.stat.fav | integer | 哔哩哔哩返回的收藏数。 |
sectionsInfo.sections[].episodes[].arc.stat.coin | integer | 哔哩哔哩返回的投币数。 |
sectionsInfo.sections[].episodes[].arc.stat.share | integer | 哔哩哔哩返回的分享数。 |
sectionsInfo.sections[].episodes[].arc.stat.like | integer | 哔哩哔哩返回的点赞数。 |
sectionsInfo.sections[].episodes[].arc.stat.dislike | integer | 哔哩哔哩返回的点踩数。 |
sectionsInfo.sections[].episodes[].arc.stat.now_rank | integer | 哔哩哔哩返回的当前排名值。 |
sectionsInfo.sections[].episodes[].arc.stat.his_rank | integer | 哔哩哔哩返回的历史排名值。 |
sectionsInfo.sections[].episodes[].arc.dimension | object | 视频画面尺寸和旋转信息。 |
sectionsInfo.sections[].episodes[].arc.dimension.width | integer | 视频画面宽度,单位为像素。 |
sectionsInfo.sections[].episodes[].arc.dimension.height | integer | 视频画面高度,单位为像素。 |
sectionsInfo.sections[].episodes[].arc.dimension.rotate | integer | 视频画面旋转角度,单位为度。 |
sectionsInfo.sections[].episodes[].arc.is_chargeable_season | boolean | 哔哩哔哩是否将合集标记为付费。 |
sectionsInfo.sections[].episodes[].arc.is_blooper | boolean | 哔哩哔哩是否将此视频标记为花絮。 |
sectionsInfo.sections[].episodes[].arc.is_lesson_video | integer | 课程视频数字标记。 |
sectionsFavState | boolean | 当前页面上下文中的合集收藏状态。 |
标签与相关视频27 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
tags | array | 视频页面展示的标签。 |
tags[] | object | - |
tags[].tag_id | integer | 标签的数字 ID。 |
tags[].tag_name | string | 哔哩哔哩展示的标签名称。 |
tags[].tag_type | string | 标签类型标识。 |
tags[].music_id | string | 标签关联的音乐 ID,存在时可用。 |
tags[].jump_url | string | 标签关联的跳转地址。 |
tags[].showDetail | boolean | 标签是否标记为展示详情。 |
tags[].showReport | boolean | 标签是否标记为可举报。 |
related | array | 视频页面返回的相关视频。 |
related[] | object | - |
related[].aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
related[].cid | integer | 相关视频关联的内容 ID。 |
related[].bvid | string | 哔哩哔哩视频 ID(BV 号)。 |
related[].duration | integer | 相关视频时长,单位为秒。 |
related[].pic | string | 视频封面图片地址。 |
related[].title | string | 视频标题。 |
related[].owner | object | 稿件作者的公开信息。 |
related[].owner.mid | integer | 哔哩哔哩用户的数字 ID。 |
related[].owner.name | string | 投稿者显示名称。 |
related[].stat | object | 相关视频的互动统计。 |
related[].stat.view | integer | 哔哩哔哩返回的播放量。 |
related[].stat.danmaku | integer | 哔哩哔哩返回的弹幕数。 |
related[].season_id | integer | 此稿件关联的合集 ID。 |
related[].season_type | integer | 合集的数字类型。 |
related[].redirect_url | string | 打开此相关视频的跳转地址。 |
related[].redirected_url | string | 此相关视频的已解析跳转地址。 |
播放格式与时长52 个字段
data.dash_info
当前分 P 的播放元数据。存在观看限制时,此对象可能没有 DASH 流信息。
| 字段 | 类型 | 说明 |
|---|---|---|
quality | integer | 返回的播放元数据中的清晰度数字编码。 |
format | string | 当前分 P 返回的播放格式标识。 |
timelength | integer | 当前分 P 的播放时长,单位为毫秒。 |
accept_format | string | 播放器接受的播放格式标识,以文本表示。 |
accept_description | array | 播放器接受的清晰度选项的显示标签列表。 |
accept_quality | array | 播放器接受的清晰度数字编码列表。 |
video_codecid | integer | 视频播放使用的编解码器数字 ID。 |
support_formats | array | 可用播放清晰度与格式选项的详情。 |
support_formats[] | object | - |
support_formats[].quality | integer | 此播放选项的清晰度数字编码。 |
support_formats[].format | string | 此播放选项的格式标识。 |
support_formats[].new_description | string | 此播放选项展示的说明。 |
support_formats[].display_desc | string | 此播放选项的简短显示标签。 |
support_formats[].superscript | string | 此播放选项的补充显示标签。 |
support_formats[].codecs | array | null | 此格式的编解码器标识列表,未提供列表时可为 null。 |
support_formats[].can_watch_qn_reason | integer | 平台返回的清晰度可观看状态原因码。 |
support_formats[].limit_watch_reason | integer | 平台返回的清晰度观看限制原因码。 |
dash | object | 响应包含 DASH 流时返回的元数据。 |
dash.duration | integer | 当前分 P 的 DASH 时长,单位为秒。 |
dash.minBufferTime | number | DASH 声明的最短缓冲时长,单位为秒。 |
dash.min_buffer_time | number | DASH 声明的最短缓冲时长,单位为秒。 |
dash.video | array | DASH 清单中的视频轨道版本。 |
dash.video[] | object | - |
dash.video[].id | integer | 此媒体轨道版本的数字 ID。 |
dash.video[].bandwidth | integer | 此媒体轨道版本声明的带宽,单位为比特每秒。 |
dash.video[].mimeType | string | 媒体 MIME 类型。 |
dash.video[].mime_type | string | 媒体 MIME 类型。 |
dash.video[].codecs | string | 此媒体轨道版本的编解码器标识。 |
dash.video[].codecid | integer | 此媒体轨道版本的编解码器数字 ID。 |
dash.video[].width | integer | 视频画面宽度,单位为像素。 |
dash.video[].height | integer | 视频画面高度,单位为像素。 |
dash.video[].frameRate | string | DASH 轨道版本中表示的帧率。 |
dash.video[].frame_rate | string | DASH 轨道版本中表示的帧率。 |
dash.video[].sar | string | 视频轨道版本的像素宽高比。 |
dash.audio | array | DASH 清单中的音频轨道版本。 |
dash.audio[] | object | - |
dash.audio[].id | integer | 此媒体轨道版本的数字 ID。 |
dash.audio[].bandwidth | integer | 此媒体轨道版本声明的带宽,单位为比特每秒。 |
dash.audio[].mimeType | string | 媒体 MIME 类型。 |
dash.audio[].mime_type | string | 媒体 MIME 类型。 |
dash.audio[].codecs | string | 此媒体轨道版本的编解码器标识。 |
dash.audio[].codecid | integer | 此媒体轨道版本的编解码器数字 ID。 |
dash.audio[].width | integer | 视频画面宽度,单位为像素。 |
dash.audio[].height | integer | 视频画面高度,单位为像素。 |
dash.audio[].frameRate | string | DASH 轨道版本中表示的帧率。 |
dash.audio[].frame_rate | string | DASH 轨道版本中表示的帧率。 |
dash.audio[].sar | string | 视频轨道版本的像素宽高比。 |
durl | array | 播放响应提供时返回的媒体分段列表。 |
durl[] | object | - |
durl[].order | integer | 此播放分段的顺序。 |
durl[].length | integer | 此播放分段返回的时长值。 |
durl[].size | integer | 此播放分段返回的大小值。 |
其他字段22 个字段
| 字段路径 | 类型 | 说明 |
|---|---|---|
data.videoData.dynamic | string | 与此视频关联的 B 站动态文案。 |
data.videoData.cid | integer | 当前分 P 的内容 ID。 |
data.videoData.dimension | object | 视频画面尺寸和旋转信息。 |
data.videoData.dimension.width | integer | 视频画面宽度,单位为像素。 |
data.videoData.dimension.height | integer | 视频画面高度,单位为像素。 |
data.videoData.dimension.rotate | integer | 视频画面旋转角度,单位为度。 |
data.videoData.season_id | integer | 此稿件关联的合集 ID。 |
data.videoData.is_season_display | boolean | 页面是否标记为展示合集。 |
data.videoData.is_story | boolean | 哔哩哔哩是否将此稿件标记为 Story 视频。 |
data.videoData.is_story_play | integer | Story 播放数字标记。 |
data.videoData.disable_show_up_info | boolean | 页面是否隐藏投稿者信息。 |
data.videoData.is_view_self | boolean | 当前页面是否处于投稿者查看本人视频的上下文。 |
data.videoData.subtitle | object | 视频页面返回的字幕信息。 |
data.videoData.subtitle.allow_submit | boolean | 当前页面上下文是否允许提交字幕。 |
data.videoData.subtitle.list | array | 稿件的字幕条目列表,可能为空。 |
data.videoData.honor_reply | object | 视频展示的荣誉或认可信息。 |
data.videoData.honor_reply.honor | array | 荣誉或认可条目列表。 |
data.videoData.honor_reply.honor[] | object | - |
data.videoData.honor_reply.honor[].aid | integer | 哔哩哔哩稿件的数字 ID(AV 号)。 |
data.videoData.honor_reply.honor[].type | integer | 荣誉的数字类型。 |
data.videoData.honor_reply.honor[].desc | string | 哔哩哔哩显示的荣誉说明。 |
data.error | object | 视频页面的错误信息,可能是空对象。 |
响应示例
正在加载响应示例…