Skip to content
DataXAPI
All Bilibili APIs
Posts & videosBilibiliVideo · Detail

Bilibili video detail

Read a public Bilibili video's title, description, uploader, category, and view, danmaku, coin, and favorite counts by BV ID.

POST/v1/bilibili/videos/detail

Chinese name: B站视频详情 · 视频 · 详情 按 BV 号读取一条 B站公开视频的标题、简介、UP 主、分区和播放、弹幕、投币、收藏等计数。
bilibili.videos.detail@v1

Price per call

¥0.02/ call

Nonempty complete results are charged; empty, partial, and failed results are not.

Current statusAvailableChecking live status →
Checking live status

Try it

Sign in and run one real call. The result and charge appear right here.

Security check

Loading the security check…

Checking live execution status…

Execution result

// Result

Request parameters

bvidstringrequired

pattern: "^BV[0-9A-Za-z]{10}$" · minLength: 1 · maxLength: 256

Example: "BV1M1421t7hT"

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bvid": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^BV[0-9A-Za-z]{10}$"
    }
  },
  "required": [
    "bvid"
  ],
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/bilibili/videos/detail \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bvid":"BV1M1421t7hT"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_bilibili_videos_detail",
  "message": "success",
  "data": {
    "item": {
      "bvid": "BV1M1421t7hT",
      "aid": 1156219960,
      "title": "公开视频标题",
      "tname": "科技",
      "pubdate": 1718000000,
      "duration": 312,
      "owner": {
        "mid": 178360345,
        "name": "Public UP",
        "face": "https://i0.hdslb.com/bfs/face/example.jpg"
      },
      "stat": {
        "view": 120000,
        "danmaku": 800,
        "reply": 450,
        "favorite": 3000,
        "coin": 2100,
        "share": 300,
        "like": 9000
      }
    }
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "bilibili.videos.detail",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.02",
    "balance_after": "49.98",
    "currency": "CNY"
  }
}
Response fields
codenumber
const: 200
request_idstring
messagestring
const: "success"
dataobject
pageobject
warningsarray
metaobject
Response JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "item": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "bvid": {},
                "aid": {},
                "title": {},
                "desc": {},
                "pic": {},
                "tname": {},
                "pubdate": {},
                "duration": {},
                "videos": {},
                "owner": {},
                "stat": {},
                "cid": {}
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "item"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "bilibili.videos.detail"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

  • Use it when you have a BV ID and need the video's public details and engagement.

Not for

  • Do not use it to download video, read full danmaku, or access member-only content.

Known limitations

  • Stream URLs are not returned; multi-part videos report combined counts.
  • Counts are point-in-time public snapshots, not live or historical trends.
  • Nested objects such as the author are returned as upstream sends them, minus tokens, account-binding flags, privacy settings, and tracking fields; avatar and media links inside them may expire.

Billing

¥0.02 per call. Nonempty complete results are charged; empty, partial, and failed results are not.

See all pricing →