Bilibili API endpoint
Returns the current Bilibili all-site video ranking in rank order. Each video has its `rank`, `aid`, `title`, `url`, `cover`, `views`, `danmaku`, `replies`, `favorites`, `likes`, `duration_seconds`, `published_at`, `category` and `creator` (name, `mid`, `followers`). Takes no parameters.
/bilibili/rankingReturns Bilibili's current official all-site video ranking in rank order.
This endpoint has no query or path parameters.
Each ranked video includes its AID, canonical web URL, title, cover, engagement counts, duration, publication timestamp, category, and creator metadata. A successful response must contain recognizable ranked video cards; a changed or empty upstream payload returns an upstream error.
| Field | Filled in, of 100 checked | Values in the sample |
|---|---|---|
| rank | 100 | 1 to 100, median 50 |
| aid | 100 | “117416487096831” and 99 other values |
| title | 100 | “12个脑洞大开的做饭方式!” and 99 other values |
| url | 100 | bilibili.com |
| cover | 100 | i2.hdslb.com and 2 other hosts |
| views | 100 | 224,512 to 7,225,007, median 1,130,415 |
| danmaku | 100 | 73 to 33,025, median 1,355 |
| replies | 100 | 638 to 21,228, median 2,223 |
| favorites | 100 | 3,419 to 145,170, median 16,422 |
| likes | 100 | 22,741 to 403,879, median 78,814 |
| duration_seconds | 100 | 13 to 15,750, median 292 |
| published_at | 100 | 2026-10-07 to 2026-10-13 |
| category_id | 100 | |
| category | 100 | “美食制作” and 36 other values |
| creator | 100 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/bilibili/ranking" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"count": 1,
"videos": [
{
"rank": 1,
"aid": "117150215835256",
"title": "Ranked Bilibili video",
"url": "https://www.bilibili.com/video/av117150215835256",
"cover": "https://i0.hdslb.com/bfs/archive/example.jpg",
"views": 3630686,
"danmaku": 13897,
"replies": 22502,
"favorites": 64334,
"likes": 401606,
"duration_seconds": 2746,
"published_at": 1787571194,
"category_id": 183,
"category": "影视剪辑",
"creator": {
"mid": 525952604,
"name": "Bilibili creator",
"followers": 3735326
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/bilibili.rankingResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | bilibili.RankingResponse | No | ||||
| data.count | integer | No | 100 | |||
| data.videos | array | No | ||||
| data.videos[].aid | string | No | 117150215835256 | |||
| data.videos[].category | string | No | 影视剪辑 | |||
| data.videos[].category_id | integer | No | 183 | |||
| data.videos[].cover | string | No | https://i0.hdslb.com/bfs/archive/example.jpg | |||
| data.videos[].creator | bilibili.RankingCreator | No | ||||
| data.videos[].creator.avatar | string | No | https://i2.hdslb.com/bfs/face/example.jpg | |||
| data.videos[].creator.followers | integer | No | 3735326 | |||
| data.videos[].creator.mid | integer | No | 525952604 | |||
| data.videos[].creator.name | string | No | Bilibili creator | |||
| data.videos[].creator.official_description | string | No | Verified creator | |||
| data.videos[].danmaku | integer | No | 13897 | |||
| data.videos[].duration_seconds | integer | No | 2746 | |||
| data.videos[].favorites | integer | No | 64334 | |||
| data.videos[].likes | integer | No | 401606 | |||
| data.videos[].published_at | integer | No | 1787571194 | |||
| data.videos[].rank | integer | No | 1 | |||
| data.videos[].replies | integer | No | 22502 | |||
| data.videos[].title | string | No | Ranked Bilibili video | |||
| data.videos[].url | string | No | https://www.bilibili.com/video/av117150215835256 | |||
| data.videos[].views | integer | No | 3630686 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/bilibili/ranking" \
-H "x-api-key: $CRAWLORA_API_KEY"