# 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.

- Page: https://fous.com/methods/bilibili.com/list-popular-videos
- Method: `bilibili.com/list_popular_videos`, version 1
- Website: bilibili.com
- Returns: rank, title, uploader, views, likes, danmaku, length, cover image, video link, BV number
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `category` | string | no | `"all"` | Ranking category, such as music or gaming. One of "all", "anime", "music", "dance", "gaming", "knowledge", "tech", "food", "movies". Default "all". |
| `max_results` | integer | no | `50` | Maximum number of ranked videos to return, for example 50. Default 50. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "category": "all",
  "max_results": 50
}
```

Its output:

```json
{
  "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"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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

## Input schema

```json
{
  "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

```json
{
  "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
}
```

## See more

- [Bilibili API: Get video](https://fous.com/methods/bilibili.com/get-video.md): 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.
- [MyAnimeList API: List top anime](https://fous.com/methods/myanimelist.net/list-top-anime.md): Lists 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.
- [Twitch API: List top categories](https://fous.com/methods/twitch.tv/list-top-categories.md): Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
- [WEBTOON API: List rankings](https://fous.com/methods/webtoons.com/list-rankings.md): Lists 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.
- [Twitch API: List top streams](https://fous.com/methods/twitch.tv/list-top-streams.md): Lists 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.
- [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists 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.
- [Letterboxd API: List popular films](https://fous.com/methods/letterboxd.com/list-popular-films.md): Lists 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.
- [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
- [All Bilibili methods](https://fous.com/methods/bilibili.com.md)