# Bilibili

> Read China's biggest video site: video details and statistics, the Popular page and weekly must-watch list, video and user search, a user's latest uploads, bullet comments (danmaku), live rooms and anime. Start workflows when a user uploads or goes live. No account needed.

App · 10 actions. Web page: https://docs.lodol.com/docs/integrations/bilibili

## Actions

### Get a user's latest videos

Get the videos a user uploaded most recently, newest first, with their views. Up to 30.

**Inputs**

- User (`user`, text, required): The user's number or their profile link, e.g. 546195 or https://space.bilibili.com/546195. Search users finds the number from a name.
- Number of videos (`count`, number): How many of the newest videos to return, up to 30. From 1 to 30. Default: `10`.

**Outputs**

- `count` (number): Videos returned.
- `total_videos` (number): Videos the user has uploaded in all.
- `user` (object)
- `videos` (list)

**Example output**

```json
{
  "count": 2,
  "total_videos": 682,
  "user": {
    "id": "546195",
    "name": "\u8001\u756a\u8304",
    "url": "https://space.bilibili.com/546195"
  },
  "videos": [
    {
      "aid": 117451568191221,
      "author": {
        "avatar_url": "https://i0.hdslb.com/bfs/face/bc5ca101313d4db223c395d64779e76eb3482d60.jpg",
        "id": "546195",
        "name": "\u8001\u756a\u8304",
        "url": "https://space.bilibili.com/546195"
      },
      "bvid": "BV1gKJ86JEuP",
      "category": null,
      "cover_url": "https://i2.hdslb.com/bfs/archive/e858b6164334a31c2703cd38ef517f13210ef42d.jpg",
      "description": "\u6e38\u620f\uff1ai'm not a robot",
      "duration_label": "24:02",
      "duration_seconds": 1442,
      "published_at": "2026-10-17T03:30:00Z",
      "stats": {
        "coins": null,
        "comments": null,
        "danmaku": null,
        "favorites": null,
        "likes": null,
        "shares": null,
        "views": 2986958
      },
      "title": "\u6211\u662f\u4eba\u7c7b",
      "url": "https://www.bilibili.com/video/BV1gKJ86JEuP"
    },
    {
      "aid": 117411353204712,
      "author": {
        "avatar_url": "https://i0.hdslb.com/bfs/face/bc5ca101313d4db223c395d64779e76eb3482d60.jpg",
        "id": "546195",
        "name": "\u8001\u756a\u8304",
        "url": "https://space.bilibili.com/546195"
      },
      "bvid": "BV1iqpt6cEMU",
      "category": null,
      "cover_url": "https://i0.hdslb.com/bfs/archive/84f14dcd2b10126466fa6cc5ac8e090faaa4304b.jpg",
      "description": "\u6e38\u620f\uff1a\u5348\u591c\u8f6e\u73ed\n\u5982\u679c\u559c\u6b22\u770b\u6211\u4eec\u73a9\u591a\u4eba\u6e38\u620f\uff0c\u80fd\u4e0d\u80fd\u7ed9\u8fd9\u4e2a\u89c6\u9891\u70b9\u4e2a\u8d5e\uff01\uff01\u6211\u4e00\u5b9a\u5c3d\u5feb\u66f4\u65b0\uff01\uff01",
      "duration_label": "48:13",
      "duration_seconds": 2893,
      "published_at": "2026-10-10T06:30:00Z",
      "stats": {
        "coins": null,
        "comments": null,
        "danmaku": null,
        "favorites": null,
        "likes": null,
        "shares": null,
        "views": 3064881
      },
      "title": "\u8d85\u5e02\u91cc\u2026\u2026\u672a\u68c0\u6d4b\u5230\u4eba\u8138\u2026\u2026",
      "url": "https://www.bilibili.com/video/BV1iqpt6cEMU"
    }
  ]
}
```

### Get anime or show details

Get a show from Bilibili's licensed anime, film and TV catalogue (番剧, 影视): synopsis, rating, release status, genres, statistics and every episode.

**Inputs**

- Show (`show`, text, required): The show's or an episode's link, e.g. https://www.bilibili.com/bangumi/play/ss33622, or an id such as ss33622, ep327107 or md28229051.

**Outputs**

- `cover_url` (text): The show's poster.
- `description` (text): The show's synopsis.
- `episode_count` (number): Episodes listed.
- `episodes` (list)
- `finished` (true/false): True once every episode is out.
- `genres` (list)
- `media_id` (number): The show's media id.
- `rating` (number): Average rating out of 10.
- `rating_count` (number): Ratings given.
- `regions` (list)
- `released_at` (text): When it was first released, ISO 8601 in UTC.
- `season_id` (number): The show's season id.
- `stats` (object)
- `status` (text): Release status, e.g. '已完结, 全25集' (finished, 25 episodes).
- `title` (text): The show's title.
- `type` (text): 'Anime', 'Film', 'Documentary', 'Chinese animation', 'TV series', 'Variety show' or 'Other'.
- `url` (text): The show's page on bilibili.com.

**Example output**

```json
{
  "cover_url": "https://i0.hdslb.com/bfs/bangumi/image/f9b7d89acb62d2ed385381ebcf5ac80b65fadd73.jpg",
  "description": "\u4e1c\u80dc\u795e\u5dde\u7684\u50b2\u6765\u56fd\u82b1\u679c\u5c71\u7684\u4e00\u5757\u5de8\u77f3\u5b55\u80b2\u51fa\u4e86\u4e00\u53ea\u7075\u660e\u77f3\u7334\uff08\u516d\u5c0f\u9f84\u7ae5 \u9970\uff09\uff0c\u77f3\u7334\u540e\u6765\u62dc\u987b\u83e9\u63d0\u4e3a\u5e08\u540e\u4e60\u5f97\u4e86\u4e03\u5341\u4e8c\u53d8\uff0c\u5177\u6709\u4e86\u901a\u5929\u672c...",
  "episode_count": 25,
  "episodes": [
    {
      "badge": null,
      "bvid": "BV1kv411z7F2",
      "duration_seconds": 2668,
      "episode_id": 327107,
      "number": "1",
      "released_at": "2020-06-12T04:00:00Z",
      "title": "\u7334\u738b\u521d\u95ee\u4e16",
      "url": "https://www.bilibili.com/bangumi/play/ep327107"
    },
    {
      "badge": null,
      "bvid": "BV1NA411q7xW",
      "duration_seconds": 2933,
      "episode_id": 327108,
      "number": "2",
      "released_at": "2020-06-12T04:00:00Z",
      "title": "\u5b98\u5c01\u5f3c\u9a6c\u6e29",
      "url": "https://www.bilibili.com/bangumi/play/ep327108"
    }
  ],
  "finished": true,
  "genres": [
    "\u5947\u5e7b",
    "\u5267\u60c5",
    "\u53e4\u88c5"
  ],
  "media_id": 28229051,
  "rating": 9.9,
  "rating_count": 45187,
  "regions": [
    "\u4e2d\u56fd\u5927\u9646"
  ],
  "released_at": "2020-06-12T04:00:00Z",
  "season_id": 33622,
  "stats": {
    "coins": 707037,
    "comments": 210094,
    "danmaku": 4423970,
    "followers": 1837562,
    "likes": 2499801,
    "shares": 143592,
    "views": 392578742
  },
  "status": "\u5df2\u5b8c\u7ed3, \u516825\u96c6",
  "title": "\u897f\u6e38\u8bb0",
  "type": "TV series",
  "url": "https://www.bilibili.com/bangumi/play/ss33622"
}
```

### Get bullet comments

Get the bullet comments (弹幕, danmaku) that scroll over a video, each with the moment it appears and when it was sent, in the order they appear. Useful for spotting a video's highlights or gauging reactions.

**Inputs**

- Video (`video`, text, required): The video's link, or its BV or av id.
- Part (`part`, number): For a video in several parts (P1, P2...), which one. Defaults to the first. At least 1. Default: `1`.
- Maximum comments (`limit`, number): Return at most this many, from the start of the video. Up to 5000. From 1 to 5000. Default: `200`.

**Outputs**

- `comments` (list): The bullet comments, in the order they appear in the video.
- `count` (number): Bullet comments returned.
- `total` (number): Bullet comments Bilibili sent for this part.
- `video` (object)

**Example output**

```json
{
  "comments": [
    {
      "color": "#FFFFFF",
      "position": "top",
      "sent_at": "2026-10-17T03:40:19Z",
      "text": "\u4e0d\uff0c\u4f60\u662f\u5149\uff0c\u590d\u65e6\u4e4b\u5149(doge)\u3002",
      "time_label": "00:00",
      "time_seconds": 0.0
    },
    {
      "color": "#E70012",
      "position": "top",
      "sent_at": "2026-10-17T15:45:32Z",
      "text": "\u5e2e\u52a9\u6211\u4eec\u6218\u80dc\u673a\u5668\u4eba",
      "time_label": "00:00",
      "time_seconds": 0.0
    },
    {
      "color": "#E70013",
      "position": "top",
      "sent_at": "2026-10-17T09:32:21Z",
      "text": "\u6211\u770b\u672a\u5fc5",
      "time_label": "00:00",
      "time_seconds": 0.0
    }
  ],
  "count": 3,
  "total": 3600,
  "video": {
    "aid": 117451568191221,
    "bvid": "BV1gKJ86JEuP",
    "part": 1,
    "part_title": "\u6211\u662f\u4eba\u7c7b\u2026\u2026\u5417",
    "url": "https://www.bilibili.com/video/BV1gKJ86JEuP"
  }
}
```

### Get live room

Check a live room: whether it is streaming, since when, its title, area, tags and the streamer's followers.

**Inputs**

- Live room (`room`, text, required): The room's link or number, e.g. https://live.bilibili.com/21852.

**Outputs**

- `area` (text): What the room streams, e.g. '其他单机'.
- `cover_url` (text): The room's cover image.
- `description` (text): The room's description, as plain text.
- `followers` (number): The streamer's followers.
- `is_live` (true/false): True while it is streaming.
- `parent_area` (text): The broader area, e.g. '单机游戏' (single-player games).
- `popularity` (number): Bilibili's popularity figure for the stream; 0 offline.
- `room_id` (number): The room's number.
- `short_id` (number): The room's short number, if it has one.
- `started_at` (text): When the current stream started, ISO 8601 in UTC.
- `status` (text): 'live', 'offline', or 'replaying' (showing past streams).
- `streamer_id` (text): The streamer's user number.
- `streamer_url` (text): The streamer's profile page.
- `tags` (list): Tags.
- `title` (text): The room's current title.
- `url` (text): The room's page on live.bilibili.com.

**Example output**

```json
{
  "area": "\u5176\u4ed6\u5355\u673a",
  "cover_url": "https://i0.hdslb.com/bfs/live/new_room_cover/0dcada362def910150cb088f945d9353a821f32f.jpg",
  "description": "\uff01\uff01\uff01\uff01\uff01\uff01\uff01\uff01\uff01\uff01",
  "followers": 20853424,
  "is_live": false,
  "parent_area": "\u5355\u673a\u6e38\u620f",
  "popularity": 0,
  "room_id": 21852,
  "short_id": null,
  "started_at": null,
  "status": "offline",
  "streamer_id": "546195",
  "streamer_url": "https://space.bilibili.com/546195",
  "tags": [
    "\u8001\u756a\u8304"
  ],
  "title": "\u6700\u70e7\u8111\u7684\u4e00\u96c6",
  "url": "https://live.bilibili.com/21852"
}
```

### Get popular videos

Get the videos on Bilibili's Popular page (热门) right now, with their statistics and why each is featured.

**Inputs**

- Number of videos (`count`, number): How many videos to return, up to 50. From 1 to 50. Default: `20`.
- Page (`page`, number): Which page of results. Starts at 1. From 1 to 100. Default: `1`.

**Outputs**

- `count` (number): Videos on this page.
- `has_more` (true/false): True when there is another page.
- `page` (number): The page returned.
- `videos` (list)

**Example output**

```json
{
  "count": 2,
  "has_more": true,
  "page": 1,
  "videos": [
    {
      "aid": 117466583799078,
      "author": {
        "avatar_url": "https://i0.hdslb.com/bfs/face/c1733474892caa45952b2c09a89323157df7129a.jpg",
        "id": "946974",
        "name": "\u5f71\u89c6\u98d3\u98ce",
        "url": "https://space.bilibili.com/946974"
      },
      "bvid": "BV1pGnn67EbB",
      "category": "\u793e\u4f1a\u89c2\u5bdf",
      "cover_url": "https://i2.hdslb.com/bfs/archive/1bf5beb95e275c81e31f84f4798fdc1eaba4295f.jpg",
      "description": "\u8fd9\u4e00\u6b21\uff0c\u6211\u4eec\u7684\u7f16\u5bfc\u6000\u8c37\u5e26\u7740\u767e\u4e07\u652f\u7968\uff0c\u53c8\u53bb\u63a2\u7d22\u4e86\u4e00\u4e9b\u602a\u8bde\u800c\u771f\u5b9e\u7684\u6545\u4e8b\u3002\u6211\u4eec\u8d70\u8fdb\u4e86\u6d77\u5916\u6210\u4eba\u5185\u5bb9\u521b\u4f5c\u8005\u7684\u4e16\u754c\uff0c\u60f3\u548c\u4f60\u4e00\u8d77\u770b\u770b\uff0c\u8fd9\u4e2a\u795e\u79d8\u3001\u75af\u72c2\u53c8\u5145\u6ee1\u4e89\u8bae\u7684\u884c\u4e1a\uff0c\u7a76\u7adf\u662f\u600e\u4e48\u8fd0\u4f5c\u7684\uff1f\u5728\u8fd9\u4e9b\u60ca\u4eba\u7684\u6536\u5165\u80cc\u540e\uff0c\u53c8\u6709\u4ec0\u4e48\u6837\u7684\u79d8\u5bc6\uff1f\n*\u672c\u89c6\u9891\u4ec5\u4f5c\u6587\u5316\u73b0\u8c61\u79d1...",
      "duration_label": "44:42",
      "duration_seconds": 2682,
      "published_at": "2026-10-19T09:00:00Z",
      "reason": "\u767e\u4e07\u64ad\u653e",
      "stats": {
        "coins": 86437,
        "comments": 3982,
        "danmaku": 15909,
        "favorites": 39103,
        "likes": 118214,
        "shares": 25078,
        "views": 1354357
      },
      "title": "\u5e26\u7740100\u4e07\uff0c\u6211\u4eec\u89c1\u4e86\u6210\u4eba\u7f51\u7ea2...",
      "url": "https://www.bilibili.com/video/BV1pGnn67EbB"
    },
    {
      "aid": 117427778098783,
      "author": {
        "avatar_url": "https://i0.hdslb.com/bfs/face/a3b26154185c3dc7558c2f611258a58233b36a8b.jpg",
        "id": "265504053",
        "name": "\u5361\u8328\u8981\u52a0\u6cb9",
        "url": "https://space.bilibili.com/265504053"
      },
      "bvid": "BV1G5po6zECY",
      "category": "\u5f71\u89c6\u7efc\u5408",
      "cover_url": "https://i0.hdslb.com/bfs/archive/a71ecf9c3efae8c18459b2ad0a2207934a226da4.jpg",
      "description": "\u81ea\u5236\u65e0\u969c\u788d\u7535\u5f71\uff0c\u53ea\u4e3a\u5e2e\u52a9\u76f2\u4eba\u5c0f\u670b\u53cb\uff0c\u7eaf\u516c\u76ca",
      "duration_label": "1:42:15",
      "duration_seconds": 6135,
      "published_at": "2026-10-17T11:00:00Z",
      "reason": "\u767e\u4e07\u64ad\u653e",
      "stats": {
        "coins": 55481,
        "comments": 3220,
        "danmaku": 361,
        "favorites": 20293,
        "likes": 118311,
        "shares": 6071,
        "views": 1997107
      },
      "title": "\u3010\u76f2\u4eba\u65e0\u969c\u788d\u7535\u5f71\u3011\u51b0\u96ea\u5947\u7f18\u7b2c\u4e00\u90e8",
      "url": "https://www.bilibili.com/video/BV1G5po6zECY"
    }
  ]
}
```

### Get user profile

Get a user's public profile: name, bio, level, followers, videos uploaded, likes received and verification.

**Inputs**

- User (`user`, text, required): The user's number or their profile link, e.g. 546195 or https://space.bilibili.com/546195. Search users finds the number from a name.

**Outputs**

- `article_count` (number): Articles the user has posted.
- `avatar_url` (text): The user's profile picture.
- `bio` (text): The user's bio.
- `followers` (number): Followers.
- `following` (number): Accounts the user follows.
- `gender` (text): 'male', 'female' or 'not shown'.
- `id` (text): The user's number.
- `level` (number): The user's account level, 0 to 6.
- `likes_received` (number): Likes across everything the user has posted.
- `name` (text): The user's name.
- `premium_label` (text): The membership's name, e.g. '年度大会员'.
- `premium_member` (true/false): True for a paying member (大会员).
- `url` (text): The user's profile page.
- `verified` (true/false): True for an account Bilibili has verified.
- `verified_title` (text): What Bilibili verified the user as, e.g. '2025百大UP主' (one of 2025's top 100 creators).
- `video_count` (number): Videos the user has uploaded.

**Example output**

```json
{
  "article_count": 0,
  "avatar_url": "https://i0.hdslb.com/bfs/face/bc5ca101313d4db223c395d64779e76eb3482d60.jpg",
  "bio": "\u65b0\u6d6a\u5fae\u535a\uff1a_\u8001\u756a\u8304_",
  "followers": 20853424,
  "following": 7,
  "gender": "male",
  "id": "546195",
  "level": 6,
  "likes_received": 196328640,
  "name": "\u8001\u756a\u8304",
  "premium_label": "\u5e74\u5ea6\u5927\u4f1a\u5458",
  "premium_member": true,
  "url": "https://space.bilibili.com/546195",
  "verified": true,
  "verified_title": "2025\u767e\u5927UP\u4e3b\u30012025\u5e74\u5ea6\u5546\u4e1a\u5f71\u54cd\u529b\u5956UP\u4e3b\u30012022\u5e74\u5ea6\u8054\u5408\u521b\u4f5c\u5956UP\u4e3b",
  "video_count": 682
}
```

### Get video details

Get a video's title, description, uploader, length, parts and its views, likes, coins, favorites, shares, comments and bullet comments. Takes the video's link or id.

**Inputs**

- Video (`video`, text, required): The video's link, or its BV or av id.

**Outputs**

- `aid` (number): The video's older numeric id (its av number).
- `author` (object): The user who uploaded the video.
- `bvid` (text): The video's id, e.g. 'BV1gKJ86JEuP'. Works in every video field.
- `category` (text): The video's category, e.g. '单机游戏'. Empty when the source does not report one.
- `cover_url` (text): The video's cover image.
- `description` (text): The uploader's description of the video.
- `duration_label` (text): Length as a clock, e.g. '24:02' or '1:02:03'.
- `duration_seconds` (number): Length in seconds (all parts together).
- `honors` (list): Bilibili's honors for the video, e.g. '全站排行榜最高第13名' (reached number 13 in the site-wide ranking).
- `original` (true/false): True when the uploader made the video, false for a repost.
- `part_count` (number): How many parts (P1, P2...) the video has.
- `parts` (list): Each part of the video, in order.
- `published_at` (text): When the video was published, ISO 8601 in UTC.
- `stats` (object): The video's counts. A figure the source does not report is empty: search results have no coins or shares, a user's uploads only views.
- `title` (text): The video's title.
- `url` (text): The video's page on bilibili.com.

**Example output**

```json
{
  "aid": 117451568191221,
  "author": {
    "avatar_url": "https://i0.hdslb.com/bfs/face/bc5ca101313d4db223c395d64779e76eb3482d60.jpg",
    "id": "546195",
    "name": "\u8001\u756a\u8304",
    "url": "https://space.bilibili.com/546195"
  },
  "bvid": "BV1gKJ86JEuP",
  "category": null,
  "cover_url": "https://i2.hdslb.com/bfs/archive/e858b6164334a31c2703cd38ef517f13210ef42d.jpg",
  "description": "\u6e38\u620f\uff1ai'm not a robot",
  "duration_label": "24:02",
  "duration_seconds": 1442,
  "honors": [
    "\u5168\u7ad9\u6392\u884c\u699c\u6700\u9ad8\u7b2c13\u540d",
    "\u70ed\u95e8\u6536\u5f55"
  ],
  "original": false,
  "part_count": 1,
  "parts": [
    {
      "duration_label": "24:02",
      "duration_seconds": 1442,
      "number": 1,
      "title": "\u6211\u662f\u4eba\u7c7b\u2026\u2026\u5417"
    }
  ],
  "published_at": "2026-10-17T03:30:00Z",
  "stats": {
    "coins": 20872,
    "comments": 1823,
    "danmaku": 6591,
    "favorites": 26481,
    "likes": 156047,
    "shares": 2586,
    "views": 2986958
  },
  "title": "\u6211\u662f\u4eba\u7c7b",
  "url": "https://www.bilibili.com/video/BV1gKJ86JEuP"
}
```

### Get weekly must-watch videos

Get an issue of Bilibili's weekly must-watch list (每周必看), the videos its editors picked from the week, published every Friday. Returns the latest issue unless you choose one.

**Inputs**

- Issue number (`issue`, number): Which issue, e.g. 395. Leave empty for the latest. At least 1.

**Outputs**

- `count` (number): Videos in the issue.
- `issue` (number): The issue's number, e.g. 395.
- `name` (text): The issue's name, e.g. '2026第395期 10.09 - 10.15'.
- `theme` (text): The issue's headline, chosen by Bilibili's editors.
- `videos` (list)
- `week_end` (text): Last day of the week it covers (YYYY-MM-DD, Beijing).
- `week_start` (text): First day of the week it covers (YYYY-MM-DD, Beijing).

**Example output**

```json
{
  "count": 2,
  "issue": 395,
  "name": "2026\u7b2c395\u671f 10.09 - 10.15",
  "theme": "\u5c31\u4f60\u53eb\u5609\u8c6a\u554a",
  "videos": [
    {
      "aid": 117410111685753,
      "author": {
        "avatar_url": "https://i1.hdslb.com/bfs/face/d998552d68d626f39c8370e0b45b82fe9fc6cc5a.jpg",
        "id": "395119522",
        "name": "\u827a\u672f\u5bb6\u4e0d2\u771f\u4eba",
        "url": "https://space.bilibili.com/395119522"
      },
      "bvid": "BV1Nap461E9p",
      "category": "\u540c\u4eba\u52a8\u753b",
      "cover_url": "https://i0.hdslb.com/bfs/archive/bd67579679d269219ae8b9d74f0bb3d215943473.jpg",
      "description": "\u539f\u521b\u5267\u60c5\uff0c\u5982\u6709\u96f7\u540c\u7eaf\u5c5e\u5de7\u5408",
      "duration_label": "05:55",
      "duration_seconds": 355,
      "published_at": "2026-10-09T08:57:43Z",
      "reason": "\u6700\u8c6a\u5e7b\u60f3",
      "stats": {
        "coins": 5640,
        "comments": 1840,
        "danmaku": 1468,
        "favorites": 18512,
        "likes": 74656,
        "shares": 3381,
        "views": 2033090
      },
      "title": "\u3010\u8c6a\u7269\u8bed\u3011\uff1a\u5c31\u4f60\u53eb\u5609\u8c6a\u554a \u3010UP\u52a8\u753b\u3011",
      "url": "https://www.bilibili.com/video/BV1Nap461E9p"
    },
    {
      "aid": 117403820230630,
      "author": {
        "avatar_url": "https://i0.hdslb.com/bfs/face/4521bc1010b9d51fcc7775552c415394f45538a5.jpg",
        "id": "178778949",
        "name": "\u82f1\u96c4\u8054\u76df",
        "url": "https://space.bilibili.com/178778949"
      },
      "bvid": "BV1DRHU6LELy",
      "category": "MV",
      "cover_url": "https://i0.hdslb.com/bfs/archive/4260b5a0d7a5aac474f13b1ee6b90b9cc1f37b6a.jpg",
      "description": "\u6700\u4f1f\u5927\u7684\u51a0\u519b\uff0c\u4ee5\u575a\u97e7\u548c\u51b3\u5fc3\u6218\u80dc\u4e86\u4e00\u5207\u963b\u788d\uff0c\u8ba9\u4e0d\u53ef\u80fd\u6210\u4e3a\u53ef\u80fd\u3002\n\u771f\u5b9e\u4f24\u5bb3\u57282026\u5168\u7403\u603b\u51b3\u8d5b\u5b98\u65b9\u4e3b\u9898\u66f2\u300aKNOW MY NAME\u300b\u7684\u97f3\u4e50\u89c6\u9891\u4e2d\u767b\u573a\uff0c\u7559\u4e0b\u5c5e\u4e8e\u4ed6\u4eec\u7684\u5370\u8bb0\u3002\u672c\u66f2\u7531i-dle\u6210\u5458SOYEON\u3001Coco Jones\u3001Vic Me...",
      "duration_label": "04:17",
      "duration_seconds": 257,
      "published_at": "2026-10-09T01:00:00Z",
      "reason": "\u5413\u54ed\u4e86",
      "stats": {
        "coins": 91143,
        "comments": 27844,
        "danmaku": 14099,
        "favorites": 50264,
        "likes": 175859,
        "shares": 116128,
        "views": 4569693
      },
      "title": "2026\u82f1\u96c4\u8054\u76df\u5168\u7403\u603b\u51b3\u8d5b\u4e3b\u9898\u66f2\u300aKNOW MY NAME\u300b\uff08\u4ee5\u6211\u4e4b\u540d\uff09",
      "url": "https://www.bilibili.com/video/BV1DRHU6LELy"
    }
  ],
  "week_end": "2026-10-15",
  "week_start": "2026-10-09"
}
```

### Search users

Find Bilibili users (uploaders, UP主, and streamers) by name, with their number, followers and video count. Use the number in the other steps' User field.

**Inputs**

- Name (`keyword`, text, required): The name, or part of it, to search for.
- Page (`page`, number): Which page of results, 20 to a page. Starts at 1. From 1 to 50. Default: `1`.

**Outputs**

- `count` (number): Users on this page.
- `keyword` (text): What was searched for.
- `page` (number): The page returned.
- `total_results` (number): Matches, at most 1000.
- `users` (list)

**Example output**

```json
{
  "count": 2,
  "keyword": "\u8001\u756a\u8304",
  "page": 1,
  "total_results": 1000,
  "users": [
    {
      "avatar_url": "https://i0.hdslb.com/bfs/face/bc5ca101313d4db223c395d64779e76eb3482d60.jpg",
      "bio": "\u65b0\u6d6a\u5fae\u535a\uff1a_\u8001\u756a\u8304_",
      "followers": 20853424,
      "id": "546195",
      "is_live": false,
      "level": 6,
      "live_room_url": "https://live.bilibili.com/21852",
      "name": "\u8001\u756a\u8304",
      "url": "https://space.bilibili.com/546195",
      "verified_title": null,
      "video_count": 681
    },
    {
      "avatar_url": "https://i1.hdslb.com/bfs/face/c95178f76e64c175b07a8b8be4a035934a4edf28.jpg",
      "bio": "PPOMO\u7684\u5c0f\u5c0f\u642c\u8fd0\u5de5",
      "followers": 96738,
      "id": "609013982",
      "is_live": false,
      "level": 5,
      "live_room_url": "https://live.bilibili.com/23684798",
      "name": "PPOMO\u8001\u756a\u8304",
      "url": "https://space.bilibili.com/609013982",
      "verified_title": null,
      "video_count": 96
    }
  ]
}
```

### Search videos

Search Bilibili's videos by keyword, 20 to a page, sorted by best match, views, date, bullet comments or favorites, and optionally only videos of a certain length.

**Inputs**

- Search for (`keyword`, text, required): Words to search for. Chinese works best.
- Sort by (`sort`, text): The order of the results. One of: `relevance` (Best match), `most_viewed` (Most viewed), `newest`, `most_danmaku` (Most bullet comments), `most_favorited` (Most favorited). Default: `relevance`.
- Video length (`duration`, text): Only videos of this length. One of: `any` (Any length), `under_10_minutes` (Under 10 minutes), `10_to_30_minutes` (10 to 30 minutes), `30_to_60_minutes` (30 to 60 minutes), `over_60_minutes` (Over 60 minutes). Default: `any`.
- Page (`page`, number): Which page of results, 20 to a page. Starts at 1. From 1 to 50. Default: `1`.

**Outputs**

- `count` (number): Videos on this page.
- `keyword` (text): What was searched for.
- `page` (number): The page returned.
- `total_pages` (number): Pages of 20 available.
- `total_results` (number): Matches Bilibili reports, at most 1000.
- `videos` (list)

**Example output**

```json
{
  "count": 2,
  "keyword": "\u539f\u795e",
  "page": 1,
  "total_pages": 50,
  "total_results": 1000,
  "videos": [
    {
      "aid": 712909579,
      "author": {
        "avatar_url": "https://i2.hdslb.com/bfs/face/e63bacc8b9e68f59f401cc41728a99262ba661a3.jpg",
        "id": "401742377",
        "name": "\u539f\u795e",
        "url": "https://space.bilibili.com/401742377"
      },
      "bvid": "BV1hD4y1X7Rm",
      "category": "\u624b\u673a\u6e38\u620f",
      "cover_url": "https://i1.hdslb.com/bfs/archive/4e9c587771ce117415f8c5782b880fe88980fa7c.jpg",
      "description": "\u300a\u7483\u6708\u6625\u79cb\u300b\u6563\u573a\u4e4b\u540e\uff0c\u542c\u4e66\u4eba\u7ad9\u5728\u7ed8\u6709\u5c71\u6cb3\u7684\u753b\u5c4f\u524d\uff0c\u4e0d\u77e5\u662f\u5426\u5728\u671f\u5f85\u6614\u65e5\u7684\u56de\u54cd\u3002\n\u4f46\u5c4f\u98ce\u4e0a\u7684\u56fe\u753b\u53ea\u4f1a\u6c89\u9ed8\uff0c\u56e0\u4e3a\u90a3\u5df2\u662f\u4e09\u5343\u5e74\u524d\u7684\u5f80\u4e8b\u4e86\u3002\n\nCV\uff1a\n\u949f\u79bb\u2014\u2014\u5f6d\u535a\n\u7530\u94c1\u5634\u2014\u2014\u8bb8\u68d5\u54f2\n\n\u300a\u539f\u795e\u300bbilibili\u670d\u4e0b\u8f7d\u5730\u5740\uff1a\nhttp://www...",
      "duration_label": "07:38",
      "duration_seconds": 458,
      "published_at": "2020-11-30T04:00:08Z",
      "stats": {
        "coins": null,
        "comments": 417237,
        "danmaku": 318760,
        "favorites": 771828,
        "likes": 1730303,
        "shares": null,
        "views": 58718294
      },
      "title": "\u300a\u539f\u795e\u300b\u89d2\u8272\u6f14\u793a-\u300c\u949f\u79bb\uff1a\u542c\u4e66\u4eba\u300d",
      "url": "https://www.bilibili.com/video/BV1hD4y1X7Rm"
    },
    {
      "aid": 115180084202200,
      "author": {
        "avatar_url": "https://i0.hdslb.com/bfs/face/2e32de7b28fc491a28281a22c6ea9f5d195cbdf5.jpg",
        "id": "431073645",
        "name": "\u4f60\u7684\u5f71\u6708\u6708",
        "url": "https://space.bilibili.com/431073645"
      },
      "bvid": "BV1CMHQzsEJV",
      "category": "\u624b\u673a\u6e38\u620f",
      "cover_url": "https://i2.hdslb.com/bfs/archive/f26e0f02c6cee18cfb348f4631f318a9d2636e8f.jpg",
      "description": "\u672c\u89c6\u9891\u5305\u542b\u4ee5\u4e0b\u4efb\u52a1\uff1a\n\u83ab\u96f7\u8c37\u7684\u4f19\u4f34\u4eec\u3001\u54c0\u94c3\u7684\u4f59\u54cd\u3001\u8981\u4e8b\u4f18\u5148\u3001\u63f4\u52a9\u5c0f\u961f\u7684\u8bc9\u8bf4\u3001\u53a8\u5b50\u7684\u8bc9\u8bf4\n\u5b9d\u7bb1\u6210\u5c31\u603b\u6570\uff1a299\n13\u4e2a\u9650\u65f6\u6311\u6218\n112\u6708\u795e\u77b3+93\u6469\u62c9\u7bb1+12\u7389\u5e1b\n\u6708\u4e4b\u5370\u5347\u7ea73\u805a\u6240\u6ee1\u7ea7\u540e\u5269\u4f59247(\u6708\u4e4b1-3\u7248\u672c\u4e00\u4e2a\u90fd\u4e0d\u7f3a\u7684\u60c5\u51b5\u4e0b)\n\u6708...",
      "duration_label": "4:26:42",
      "duration_seconds": 16002,
      "published_at": "2025-09-10T13:05:22Z",
      "stats": {
        "coins": null,
        "comments": 12947,
        "danmaku": 186438,
        "favorites": 209239,
        "likes": 232231,
        "shares": null,
        "views": 45184394
      },
      "title": "\u3010\u539f\u795e\u4e00\u6761\u9f99\u5168\u6536\u96c6\u3011\u632a\u5fb7\u5361\u83b1\u6708\u4e4b\u4e00(\u6210\u5c31\u6570299/\u6708\u795e\u77b3112/\u6469\u62c993)\u4f26\u6ce2\u5c9b+\u5e0c\u6c50\u5c9b+\u5e15\u54c8\u5c9b/\u5b9d\u7bb1/\u6469\u62c9\u5806/\u7389\u5e1b/\u6708\u4e4b\u5370/\u63a2\u7d22\u5ea6/\u539f\u795e6.0\u4e00\u6761\u9f99",
      "url": "https://www.bilibili.com/video/BV1CMHQzsEJV"
    }
  ]
}
```
