bilibili.com APIwww.bilibili.com ↗
Fetch trending Bilibili videos with metadata including title, view count, duration, uploader info, and upload date via a single paginated endpoint.
curl -X GET 'https://api.parse.bot/scraper/1ec49d42-c5e3-4f48-bc10-1be2b9a4afbb/get_popular_videos?page=1&page_size=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Get popular/trending videos from Bilibili with full metadata including title, URL, view count, comments, duration, uploader info, and upload date. Supports pagination.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (starts from 1). |
| page_size | integer | Number of videos per page (1-20, capped at 20). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"count": "integer, number of videos returned on this page",
"videos": "array of video objects with keys: aid, bvid, title, description, url, short_url, thumbnail, duration_seconds, duration, upload_date, category, uploader (object with mid, name, avatar), stats (object with views, danmaku, comments, favorites, coins, shares, likes), recommendation_reason",
"page_size": "integer, number of videos requested per page"
},
"sample": {
"data": {
"page": 1,
"count": 5,
"videos": [
{
"aid": 116566670709136,
"url": "https://www.bilibili.com/video/BV1cX516vEu8",
"bvid": "BV1cX516vEu8",
"stats": {
"coins": 53177,
"likes": 106043,
"views": 1171405,
"shares": 12258,
"danmaku": 6583,
"comments": 8694,
"favorites": 19545
},
"title": "《原神》尼可角色PV——「缀口的金弦」",
"category": "手机游戏",
"duration": "11:54",
"uploader": {
"mid": 401742377,
"name": "John Doe",
"avatar": "https://i2.hdslb.com/bfs/face/853c4a846793dfbdafd8f16a40d6d8065bdb7c6f.jpg"
},
"short_url": "https://b23.tv/BV1cX516vEu8",
"thumbnail": "http://i0.hdslb.com/bfs/archive/83d1d5c1d334b7d673f589279894685c96e65f41.jpg",
"description": "很多很多个日月轮转之前...",
"upload_date": "2026-05-14 04:00:00",
"duration_seconds": 714,
"recommendation_reason": "百万播放"
}
],
"page_size": 5
},
"status": "success"
}
}About the bilibili.com API
The Bilibili API provides access to trending video listings from bilibili.com through a single get_popular_videos endpoint, returning up to 20 videos per page with 10 distinct fields per video — including view counts, comment counts, duration, uploader details, and both canonical and short-form URLs. It covers the popular/trending feed and supports pagination to walk through the full rankings list.
What the API Returns
The get_popular_videos endpoint returns the current popular/trending video feed from Bilibili. Each response includes a videos array along with top-level pagination fields: page, page_size, and count. Individual video objects carry both Bilibili identifier formats — aid (the legacy numeric ID) and bvid (the current alphanumeric ID) — so downstream systems can reference videos in whichever format their integration requires.
Video Metadata Fields
Each video object exposes title, description, url, short_url, and thumbnail for content display or deduplication. Timing data is available in two forms: duration_seconds (integer, machine-readable) and duration (human-formatted string). The upload_date field records when the video was published. Uploader information is included within the video object, allowing you to track which creators appear most frequently in the trending feed.
Engagement and Popularity Signals
View count and comment count are returned per video, giving a direct signal of audience engagement for each trending entry. These figures reflect the state of the trending feed at the time of the request. Since Bilibili's popular feed refreshes continuously, polling the endpoint at regular intervals is the standard pattern for monitoring shifts in ranking or detecting newly viral content.
Pagination
The page parameter accepts an integer starting from 1, and page_size accepts values between 1 and 20 (capped at 20). Use these to page through the full popular list. The count field in each response confirms how many videos were returned for the current page, which is useful for detecting the end of the feed.
- Track which video categories and topics dominate Bilibili's trending feed over time using
titleanddescriptionfields. - Monitor emerging creators by watching for new uploaders appearing in trending results via the uploader info fields.
- Build a Bilibili trend dashboard that polls the popular feed and stores
view_countandcomment_counttime series perbvid. - Seed a content recommendation engine with the current top 20 trending videos using
thumbnail,title, andurl. - Detect viral content early by comparing
upload_dateagainst ranking position for recently uploaded videos. - Aggregate trending video metadata for research into platform popularity patterns across different time windows.
- Cross-reference
bvididentifiers with external datasets to enrich Bilibili trending data with additional signals.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bilibili have an official developer API?+
What does `get_popular_videos` return beyond basic titles and URLs?+
aid and bvid identifiers, title, description, url, short_url, thumbnail, duration_seconds, duration, upload_date, uploader info, view count, and comment count. The dual-identifier format means you can reference videos using either the legacy numeric ID or the current alphanumeric BV ID.