社交

查询 B站投稿

0次调用
4 积分/次

想要获取UP主的所有投稿视频?或者想在你的应用里展示创作者的作品集?这个接口能帮你轻松实现。

GET
uapis.cn
/api/v1/social/bilibili/archives
查询参数
5
mid
string
required

B站用户的mid(用户ID)

keywords
string

搜索关键词,可为空

orderby
string

排序方式。pubdate=最新发布,views=最多播放

ps
string

每页条数,默认20

pn
string

页码,默认1

功能概述

通过用户的 mid(用户ID),你可以获取该UP主的投稿视频列表。接口支持关键词搜索、分页加载和多种排序方式,让你能够灵活地展示和分析创作者的内容。

参数说明

  • mid (用户ID): B站用户的mid,必填参数。
  • keywords (搜索关键词): 可选,用于在该UP主的投稿中搜索特定关键词。
  • orderby (排序方式):
    • pubdate: 按最新发布排序(默认)
    • views: 按最多播放排序
  • ps (每页条数): 默认20条。
  • pn (页码): 默认1,用于分页。

响应体字段说明

  • total (总稿件数): UP主的投稿总数。
  • page (当前页码): 当前返回的页码。
  • size (每页数量): 每页返回的视频数量。
  • videos (视频列表): 包含当前页的所有视频信息:
    • aid: 视频的AV号
    • bvid: 视频的BV号
    • title: 视频标题
    • cover: 封面URL
    • duration: 时长(秒)
    • play_count: 播放量
    • publish_time: 发布时间戳
    • create_time: 创建时间戳
    • state: 视频状态
    • is_ugc_pay: 是否付费视频(0=免费,1=付费)
    • is_interactive: 是否为互动视频

查询参数

mid
string必填

B站用户的mid(用户ID)

keywords
string可选

搜索关键词,可为空

orderby
string可选

排序方式。pubdate=最新发布,views=最多播放

ps
string可选

每页条数,默认20

pn
string可选

页码,默认1

响应

200 / 请求成功

成功!返回用户的投稿视频列表。

JSON
{
  // 总稿件数
  "total": 26,
  // 当前页码
  "page": 1,
  // 每页数量
  "size": 20,
  // 视频列表
  "videos": [
    {
      // 视频AID
      "aid": 115212162177124,
      // BV号
      "bvid": "BV1JSpkzbEm6",
      // 标题
      "title": "THE FINALS - 2025-09-16 12-41-39",
      // 封面URL
      "cover": "http://i0.hdslb.com/bfs/archive/0c8098c4736ce8ab4572fbe54b8d89b09f9e24e2.jpg",
      // 时长(秒)
      "duration": 468,
      // 播放量
      "play_count": 210,
      // 发布时间戳
      "publish_time": 1757999542,
      // 创建时间戳
      "create_time": 1757999542,
      // 视频状态
      "state": 0,
      // 是否付费视频。0=免费,1=付费
      "is_ugc_pay": 0,
      // 是否为互动视频
      "is_interactive": false
    }
  ]
}

400 / 错误的请求

参数错误

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

404 / 未找到

用户不存在

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

500 / 服务器内部错误

服务器错误

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