Skip to content
DataXAPI
All Bilibili APIs
Trends & rankingsBilibiliRanked Video · Trending

Bilibili popular videos

Read Bilibili's current popular videos with recommendation reasons and engagement counts, page by page.

POST/v1/bilibili/videos/popular

Chinese name: B站综合热门 · 榜单视频 · 热门趋势 按页读取 B站当前综合热门视频及推荐理由和互动计数。
bilibili.videos.popular@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

pageintegeroptional

default: 1 · minimum: 1 · maximum: 20

Example: 1

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "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/popular \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":1}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_bilibili_videos_popular",
  "message": "success",
  "data": {
    "items": [
      {
        "bvid": "BV1M1421t7hT",
        "title": "公开热门视频",
        "tname": "生活",
        "pubdate": 1718000000,
        "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
        },
        "rcmd_reason": {
          "content": "百万播放"
        }
      }
    ]
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "bilibili.videos.popular",
    "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": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "bvid": {},
              "aid": {},
              "title": {},
              "desc": {},
              "tname": {},
              "pubdate": {},
              "duration": {},
              "owner": {},
              "stat": {},
              "rcmd_reason": {}
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "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.popular"
        },
        "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 to discover public videos and topics trending on Bilibili now.

Not for

  • Do not use it for historical hits, category charts, or personalized feeds.

Known limitations

  • This is a point-in-time board snapshot.
  • Page-number paging can repeat or skip items between pages.
  • Result order is set by the platform and does not explain ranking causality.

Billing

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

See all pricing →