Bilibili API: List popular videos
Lists the current Bilibili ranking overall or in a selected category, in rank order. The Movies ranking does not provide uploader, likes, length or BV numbers.
Unofficial. Not affiliated with or endorsed by Bilibili.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Category optional
category Ranking category, such as music or gaming.
all
One of
all,anime,music,dance,gaming,knowledge,tech,food,movies. Defaultall.- Max Results optional
max_results Maximum number of ranked videos to return, for example 50.
50
Whole number from 1 to 100. Default
50.
Input as JSON
{ "category": "all", "max_results": 50}Output
{ "videos": [ { "rank": 1, "likes": 318922, "title": "《原神》六周年主题曲《风的来信》", "views": 2067214, "length": "14:38", "danmaku": 38164, "uploader": "原神", "bv_number": "BV14Baa6JENd", "video_link": "https://www.bilibili.com/video/BV14Baa6JENd" , "cover_image_link": "https://i2.hdslb.com/bfs/archive/e0fff47818224cf8016d5743fb8b35a2c3812eb8.jpg" }, { "rank": 2, "likes": 233916, "title": "蛙跳爬泰山", "views": 1550502, "length": "9:20", "danmaku": 9179, "uploader": "爱健身小庞", "bv_number": "BV1Hxah6BEGy", "video_link": "https://www.bilibili.com/video/BV1Hxah6BEGy" , "cover_image_link": "https://i1.hdslb.com/bfs/archive/7352ffb6b3855ae481e3588fccfc0b436e315119.jpg" }, { "rank": 3, "likes": 164478, "title": "《三角洲行动》群星计划—代号:威龙", "views": 3074784, "length": "13:56", "danmaku": 22050, "uploader": "三角洲行动", "bv_number": "BV1fAh96ZELn", "video_link": "https://www.bilibili.com/video/BV1fAh96ZELn" , "cover_image_link": "https://i2.hdslb.com/bfs/archive/67a46169420d507f3f1846d282d59be3472acb98.jpg" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"bilibili.com/list_popular_videos","input":{"category":"all","max_results":50}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "bilibili.com/list_popular_videos" , "input": { "category": "all", "max_results": 50 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "bilibili.com/list_popular_videos" , "input": { "category": "all", "max_results": 50 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run bilibili.com/list_popular_videos# with {"category":"all","max_results":50}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "category": { "enum": [ "all", "anime", "music", "dance", "gaming", "knowledge", "tech", "food", "movies" ], "type": "string", "default": "all", "description": "Ranking category, such as music or gaming." }, "max_results": { "type": "integer", "default": 50, "maximum": 100, "minimum": 1, "description": "Maximum number of ranked videos to return, for example 50." } }}Output schema
{ "type": "object", "required": [ "videos" ], "properties": { "videos": { "type": "array", "items": { "type": "object", "required": [ "rank", "title", "uploader", "views", "likes", "danmaku", "length", "cover_image_link", "video_link", "bv_number" ], "properties": { "rank": { "type": "integer", "description": "Position in the selected ranking." }, "likes": { "type": [ "integer", "null" ] }, "title": { "type": [ "string", "null" ] }, "views": { "type": [ "integer", "null" ] }, "length": { "type": [ "string", "null" ] }, "danmaku": { "type": [ "integer", "null" ] }, "uploader": { "type": [ "string", "null" ] }, "bv_number": { "type": [ "string", "null" ] }, "video_link": { "type": [ "string", "null" ] }, "cover_image_link": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
bilibili.com/list_popular_videos- Returns
- rank, title, uploader, views, likes, danmaku, length, cover image, video link, BV number
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method bilibili.com/list_popular_videos with the inputs above.
Ask your agent
- What are the top 10 trending videos on Bilibili right now in the gaming category?
- Show me the current top 30 music videos ranked on bilibili, with view counts and uploaders
- I need the overall ranking of the hottest Chinese video-sharing site clips today, top 50 with danmaku counts and links
- Which food videos are ranking highest at the moment? Give me the first 20 with likes and video length
- Pull the 100 most popular tech videos currently on the chart, including BV numbers and cover images
See more
All Bilibili methodsGets public statistics and details for a Bilibili video from its link, BV number or title. A title selects the top video search match. Category may be missing when Bilibili does not show a label.
bilibili.com/get_videoLists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members.
myanimelist.net/list_top_animeLists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
twitch.tv/list_top_categoriesLists popular or trending WEBTOON series in ranking order, with authors and displayed subscriber and view counts. Genre filtering keeps matching series from the public top 30.
webtoons.com/list_rankingsLists the most-watched live Twitch streams, optionally within a category and language. All-category results are limited to 30 streams; category results allow up to 100.
twitch.tv/list_top_streamsLists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles.
imdb.com/list_top_chartsLists Letterboxd films in popularity order for a week, month, year or all time, optionally filtered by genre and decade. Ratings and posters may be unavailable for some films.
letterboxd.com/list_popular_filmsLists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
play.google.com/list_top_charts