Bilibili Search API returns structured video search results from Bilibili, China's largest video platform. Search by keyword with filters for search type, ordering, duration and category, then paginate through results. Each result carries the BV id, title, author, play count, danmaku count, reply count, favorite count, duration, thumbnail, publish date and tags. A valid empty result is a successful response.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
4 optional filters available.
string
Required
Search type: video, bili_user, media_bangumi, media_ft, article, live, live_user, live_room.
example
string
Required
Search keyword.
running shoes
integer
Optional
Page number, 1-based. Defaults to 1.
1
string
Optional
Result ordering: totalrank, click, pubdate, scores, stow, dm, pw. Defaults to totalrank.
example
integer
Optional
Duration filter: 0=all, 1=<10min, 2=10-30min, 3=30-60min, 4=>60min. Defaults to 0.
10
integer
Optional
Category filter, 0=all.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
page
count
pages
results
has_more
page_size
Common results fields
aid
mid
pic
tag
{
"meta": {
"endpoint_family": "search"
},
"page": 1,
"count": 1000,
"pages": 50,
"results": [
{
"aid": 113006243481679,
"mid": 3546597933714079,
"pic": "https://i2.hdslb.com/bfs/archive/abc123.jpg",
"tag": "Python,programming",
"bvid": "BV1rpWjevEip",
"play": 20709037,
"reply": 2457,
"title": "Python tutorial course",
"author": "Python Official",
"danmaku": 132790,
"pubdate": 1660000000,
"duration": "39:58",
"favorite": 69881
}
],
"has_more": true,
"page_size": 20
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.