Skip to content

哔哩哔哩视频详情 API (V2) ​

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

检索由BVID标识的哔哩哔哩视频详情。用于查找已知视频以进行内容审核、编目或后续互动分析。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-API 的访问令牌。
bvidquerystring是-哔哩哔哩 视频 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

所查询的哔哩哔哩稿件详情。

字段类型说明
bvidstring哔哩哔哩视频 ID(BV 号)。
aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
videosinteger本稿件的分 P 数量。
tidinteger内容分区的数字 ID。
tid_v2integer第二套分区分类中的数字 ID。
tnamestring内容分区名称。
tname_v2string第二套分区分类中的分区名称。
picstring视频封面图片地址。
titlestring视频标题。
pubdateinteger发布时间,Unix 时间戳,单位为秒。
ctimeinteger稿件创建时间,Unix 时间戳,单位为秒。
descstring视频的纯文本简介。
desc_v2array | null结构化简介条目,无可用数据时可为 null。
desc_v2[]object-
desc_v2[].raw_textstring该简介条目的文本。
desc_v2[].typeinteger该简介条目的数字类型。
desc_v2[].biz_idinteger该简介条目关联的引用 ID。
stateinteger哔哩哔哩记录的稿件状态码。
durationinteger稿件总时长,单位为秒。多 P 稿件包含所有分 P 的时长。
分 P 与导航22 个字段

data

字段类型说明
aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
bvidstring哔哩哔哩视频 ID(BV 号)。
cidinteger当前分 P 的内容 ID。
pinteger当前分 P 序号,从 1 开始。
cidMapobject视频及分 P ID 的查找表,键名随所查询的视频变化。
availableVideoListarray当前页面可切换的视频条目,范围可能超出所查询视频的分 P。
availableVideoList[]object-
availableVideoList[].aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
availableVideoList[].bvidstring哔哩哔哩视频 ID(BV 号)。
availableVideoList[].cidinteger列表视频关联的内容 ID。
availableVideoList[].titlestring视频标题。
availableVideoList[].coverstring视频封面图片地址。
availableVideoList[].upidinteger投稿者的哔哩哔哩数字用户 ID。
availableVideoList[].is_lesson_videoboolean哔哩哔哩是否将此条目标记为课程视频。
availableVideoList[].redirect_urlstring打开此列表视频的跳转地址。
availableVideoList[].listarray此视频条目中可跳转的子条目。
availableVideoList[].list[]object-
availableVideoList[].list[].aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
availableVideoList[].list[].bvidstring哔哩哔哩视频 ID(BV 号)。
availableVideoList[].list[].cidinteger当前分 P 的内容 ID。
availableVideoList[].list[].pinteger分 P 序号,从 1 开始。
availableVideoList[].list[].titlestring当前分 P 的显示标题。
分 P 详情12 个字段

data.videoData.pages[]

此稿件的各个分 P。

字段类型说明
cidinteger当前分 P 的内容 ID。
pageinteger分 P 序号,从 1 开始。
partstring当前分 P 的显示标题。
durationinteger当前分 P 的时长,单位为秒。
first_framestring当前分 P 的首帧图片地址。
ctimeinteger分 P 创建时间,Unix 时间戳,单位为秒。
asr_languagestring与此分 P 自动语音识别关联的语言代码。
weblinkstring此分 P 关联的网页链接,存在时可用。
dimensionobject视频画面尺寸和旋转信息。
dimension.widthinteger视频画面宽度,单位为像素。
dimension.heightinteger视频画面高度,单位为像素。
dimension.rotateinteger视频画面旋转角度,单位为度。
互动统计11 个字段

data.videoData.stat

此稿件的互动统计。

字段类型说明
aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
viewinteger哔哩哔哩返回的播放量。
danmakuinteger哔哩哔哩返回的弹幕数。
replyinteger哔哩哔哩返回的评论数。
favoriteinteger哔哩哔哩返回的收藏数。
coininteger哔哩哔哩返回的投币数。
shareinteger哔哩哔哩返回的分享数。
likeinteger哔哩哔哩返回的点赞数。
dislikeinteger哔哩哔哩返回的点踩数。
now_rankinteger哔哩哔哩返回的当前排名值。
his_rankinteger哔哩哔哩返回的历史排名值。
作者与合作成员12 个字段

data

字段类型说明
staffDataarray视频页面返回的合作成员列表,可能为空。
upDataobject投稿者的公开资料。
upData.midstring以文本表示的哔哩哔哩用户 ID。
upData.namestring投稿者显示名称。
upData.facestring投稿者头像地址。
upData.fansinteger返回的投稿者粉丝数。
upData.signstring公开资料中的个性签名。
upData.archiveCountinteger返回的投稿者稿件数。
upData.is_senior_memberinteger资深会员数字标记。
upData.official_verifyobject投稿者认证信息。
upData.official_verify.typeinteger认证的数字类型。
upData.official_verify.descstring个人资料展示的认证说明。
作者基本信息3 个字段

data.videoData.owner

稿件作者的公开信息。

字段类型说明
midinteger哔哩哔哩用户的数字 ID。
namestring投稿者显示名称。
facestring投稿者头像地址。
版权与观看权限28 个字段

data.videoData

字段类型说明
copyrightinteger哔哩哔哩为此稿件记录的数字版权分类。
rightsobject哔哩哔哩返回的观看与互动相关数字标记。
rights.elecinteger充电支持的数字标记。
rights.downloadinteger下载的数字标记。
rights.movieinteger电影内容数字标记。
rights.payinteger付费访问的数字标记。
rights.no_reprintinteger平台禁止转载设置的数字标记。
rights.autoplayinteger自动播放的数字标记。
rights.ugc_payinteger创作者内容付费访问的数字标记。
rights.is_cooperationinteger联合投稿数字标记。
rights.ugc_pay_previewinteger付费创作者内容的试看数字标记。
rights.no_backgroundinteger限制后台播放的数字标记。
rights.clean_modeinteger清爽模式数字标记。
rights.is_stein_gateinteger互动视频数字标记。
rights.is_360integer360 度视频数字标记。
rights.no_shareinteger限制分享的数字标记。
rights.arc_payinteger此稿件付费访问的数字标记。
rights.free_watchinteger免费观看的数字标记。
argue_infoobject如平台返回,表示与此视频关联的提示信息。
argue_info.argue_msgstring平台提示文字。
argue_info.argue_typeinteger平台提示的数字类型。
argue_info.argue_linkstring与平台提示关联的链接。
is_chargeable_seasonboolean哔哩哔哩是否将合集标记为付费。
is_upower_exclusiveboolean此视频是否标记为充电档位专属。
is_upower_playboolean当前页面上下文是否可以播放充电专属视频。
is_upower_previewboolean哔哩哔哩是否将此视频标记为可在当前页面上下文中试看。
is_upower_exclusive_with_qaboolean哔哩哔哩是否将此充电专属视频标记为关联问答。
teenage_modeinteger此视频的青少年模式数字标记。
充电与互动限制14 个字段

data

字段类型说明
elecFullInfoobject视频页面返回的充电和支持信息。
elecFullInfo.show_infoobject充电信息展示设置。
elecFullInfo.show_info.showboolean页面是否显示充电信息。
elecFullInfo.show_info.stateinteger充电信息展示的状态码。
elecFullInfo.show_info.titlestring充电信息的显示标题。
elecFullInfo.show_info.high_levelobject充电档位的展示信息。
elecFullInfo.show_info.high_level.titlestring充电档位的显示标题。
elecFullInfo.show_info.high_level.sub_titlestring充电档位的显示副标题。
elecFullInfo.show_info.high_level.introstring充电档位的展示简介。
emergencyBanobject当前页面上下文中的互动操作限制。
emergencyBan.no_likeboolean此页面是否限制点赞。
emergencyBan.no_coinboolean此页面是否限制投币。
emergencyBan.no_favboolean此页面是否限制收藏。
emergencyBan.no_shareboolean此页面是否限制分享。
稿件所属合集93 个字段

data.videoData.ugc_season

此稿件所在的创作者合集,存在时可用。

字段类型说明
idinteger合集的数字 ID。
titlestring合集标题。
coverstring合集封面图片地址。
midinteger投稿者的哔哩哔哩数字用户 ID。
introstring合集简介文本。
ep_countinteger返回的合集剧集数。
season_typeinteger合集的数字类型。
is_pay_seasonboolean哔哩哔哩是否将此合集标记为付费。
statobject此合集的互动统计。
stat.season_idinteger合集的数字 ID。
stat.viewinteger哔哩哔哩返回的播放量。
stat.danmakuinteger哔哩哔哩返回的弹幕数。
stat.replyinteger哔哩哔哩返回的评论数。
stat.favinteger哔哩哔哩返回的收藏数。
stat.coininteger哔哩哔哩返回的投币数。
stat.shareinteger哔哩哔哩返回的分享数。
stat.likeinteger哔哩哔哩返回的点赞数。
stat.now_rankinteger哔哩哔哩返回的当前排名值。
stat.his_rankinteger哔哩哔哩返回的历史排名值。
sectionsarray此合集下的分组。
sections[]object-
sections[].idinteger合集分组的数字 ID。
sections[].titlestring合集分组标题。
sections[].season_idinteger合集的数字 ID。
sections[].typeinteger该合集分组的数字类型。
sections[].episodesarray此合集中该分组的视频列表。
sections[].episodes[]object-
sections[].episodes[].idinteger合集剧集的数字 ID。
sections[].episodes[].aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
sections[].episodes[].bvidstring哔哩哔哩视频 ID(BV 号)。
sections[].episodes[].cidinteger合集剧集关联的内容 ID。
sections[].episodes[].titlestring合集剧集标题。
sections[].episodes[].season_idinteger合集的数字 ID。
sections[].episodes[].section_idinteger合集分组的数字 ID。
sections[].episodes[].pageobject剧集附带的分 P 元数据。
sections[].episodes[].page.cidinteger当前分 P 的内容 ID。
sections[].episodes[].page.pageinteger分 P 序号,从 1 开始。
sections[].episodes[].page.partstring当前分 P 的显示标题。
sections[].episodes[].page.durationinteger当前分 P 的时长,单位为秒。
sections[].episodes[].page.weblinkstring此分 P 关联的网页链接,存在时可用。
sections[].episodes[].page.dimensionobject视频画面尺寸和旋转信息。
sections[].episodes[].page.dimension.widthinteger视频画面宽度,单位为像素。
sections[].episodes[].page.dimension.heightinteger视频画面高度,单位为像素。
sections[].episodes[].page.dimension.rotateinteger视频画面旋转角度,单位为度。
sections[].episodes[].pagesarray此剧集返回的分 P。
sections[].episodes[].pages[]object-
sections[].episodes[].pages[].cidinteger当前分 P 的内容 ID。
sections[].episodes[].pages[].pageinteger分 P 序号,从 1 开始。
sections[].episodes[].pages[].partstring当前分 P 的显示标题。
sections[].episodes[].pages[].durationinteger当前分 P 的时长,单位为秒。
sections[].episodes[].pages[].weblinkstring此分 P 关联的网页链接,存在时可用。
sections[].episodes[].pages[].dimensionobject视频画面尺寸和旋转信息。
sections[].episodes[].pages[].dimension.widthinteger视频画面宽度,单位为像素。
sections[].episodes[].pages[].dimension.heightinteger视频画面高度,单位为像素。
sections[].episodes[].pages[].dimension.rotateinteger视频画面旋转角度,单位为度。
sections[].episodes[].arcobject剧集附带的稿件摘要。
sections[].episodes[].arc.aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
sections[].episodes[].arc.videosinteger本稿件的分 P 数量。
sections[].episodes[].arc.type_idinteger内容分区的数字 ID。
sections[].episodes[].arc.type_namestring内容分区名称。
sections[].episodes[].arc.type_id_v2integer第二套分区分类中的数字 ID。
sections[].episodes[].arc.type_name_v2string第二套分区分类中的分区名称。
sections[].episodes[].arc.copyrightinteger哔哩哔哩为此稿件记录的数字版权分类。
sections[].episodes[].arc.picstring视频封面图片地址。
sections[].episodes[].arc.titlestring视频标题。
sections[].episodes[].arc.pubdateinteger发布时间,Unix 时间戳,单位为秒。
sections[].episodes[].arc.ctimeinteger稿件创建时间,Unix 时间戳,单位为秒。
sections[].episodes[].arc.descstring视频的纯文本简介。
sections[].episodes[].arc.stateinteger哔哩哔哩记录的稿件状态码。
sections[].episodes[].arc.durationinteger稿件总时长,单位为秒。多 P 稿件包含所有分 P 的时长。
sections[].episodes[].arc.authorobject稿件作者的公开信息。
sections[].episodes[].arc.author.midinteger哔哩哔哩用户的数字 ID。
sections[].episodes[].arc.author.namestring投稿者显示名称。
sections[].episodes[].arc.author.facestring投稿者头像地址。
sections[].episodes[].arc.statobject此稿件的互动统计。
sections[].episodes[].arc.stat.aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
sections[].episodes[].arc.stat.viewinteger哔哩哔哩返回的播放量。
sections[].episodes[].arc.stat.danmakuinteger哔哩哔哩返回的弹幕数。
sections[].episodes[].arc.stat.replyinteger哔哩哔哩返回的评论数。
sections[].episodes[].arc.stat.favinteger哔哩哔哩返回的收藏数。
sections[].episodes[].arc.stat.coininteger哔哩哔哩返回的投币数。
sections[].episodes[].arc.stat.shareinteger哔哩哔哩返回的分享数。
sections[].episodes[].arc.stat.likeinteger哔哩哔哩返回的点赞数。
sections[].episodes[].arc.stat.dislikeinteger哔哩哔哩返回的点踩数。
sections[].episodes[].arc.stat.now_rankinteger哔哩哔哩返回的当前排名值。
sections[].episodes[].arc.stat.his_rankinteger哔哩哔哩返回的历史排名值。
sections[].episodes[].arc.dimensionobject视频画面尺寸和旋转信息。
sections[].episodes[].arc.dimension.widthinteger视频画面宽度,单位为像素。
sections[].episodes[].arc.dimension.heightinteger视频画面高度,单位为像素。
sections[].episodes[].arc.dimension.rotateinteger视频画面旋转角度,单位为度。
sections[].episodes[].arc.is_chargeable_seasonboolean哔哩哔哩是否将合集标记为付费。
sections[].episodes[].arc.is_blooperboolean哔哩哔哩是否将此视频标记为花絮。
sections[].episodes[].arc.is_lesson_videointeger课程视频数字标记。
页面合集95 个字段

data

字段类型说明
sectionsInfoobject视频页面返回的合集信息,存在时可用。
sectionsInfo.idinteger合集的数字 ID。
sectionsInfo.titlestring合集标题。
sectionsInfo.coverstring合集封面图片地址。
sectionsInfo.midinteger投稿者的哔哩哔哩数字用户 ID。
sectionsInfo.introstring合集简介文本。
sectionsInfo.ep_countinteger返回的合集剧集数。
sectionsInfo.season_typeinteger合集的数字类型。
sectionsInfo.is_pay_seasonboolean哔哩哔哩是否将此合集标记为付费。
sectionsInfo.statobject此合集的互动统计。
sectionsInfo.stat.season_idinteger合集的数字 ID。
sectionsInfo.stat.viewinteger哔哩哔哩返回的播放量。
sectionsInfo.stat.danmakuinteger哔哩哔哩返回的弹幕数。
sectionsInfo.stat.replyinteger哔哩哔哩返回的评论数。
sectionsInfo.stat.favinteger哔哩哔哩返回的收藏数。
sectionsInfo.stat.coininteger哔哩哔哩返回的投币数。
sectionsInfo.stat.shareinteger哔哩哔哩返回的分享数。
sectionsInfo.stat.likeinteger哔哩哔哩返回的点赞数。
sectionsInfo.stat.now_rankinteger哔哩哔哩返回的当前排名值。
sectionsInfo.stat.his_rankinteger哔哩哔哩返回的历史排名值。
sectionsInfo.sectionsarray此合集下的分组。
sectionsInfo.sections[]object-
sectionsInfo.sections[].idinteger合集分组的数字 ID。
sectionsInfo.sections[].titlestring合集分组标题。
sectionsInfo.sections[].season_idinteger合集的数字 ID。
sectionsInfo.sections[].typeinteger该合集分组的数字类型。
sectionsInfo.sections[].episodesarray此合集中该分组的视频列表。
sectionsInfo.sections[].episodes[]object-
sectionsInfo.sections[].episodes[].idinteger合集剧集的数字 ID。
sectionsInfo.sections[].episodes[].aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
sectionsInfo.sections[].episodes[].bvidstring哔哩哔哩视频 ID(BV 号)。
sectionsInfo.sections[].episodes[].cidinteger合集剧集关联的内容 ID。
sectionsInfo.sections[].episodes[].titlestring合集剧集标题。
sectionsInfo.sections[].episodes[].season_idinteger合集的数字 ID。
sectionsInfo.sections[].episodes[].section_idinteger合集分组的数字 ID。
sectionsInfo.sections[].episodes[].pageobject剧集附带的分 P 元数据。
sectionsInfo.sections[].episodes[].page.cidinteger当前分 P 的内容 ID。
sectionsInfo.sections[].episodes[].page.pageinteger分 P 序号,从 1 开始。
sectionsInfo.sections[].episodes[].page.partstring当前分 P 的显示标题。
sectionsInfo.sections[].episodes[].page.durationinteger当前分 P 的时长,单位为秒。
sectionsInfo.sections[].episodes[].page.weblinkstring此分 P 关联的网页链接,存在时可用。
sectionsInfo.sections[].episodes[].page.dimensionobject视频画面尺寸和旋转信息。
sectionsInfo.sections[].episodes[].page.dimension.widthinteger视频画面宽度,单位为像素。
sectionsInfo.sections[].episodes[].page.dimension.heightinteger视频画面高度,单位为像素。
sectionsInfo.sections[].episodes[].page.dimension.rotateinteger视频画面旋转角度,单位为度。
sectionsInfo.sections[].episodes[].pagesarray此剧集返回的分 P。
sectionsInfo.sections[].episodes[].pages[]object-
sectionsInfo.sections[].episodes[].pages[].cidinteger当前分 P 的内容 ID。
sectionsInfo.sections[].episodes[].pages[].pageinteger分 P 序号,从 1 开始。
sectionsInfo.sections[].episodes[].pages[].partstring当前分 P 的显示标题。
sectionsInfo.sections[].episodes[].pages[].durationinteger当前分 P 的时长,单位为秒。
sectionsInfo.sections[].episodes[].pages[].weblinkstring此分 P 关联的网页链接,存在时可用。
sectionsInfo.sections[].episodes[].pages[].dimensionobject视频画面尺寸和旋转信息。
sectionsInfo.sections[].episodes[].pages[].dimension.widthinteger视频画面宽度,单位为像素。
sectionsInfo.sections[].episodes[].pages[].dimension.heightinteger视频画面高度,单位为像素。
sectionsInfo.sections[].episodes[].pages[].dimension.rotateinteger视频画面旋转角度,单位为度。
sectionsInfo.sections[].episodes[].arcobject剧集附带的稿件摘要。
sectionsInfo.sections[].episodes[].arc.aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
sectionsInfo.sections[].episodes[].arc.videosinteger本稿件的分 P 数量。
sectionsInfo.sections[].episodes[].arc.type_idinteger内容分区的数字 ID。
sectionsInfo.sections[].episodes[].arc.type_namestring内容分区名称。
sectionsInfo.sections[].episodes[].arc.type_id_v2integer第二套分区分类中的数字 ID。
sectionsInfo.sections[].episodes[].arc.type_name_v2string第二套分区分类中的分区名称。
sectionsInfo.sections[].episodes[].arc.copyrightinteger哔哩哔哩为此稿件记录的数字版权分类。
sectionsInfo.sections[].episodes[].arc.picstring视频封面图片地址。
sectionsInfo.sections[].episodes[].arc.titlestring视频标题。
sectionsInfo.sections[].episodes[].arc.pubdateinteger发布时间,Unix 时间戳,单位为秒。
sectionsInfo.sections[].episodes[].arc.ctimeinteger稿件创建时间,Unix 时间戳,单位为秒。
sectionsInfo.sections[].episodes[].arc.descstring视频的纯文本简介。
sectionsInfo.sections[].episodes[].arc.stateinteger哔哩哔哩记录的稿件状态码。
sectionsInfo.sections[].episodes[].arc.durationinteger稿件总时长,单位为秒。多 P 稿件包含所有分 P 的时长。
sectionsInfo.sections[].episodes[].arc.authorobject稿件作者的公开信息。
sectionsInfo.sections[].episodes[].arc.author.midinteger哔哩哔哩用户的数字 ID。
sectionsInfo.sections[].episodes[].arc.author.namestring投稿者显示名称。
sectionsInfo.sections[].episodes[].arc.author.facestring投稿者头像地址。
sectionsInfo.sections[].episodes[].arc.statobject此稿件的互动统计。
sectionsInfo.sections[].episodes[].arc.stat.aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
sectionsInfo.sections[].episodes[].arc.stat.viewinteger哔哩哔哩返回的播放量。
sectionsInfo.sections[].episodes[].arc.stat.danmakuinteger哔哩哔哩返回的弹幕数。
sectionsInfo.sections[].episodes[].arc.stat.replyinteger哔哩哔哩返回的评论数。
sectionsInfo.sections[].episodes[].arc.stat.favinteger哔哩哔哩返回的收藏数。
sectionsInfo.sections[].episodes[].arc.stat.coininteger哔哩哔哩返回的投币数。
sectionsInfo.sections[].episodes[].arc.stat.shareinteger哔哩哔哩返回的分享数。
sectionsInfo.sections[].episodes[].arc.stat.likeinteger哔哩哔哩返回的点赞数。
sectionsInfo.sections[].episodes[].arc.stat.dislikeinteger哔哩哔哩返回的点踩数。
sectionsInfo.sections[].episodes[].arc.stat.now_rankinteger哔哩哔哩返回的当前排名值。
sectionsInfo.sections[].episodes[].arc.stat.his_rankinteger哔哩哔哩返回的历史排名值。
sectionsInfo.sections[].episodes[].arc.dimensionobject视频画面尺寸和旋转信息。
sectionsInfo.sections[].episodes[].arc.dimension.widthinteger视频画面宽度,单位为像素。
sectionsInfo.sections[].episodes[].arc.dimension.heightinteger视频画面高度,单位为像素。
sectionsInfo.sections[].episodes[].arc.dimension.rotateinteger视频画面旋转角度,单位为度。
sectionsInfo.sections[].episodes[].arc.is_chargeable_seasonboolean哔哩哔哩是否将合集标记为付费。
sectionsInfo.sections[].episodes[].arc.is_blooperboolean哔哩哔哩是否将此视频标记为花絮。
sectionsInfo.sections[].episodes[].arc.is_lesson_videointeger课程视频数字标记。
sectionsFavStateboolean当前页面上下文中的合集收藏状态。
标签与相关视频27 个字段

data

字段类型说明
tagsarray视频页面展示的标签。
tags[]object-
tags[].tag_idinteger标签的数字 ID。
tags[].tag_namestring哔哩哔哩展示的标签名称。
tags[].tag_typestring标签类型标识。
tags[].music_idstring标签关联的音乐 ID,存在时可用。
tags[].jump_urlstring标签关联的跳转地址。
tags[].showDetailboolean标签是否标记为展示详情。
tags[].showReportboolean标签是否标记为可举报。
relatedarray视频页面返回的相关视频。
related[]object-
related[].aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
related[].cidinteger相关视频关联的内容 ID。
related[].bvidstring哔哩哔哩视频 ID(BV 号)。
related[].durationinteger相关视频时长,单位为秒。
related[].picstring视频封面图片地址。
related[].titlestring视频标题。
related[].ownerobject稿件作者的公开信息。
related[].owner.midinteger哔哩哔哩用户的数字 ID。
related[].owner.namestring投稿者显示名称。
related[].statobject相关视频的互动统计。
related[].stat.viewinteger哔哩哔哩返回的播放量。
related[].stat.danmakuinteger哔哩哔哩返回的弹幕数。
related[].season_idinteger此稿件关联的合集 ID。
related[].season_typeinteger合集的数字类型。
related[].redirect_urlstring打开此相关视频的跳转地址。
related[].redirected_urlstring此相关视频的已解析跳转地址。
播放格式与时长52 个字段

data.dash_info

当前分 P 的播放元数据。存在观看限制时,此对象可能没有 DASH 流信息。

字段类型说明
qualityinteger返回的播放元数据中的清晰度数字编码。
formatstring当前分 P 返回的播放格式标识。
timelengthinteger当前分 P 的播放时长,单位为毫秒。
accept_formatstring播放器接受的播放格式标识,以文本表示。
accept_descriptionarray播放器接受的清晰度选项的显示标签列表。
accept_qualityarray播放器接受的清晰度数字编码列表。
video_codecidinteger视频播放使用的编解码器数字 ID。
support_formatsarray可用播放清晰度与格式选项的详情。
support_formats[]object-
support_formats[].qualityinteger此播放选项的清晰度数字编码。
support_formats[].formatstring此播放选项的格式标识。
support_formats[].new_descriptionstring此播放选项展示的说明。
support_formats[].display_descstring此播放选项的简短显示标签。
support_formats[].superscriptstring此播放选项的补充显示标签。
support_formats[].codecsarray | null此格式的编解码器标识列表,未提供列表时可为 null。
support_formats[].can_watch_qn_reasoninteger平台返回的清晰度可观看状态原因码。
support_formats[].limit_watch_reasoninteger平台返回的清晰度观看限制原因码。
dashobject响应包含 DASH 流时返回的元数据。
dash.durationinteger当前分 P 的 DASH 时长,单位为秒。
dash.minBufferTimenumberDASH 声明的最短缓冲时长,单位为秒。
dash.min_buffer_timenumberDASH 声明的最短缓冲时长,单位为秒。
dash.videoarrayDASH 清单中的视频轨道版本。
dash.video[]object-
dash.video[].idinteger此媒体轨道版本的数字 ID。
dash.video[].bandwidthinteger此媒体轨道版本声明的带宽,单位为比特每秒。
dash.video[].mimeTypestring媒体 MIME 类型。
dash.video[].mime_typestring媒体 MIME 类型。
dash.video[].codecsstring此媒体轨道版本的编解码器标识。
dash.video[].codecidinteger此媒体轨道版本的编解码器数字 ID。
dash.video[].widthinteger视频画面宽度,单位为像素。
dash.video[].heightinteger视频画面高度,单位为像素。
dash.video[].frameRatestringDASH 轨道版本中表示的帧率。
dash.video[].frame_ratestringDASH 轨道版本中表示的帧率。
dash.video[].sarstring视频轨道版本的像素宽高比。
dash.audioarrayDASH 清单中的音频轨道版本。
dash.audio[]object-
dash.audio[].idinteger此媒体轨道版本的数字 ID。
dash.audio[].bandwidthinteger此媒体轨道版本声明的带宽,单位为比特每秒。
dash.audio[].mimeTypestring媒体 MIME 类型。
dash.audio[].mime_typestring媒体 MIME 类型。
dash.audio[].codecsstring此媒体轨道版本的编解码器标识。
dash.audio[].codecidinteger此媒体轨道版本的编解码器数字 ID。
dash.audio[].widthinteger视频画面宽度,单位为像素。
dash.audio[].heightinteger视频画面高度,单位为像素。
dash.audio[].frameRatestringDASH 轨道版本中表示的帧率。
dash.audio[].frame_ratestringDASH 轨道版本中表示的帧率。
dash.audio[].sarstring视频轨道版本的像素宽高比。
durlarray播放响应提供时返回的媒体分段列表。
durl[]object-
durl[].orderinteger此播放分段的顺序。
durl[].lengthinteger此播放分段返回的时长值。
durl[].sizeinteger此播放分段返回的大小值。
其他字段22 个字段
字段路径类型说明
data.videoData.dynamicstring与此视频关联的 B 站动态文案。
data.videoData.cidinteger当前分 P 的内容 ID。
data.videoData.dimensionobject视频画面尺寸和旋转信息。
data.videoData.dimension.widthinteger视频画面宽度,单位为像素。
data.videoData.dimension.heightinteger视频画面高度,单位为像素。
data.videoData.dimension.rotateinteger视频画面旋转角度,单位为度。
data.videoData.season_idinteger此稿件关联的合集 ID。
data.videoData.is_season_displayboolean页面是否标记为展示合集。
data.videoData.is_storyboolean哔哩哔哩是否将此稿件标记为 Story 视频。
data.videoData.is_story_playintegerStory 播放数字标记。
data.videoData.disable_show_up_infoboolean页面是否隐藏投稿者信息。
data.videoData.is_view_selfboolean当前页面是否处于投稿者查看本人视频的上下文。
data.videoData.subtitleobject视频页面返回的字幕信息。
data.videoData.subtitle.allow_submitboolean当前页面上下文是否允许提交字幕。
data.videoData.subtitle.listarray稿件的字幕条目列表,可能为空。
data.videoData.honor_replyobject视频展示的荣誉或认可信息。
data.videoData.honor_reply.honorarray荣誉或认可条目列表。
data.videoData.honor_reply.honor[]object-
data.videoData.honor_reply.honor[].aidinteger哔哩哔哩稿件的数字 ID(AV 号)。
data.videoData.honor_reply.honor[].typeinteger荣誉的数字类型。
data.videoData.honor_reply.honor[].descstring哔哩哔哩显示的荣誉说明。
data.errorobject视频页面的错误信息,可能是空对象。

响应示例 ​

正在加载响应示例…