Social

Query Bilibili Archives

0calls
4 credits / call

Want to fetch all of a creator's archived videos? Or display a creator's portfolio inside your app? This endpoint makes that easy.

GET
uapis.cn
/api/v1/social/bilibili/archives
Query parameters
5
mid
string
required

Bilibili user mid (user ID).

keywords
string

Search keyword. Optional.

orderby
string

Sort order. pubdate=newest first, views=most played.

ps
string

Page size. Defaults to 20.

pn
string

Page number. Defaults to 1.

Overview

Given a user's mid (user ID), the endpoint returns the creator's archived video list. Keyword search, pagination, and multiple sort orders are supported, so you can flexibly display and analyse the creator's content.

Parameters

  • mid (user ID): Bilibili user mid. Required.
  • keywords (search keywords): Optional. Searches the creator's archives by keyword.
  • orderby (sort order):
    • pubdate: latest published first (default)
    • views: most-played first
  • ps (page size): Defaults to 20.
  • pn (page number): Defaults to 1; used for pagination.

Response fields

  • total (total archives): Total number of submissions by the creator.
  • page (current page): Current page number returned.
  • size (page size): Number of videos returned on this page.
  • videos (video list): Contains every video on the current page:
    • aid: Video AV number
    • bvid: Video BV number
    • title: Video title
    • cover: Cover URL
    • duration: Duration (seconds)
    • play_count: Play count
    • publish_time: Publish timestamp
    • create_time: Create timestamp
    • state: Video state
    • is_ugc_pay: Whether the video is paid (0 = free, 1 = paid)
    • is_interactive: Whether the video is interactive

Query parameters

mid
stringrequired

Bilibili user mid (user ID).

keywords
stringoptional

Search keyword. Optional.

orderby
stringoptional

Sort order. pubdate=newest first, views=most played.

ps
stringoptional

Page size. Defaults to 20.

pn
stringoptional

Page number. Defaults to 1.

Response

200 / OK

Success. Returns the user's archived video list.

JSON
{
  // Total submission count.
  "total": 26,
  // Current page number.
  "page": 1,
  // Page size.
  "size": 20,
  // Video list.
  "videos": [
    {
      // Video AID.
      "aid": 115212162177124,
      // BV number.
      "bvid": "BV1JSpkzbEm6",
      // Title.
      "title": "THE FINALS - 2025-09-16 12-41-39",
      // Cover URL.
      "cover": "http://i0.hdslb.com/bfs/archive/0c8098c4736ce8ab4572fbe54b8d89b09f9e24e2.jpg",
      // Duration (seconds).
      "duration": 468,
      // Play count.
      "play_count": 210,
      // Publish timestamp.
      "publish_time": 1757999542,
      // Create timestamp.
      "create_time": 1757999542,
      // Video state.
      "state": 0,
      // Whether the video is paid. 0=free, 1=paid.
      "is_ugc_pay": 0,
      // Whether the video is interactive.
      "is_interactive": false
    }
  ]
}

400 / Bad Request

Invalid parameter.

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing 'mid' parameter."
}

404 / Not Found

User not found.

JSON
{
  "code": "NOT_FOUND",
  "details": {},
  "message": "User not found."
}

500 / Internal Server Error

Server error.

JSON
{
  "code": "INTERNAL_SERVER_ERROR",
  "details": {},
  "message": "Server error."
}