Bilibili API

Also known asB站哔哩哔哩小破站

8 endpoints read Bilibili: videos, users, comments, trends. From $0.0020 a call. No Bilibili login and no cookie; a failed call is free.

Endpoints8 endpointsin 4 groups, one response shape
PriceFrom $0.0020per call. Failed calls are free
When an upstream failsRetried for youChecked every day with real calls · 4 days on record
DataFetched liveboards are 10-minute snapshots

One call, as it came back

A recorded call, fields already tidied up: ready for an AI or a spreadsheet.
Recorded
GET/v1/bilibili/videos/search$0.0020
FieldValue
typevideo
published_at2026-09-30 08:55 UTC
metrics.likes237
metrics.comments64
metrics.favorites169
metrics.views35,706

The first 6 rows of a response recorded 2026-10-12 18:47 UTC.

Run it in the Playground · $0.0020
Recorded response
{
  "code": "ok",
  "request_id": "dee21d14-3682-420a-acad-8806b2d59dfe",
  "data": {
    "items": [
      {
        "id": "BV1M05Rhoe4r",
        "url": "https://www.bilibili.com/video/BV1M05Rhoe4r",
        "type": "video",
        "title": "实测一个月机械键盘,结论有点意外",
        "text": null,
        "published_at": "2026-09-30T08:55:00.000Z",
        "author": {
          "id": "585724901",
          "name": "阿杰爱折腾",
          "avatar_url": "https://i0.hdslb.com/bfs/face/17a7658e63c84808ef09bb48.jpg"
        },
        "metrics": {
          "likes": 237,
          "comments": 64,
          "favorites": 169,
          "views": 35706
        },
        "hashtags": [
          "户外生活",
          "好物分享",
          // … 8 more
        ]
      },
      // … 19 more
    ]
  },
  "page": {
    "next_cursor": "c1.72NAeDsxx6zMLTUXCjX2T5Su39puxExBbLOvdWBm",
    "cursor_expires_at": "2026-10-12T19:47:48.000Z",
    "has_more": true,
    "returned": 20
  },
  "warnings": [],
  "meta": {
    "capability": "bilibili.videos.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T18:47:48.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "lang": "capability",
      "author.username": "platform",
      "author.verified": "capability",
      "author.followers": "capability",
      "metrics.shares": "capability",
      "metrics.reposts": "platform",
      "images": "platform",
      "mentions": "capability",
      "is_pinned": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

From a response recorded 2026-10-12 18:47 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

What you can get

Each row is an endpoint: what it returns and what one call costs.

EndpointPathReturnsPrice
Videos4
Bilibili video searchGET/v1/bilibili/videos/searchPost list$0.0020
Bilibili video detailGET/v1/bilibili/videos/getPost$0.0020
Bilibili video commentsGET/v1/bilibili/videos/comments/listComment list$0.0020
Bilibili popular videosGET/v1/bilibili/videos/trendingPost list$0.0020
Users2
Bilibili user profileGET/v1/bilibili/users/getAccount$0.0020
Bilibili user videosGET/v1/bilibili/users/videos/listPost list$0.0020
Comments1
Bilibili comment repliesGET/v1/bilibili/comments/replies/listComment list$0.0020
Bilibili hot searchesGET/v1/bilibili/trends/listTrend list$0.0020
Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.Bilibili API pricing →Bilibili data in your AI →See live status →

What people build with it

Ready-made tasks your AI can run on Bilibili data. Each is a few calls under a spending cap.

Ask about Bilibili right inside Claude or Cursor

Add the DataXAPI MCP server and the AI finds the Bilibili endpoint it needs and calls it; answers link back to the source. You pay for the calls it makes.

Bilibili MCP setup →
https://api.dataxapi.com/mcp

Start in three steps

The call shown here is Bilibili video search. Every other Bilibili endpoint is called the same way and answers in the same envelope.

Get a key

Sign in with an emailed code or Google. Free trial, no card needed.

Call it, or let your AI call it

One GET from your code. Or paste this prompt into your agent with your key in it: it sets itself up, then finds and calls these endpoints by itself.

Read https://dataxapi.com/agents.md and set up DataXAPI in this agent. My API key is dx_live_…; use it for every DataXAPI call.

Sign in to copy it with your key

Read the same shape every time

Items are in data.items (one object in data.item), the next page in page.next_cursor, the charge in meta.billing.amount. A failed call is not charged.

Read the quickstart →
curl -G "https://api.dataxapi.com/v1/bilibili/videos/search" \
  --data-urlencode "query=机械键盘" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.bilibili.videos.search(query="机械键盘")
print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.bilibili.videos.search({ query: "机械键盘" });
console.log(result.data.items);
dataxapi call bilibili.videos.search 'query=机械键盘'
{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

Add this to your MCP client, then ask your agent to call bilibili.videos.search.

Edge cases

What the Bilibili endpoints do at their edges, and what to check when a call does not return what you expected.

Page sizes
A list returns 20 to 50 items a page, depending on the endpoint. 5 of the 6 lists go on to a next page: page.next_cursor, passed back as cursor, each page a call of its own. The others return one page only.
Fields it cannot give
8 of the 8 endpoints cannot fill every field of the object they return. Each endpoint's page lists which, and every answer repeats them in meta.unavailable: a missing field is never a silent zero.
A missing object that reads as empty
Bilibili user videos: an object that does not exist cannot be told from one with nothing under it, so the answer is an empty result, not a 404, and is charged as an empty result is.
Snapshots
Bilibili hot searches, Bilibili popular videos: a board is a snapshot refreshed every 10 minutes, and meta.fetched_at says when it was taken.
The BV number
A video is named by its BV number, 12 characters starting with BV1, or by its page link (bilibili.com/video/BV…); b23.tv short links are not taken.
The user number (mid)
A user is named by the digits after space.bilibili.com/ in a space link.
Replies need two IDs
Replies take the comment's ID and its video's BV number, both as the comment list returns them (id and post_id).
Fewer counts in an upload list
A user's video list gives views, comments and danmaku, but no likes, coins, saves or shares; read a video's detail for those.
Empty is not “not found”
A user number nobody has returns an empty video list, charged as an empty result.

Questions about the Bilibili API

Short answers. The details are on each endpoint's page.

How is the Bilibili API priced?

Per call, no subscription. All 8 endpoints cost $0.0020 a call. You are charged when data comes back; a failed call costs nothing.

Do I need a Bilibili account or a cookie?

No. One DataXAPI key is all you hold: no Bilibili login, no cookie, no device to keep alive. The endpoints return publicly visible data only.

Is the data live?

A call fetches from Bilibili at that moment, and meta.fetched_at says when. Bilibili hot searches, Bilibili popular videos: a board is a snapshot refreshed every 10 minutes. A result is kept for 24 hours, so a retry with the same Idempotency-Key is not charged again.

Is an empty result charged?

A list that comes back empty is charged its price: the search was run. Reading one object that does not exist answers not_found and is free.

What happens when Bilibili changes something?

A call that fails is not charged, whatever the reason. An endpoint that is paused answers capability_paused, also free, and GET /v1/catalog/status says what is up right now.

Related

Call Bilibili with one key.

Free trial on sign-up: up to 50 calls at $0.0020. No card. No Bilibili login, no cookie, no subscription. A failed call is free.

Start free