Social

Query Bilibili Video

0calls
4 credits / call

Want to surface detailed Bilibili video information in your app? Whether it's the cover, title, play count, or creator info — this endpoint returns it all in one call.

GET
uapis.cn
/api/v1/social/bilibili/videoinfo
Query parameters
2
aid
string

Video AV number (aid), numeric. Pass either aid or bvid.

bvid
string

Video BV number (bvid), e.g. BV117411r7R1. Pass either aid or bvid.

Overview

Given a video's aid or bvid, the endpoint returns the full metadata, including multi-part information, creator profile, and aggregated statistics.

Response fields

  • copyright (video type): 1 means original, 2 means reposted.
  • owner (creator info): Contains the creator's mid, name, face, and other basic profile fields.
  • stat (statistics): Includes plays, bullet comments, replies, likes, coins, favourites, shares, and other core metrics.
  • pages (parts list): An array describing every part of the video. Single-part videos still return one element.

Query parameters

aid
stringoptional

Video AV number (aid), numeric. Pass either aid or bvid.

bvid
stringoptional

Video BV number (bvid), e.g. BV117411r7R1. Pass either aid or bvid.

Response

200 / OK

Success. Returns the Bilibili video's detailed information.

JSON
{
  // Submission BV number.
  "bvid": "BV17x411w79F",
  // Submission AV number.
  "aid": 75836761,
  // Total part count. Single-part videos return 1.
  "videos": 1,
  // Video subcategory ID.
  "tid": 31,
  // Video subcategory name.
  "tname": "Vocaloid·UTAU",
  // Video type. 1 = original, 2 = reposted.
  "copyright": 2,
  // Submission cover image URL. Can be embedded directly in a web page.
  "pic": "http://i2.hdslb.com/bfs/archive/f769f330138980456159345c6139c8e9b265c2f5.jpg",
  // Submission title.
  "title": "[Official MV] Rick Astley - Never Gonna Give You Up",
  // Submission publish time as Unix timestamp (seconds).
  "pubdate": 1573884313,
  // User submit time as Unix timestamp (seconds).
  "ctime": 1573884313,
  // Video description. May contain HTML-escaped characters.
  "desc": "You got rickrolled",
  // Structured description fragments.
  "desc_v2": [
    {
      // Description text.
      "raw_text": "Video description text",
      // Image type.
      "type": 1,
      // Business ID for the related commercial association.
      "biz_id": 483307278
    }
  ],
  // Video state code.
  "state": 0,
  // Total submission duration (sum across all parts), in seconds.
  "duration": 213,
  // Video permission flag (0 or 1).
  "rights": {
    // Whether the video supports sponsorship/payment (reserved field).
    "bp": 0,
    // Whether sponsor-tipping is enabled.
    "elec": 1,
    // Whether download/caching is allowed.
    "download": 1,
    // Whether it is a movie.
    "movie": 0,
    // Whether the video requires paid viewing.
    "pay": 0,
    // High-bitrate related field.
    "hd5": 0,
    // Whether reposting is banned (1 = banned).
    "no_reprint": 1,
    // Whether autoplay is enabled.
    "autoplay": 1,
    // Whether the video is paid UGC content.
    "ugc_pay": 0,
    // Whether the video is a collaboration.
    "is_cooperation": 0,
    // Whether a free preview is available for paid content.
    "ugc_pay_preview": 1,
    // Background-related control field.
    "no_background": 0,
    // Whether the video is in clean mode.
    "clean_mode": 0,
    // Interactive-theatre related field.
    "is_stein_gate": 0,
    // Whether the video is a 360° panoramic video.
    "is_360": 0,
    // Whether sharing is banned (1 = banned).
    "no_share": 0,
    // Whether the video is paid.
    "arc_pay": 0,
    // Whether free preview is allowed for paid videos.
    "free_watch": 1
  },
  // Video creator information.
  "owner": {
    // Creator UID.
    "mid": 2,
    // Creator nickname.
    "name": "bishi",
    // Creator avatar URL.
    "face": "http://i2.hdslb.com/bfs/face/b0b721e6cb13e31af88cc45c432d6728c3065a6e.jpg"
  },
  // Core video statistics.
  "stat": {
    // AV number.
    "aid": 75836761,
    // Play count.
    "view": 14227982,
    // Bullet-comment count.
    "danmaku": 269829,
    // Reply count.
    "reply": 81682,
    // Favourite count.
    "favorite": 498308,
    // Coin count.
    "coin": 787228,
    // Share count.
    "share": 98661,
    // Like count.
    "like": 989718,
    // Current site/category ranking.
    "now_rank": 0,
    // Historical ranking.
    "his_rank": 0,
    // Dislike count (typically 0).
    "dislike": 0,
    // Evaluation/rating text. Usually empty.
    "evaluation": "",
    // Video-type-related legacy field.
    "vt": 0
  },
  // Dynamic text supplied at submission.
  "dynamic": "",
  // Main part CID (bullet-comment stream ID).
  "cid": 130283995,
  // Video resolution information.
  "dimension": {
    // Video width.
    "width": 1920,
    // Video height.
    "height": 1080,
    // Rotation angle.
    "rotate": 0
  },
  // Record does not exist.
  "no_cache": false,
  // Collaborator list. May be `null` or partial when access is restricted.
  "pages": [
    {
      // Part unique ID. Used to fetch bullet comments.
      "cid": 130283995,
      // Part number, starting at 1.
      "page": 1,
      // Part title. For single-part videos this typically matches the main video title.
      "part": "[Official MV] Rick Astley - Never Gonna Give You Up",
      // Video source.
      "from": "vupload",
      // Part duration, in seconds.
      "duration": 213,
      // External video-source ID. Usually empty.
      "vid": "",
      // External URL. Usually empty.
      "weblink": "",
      // Part video resolution.
      "dimension": {
        // Width.
        "width": 1920,
        // Height.
        "height": 1080,
        // Rotation angle.
        "rotate": 0
      }
    }
  ],
  // Subtitle information.
  "subtitle": {
    // Whether viewer-submitted subtitles are allowed.
    "allow_submit": false,
    // Subtitle list.
    "list": [
      {
        // Subtitle ID.
        "id": 123456,
        // Language code.
        "lan": "zh-CN",
        // Language name.
        "lan_doc": "Chinese (Simplified)",
        // Whether locked.
        "is_lock": false,
        // Subtitle author UID.
        "author_mid": 483307278,
        // Subtitle file URL.
        "subtitle_url": "//i0.hdslb.com/bfs/subtitle/xxxx.json",
        // Subtitle author information.
        "author": {
          // Author UID.
          "mid": 483307278,
          // Author nickname.
          "name": "Subtitle Contributor",
          // Author avatar URL.
          "face": "http://i0.hdslb.com/bfs/face/....jpg"
        }
      }
    ]
  },
  // Joint-submission member list.
  "staff": [
    {
      // Member UID.
      "mid": 111111,
      // Member role label.
      "title": "Creator",
      // Member nickname.
      "name": "Sample User",
      // Member avatar URL.
      "face": "http://i0.hdslb.com/bfs/face/....jpg",
      // Member follower count.
      "follower": 100000
    }
  ],
  // Collection info. `null` when the video is not part of a collection.
  "ugc_season": null,
  // Whether the collection is paid.
  "is_chargeable_season": false,
  // Whether the video is a story-driven episode.
  "is_story": false,
  // Video honour information.
  "honor_reply": {
    // Honour list.
    "honor": [
      {
        // Related AV number.
        "aid": 75836761,
        // Honour type.
        "type": 1,
        // Honour name.
        "desc": "Weekly Must-Watch",
        // Weekly-recommendation index.
        "weekly_recommend_num": 105
      }
    ]
  }
}