Bilibili API: Get video
Gets 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.
Unofficial. Not affiliated with or endorsed by Bilibili.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Video, required
video A Bilibili video link, BV number, or video title, for example 《原神》六周年主题曲《风的来信》.
BV15NaG63Emz
Input as JSON
{ "video": "BV15NaG63Emz"}Output
{ "tags": [ "原神6周年", "米哈游", "miHoYo" ], "coins": 10879, "likes": 50461, "title": "《原神》提瓦特冒险纪念视频:旅行六周年手札", "views": 304824, "length": "2:08", "shares": 1050, "danmaku": 2697, "category": "手机游戏", "comments": 3858, "av_number": 117347566426249, "bv_number": "BV15NaG63Emz", "favorites": 7472, "video_link": "https://www.bilibili.com/video/BV15NaG63Emz" , "description": "从蒙德吹来的微风,到纳塔燃烧的圣火;\n再到月光洒落的北境,我们的旅途已走过六载。\n \n一路走来,我们循着灯塔的光前行,在祈月之夜相聚;\n也曾踏上月球,在一次次相遇与别离中,收获感动与爱。\n \n世界愈发辽阔,新的故事仍在前方等待。\n愿未来的旅程,依旧有你同行。\n \n旅行者,六周年快乐。\n\n《原神》bilibili服下载地址: https://www.biligame.com/detail/?id=103496" , "uploader_link": "https://space.bilibili.com/401742377" , "uploader_name": "原神", "length_seconds": 128, "cover_image_link": "https://i1.hdslb.com/bfs/archive/efd2d37a76ebdec47e535ea80b5e50366e398e73.jpg" , "publish_date_time": "2026-09-28T18:00:00+08:00"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"bilibili.com/get_video","input":{"video":"BV15NaG63Emz"}}' # 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/get_video" , "input": { "video": "BV15NaG63Emz" }})# 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/get_video" , "input": { "video": "BV15NaG63Emz" } }), 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/get_video# with {"video":"BV15NaG63Emz"}"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", "required": [ "video" ], "properties": { "video": { "type": "string", "description": "A Bilibili video link, BV number, or video title, for example 《原神》六周年主题曲《风的来信》." } }}Output schema
{ "type": "object", "required": [ "title", "uploader_name", "uploader_link", "views", "likes", "coins", "favorites", "danmaku", "comments", "shares", "length", "publish_date_time", "category", "tags", "description", "cover_image_link", "video_link", "bv_number", "av_number", "length_seconds" ], "properties": { "tags": { "type": "array", "items": { "type": "string" } }, "coins": { "type": "integer" }, "likes": { "type": "integer" }, "title": { "type": "string" }, "views": { "type": "integer" }, "length": { "type": "string" }, "shares": { "type": "integer" }, "danmaku": { "type": "integer" }, "category": { "type": [ "string", "null" ] }, "comments": { "type": "integer" }, "av_number": { "type": "integer", "x-fous-developer": true }, "bv_number": { "type": "string", "x-fous-developer": true }, "favorites": { "type": "integer" }, "video_link": { "type": "string" }, "description": { "type": "string" }, "uploader_link": { "type": "string" }, "uploader_name": { "type": "string" }, "length_seconds": { "type": "integer", "x-fous-developer": true }, "cover_image_link": { "type": "string" }, "publish_date_time": { "type": "string", "format": "date-time" } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
bilibili.com/get_video- Returns
- title, uploader, views, likes, coins, favorites, danmaku, comments, shares, length, publish time, category, tags, description, cover, link
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/get_video with the inputs above.
Ask your agent
- How many views, likes and coins does BV1GJ411x7h7 have right now?
- Pull the stats and tags for this Bilibili video: https://www.bilibili.com/video/BV1xx411c7mD
- Who uploaded the video titled 【何同学】我拍了一张600万人的合影 and when was it published?
- Get danmaku count, favorites and comment count for the video 《原神》六周年主题曲《风的来信》
- I need the description, cover image and duration of bilibili video BV1uT4y1P7CX
See more
All Bilibili methodsLists 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.
bilibili.com/list_popular_videosGets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match.
youtube.com/get_videoGets details and engagement statistics for one public TikTok video from its link, including vm.tiktok.com short links: creator, caption, hashtags, posting time, views, likes, comments, shares, length and sound.
tiktok.com/get_videoGets a public Vimeo video's title, creator, play, like and comment counts, length, upload date, description, tags, thumbnail and link from its video link.
vimeo.com/get_videoGets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included.
youtube.com/get_video_commentsReturns the spoken captions and timed segments of a YouTube video, given a video link or a title (top search match). Only captions the video has are returned.
youtube.com/get_video_transcriptGets a public YouTube channel's profile, links and statistics from its name, @handle or link. Subscriber totals may be rounded as YouTube displays them.
youtube.com/get_channelGets a public SoundCloud track and its stats from a title and optional artist, or from a track link. Search picks the artist's matching upload with the most plays; unavailable fields are null.
soundcloud.com/get_track