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.

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

400 / Bad Request

Invalid parameter.

JSON

404 / Not Found

User not found.

JSON

500 / Internal Server Error

Server error.

JSON