Skip to content
All Bilibili APIs
Accounts & creatorsBilibiliUser Video · List

Bilibili user videos

Read an uploader's public Bilibili videos by UID and page, sorted by newest, most played, or most favorited.

POST/v1/bilibili/users/videos

Chinese name: B站用户投稿 · 用户视频 · 列表 按 UID 和页码读取 B站 UP 主的公开投稿视频,可按最新、最多播放或最多收藏排序。
bilibili.users.videos@v1

Price per call

¥0.02/ call

Nonempty complete results are charged; empty, partial, and failed results are not.

Current statusAvailableChecking live status
Checking live status

Try it

Sign in and run one real call. The result and charge appear right here.

Security check

Loading the security check…

Checking live execution status…

Execution result

// Result

Request parameters

uidstringrequired

pattern: "^\\d{1,20}$" · minLength: 1 · maxLength: 256

Example: "178360345"

orderstringoptional

enum: "pubdate" | "click" | "stow" · default: "pubdate"

Example: "pubdate"

pageintegeroptional

default: 1 · minimum: 1 · maximum: 100

Example: 1

page_sizeintegeroptional

default: 30 · minimum: 1 · maximum: 50

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "uid": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^\\d{1,20}$"
    },
    "order": {
      "default": "pubdate",
      "type": "string",
      "enum": [
        "pubdate",
        "click",
        "stow"
      ]
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "page_size": {
      "default": 30,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "uid"
  ],
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/bilibili/users/videos \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"uid":"178360345","order":"pubdate","page":1}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_bilibili_users_videos",
  "message": "success",
  "data": {
    "items": [
      {
        "bvid": "BV1M1421t7hT",
        "aid": 1156219960,
        "title": "公开视频标题",
        "created": 1718000000,
        "length": "05:12",
        "play": 120000,
        "comment": 450,
        "video_review": 800,
        "mid": 178360345,
        "author": "Public UP"
      }
    ]
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "bilibili.users.videos",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.02",
    "balance_after": "49.98",
    "currency": "CNY"
  }
}
Response fields
codenumber
const: 200
request_idstring
messagestring
const: "success"
dataobject
pageobject
warningsarray
metaobject
Response JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "bvid": {},
              "aid": {},
              "title": {},
              "description": {},
              "created": {},
              "length": {},
              "play": {},
              "comment": {},
              "video_review": {},
              "mid": {},
              "author": {}
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "bilibili.users.videos"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

  • Use it to review an uploader's public videos and publishing cadence.

Not for

  • Do not use it for collections, feed posts, articles, or private content.

Known limitations

  • It covers at most the first 5,000 videos (page ≤ 100, page_size ≤ 50).
  • play is the view count and video_review the danmaku count.
  • Page-number paging can repeat or skip items between pages.
  • Counts are point-in-time public snapshots, not live or historical trends.

Billing

¥0.02 per call. Nonempty complete results are charged; empty, partial, and failed results are not.

See all pricing →