---
title: "Bilibili API Docs &amp; Endpoint Directory"
description: "Choose third-party Bilibili data APIs by keyword, BVID or UID. Find the AID/CID requirements for comments, danmaku and captions, with Python guides."
---

# Bilibili API Docs & Endpoint Directory

JustOneAPI provides third-party Bilibili data APIs for video discovery, media analysis, and creator research. Start with the information you have, then choose the content and identifiers required by each endpoint.

## Choose an endpoint from your starting input

- A keyword: [Video Search V2](./video-search-v2) accepts `keyword`, with optional `page` and `order` parameters. Keep the same search conditions when continuing.
- A supported `https://b23.tv/` video share link: pass it as `shareUrl` to [Share Link Resolution V1](./share-link-resolution-v1), which returns a public redirect URL. Inspect that URL before a subsequent lookup; this endpoint is not documented as a direct BVID response.
- A video `bvid`: use [Video Details V2](./video-details-v2). For later requests that need an AID or a part's CID, confirm those identifiers from an actual response and the intended video part.
- A creator `uid`: use [User Profile V2](./user-profile-v2) or [User Published Videos V2](./user-published-videos-v2). The uploads endpoint's optional `param` continues from a prior response.

## Match comments, danmaku and captions to their identifiers

[Video Comments V2](./video-comments-v2) requires `aid` and has an optional `cursor`. [Video Danmaku V2](./video-danmaku-v2) requires both `aid` and `cid`, with an optional `page`. [Video Captions V2](./video-captions-v2) requires `bvid`, `aid` and `cid` together. Keep the identifiers tied to the same video and intended part, and keep each pagination flow separate.

The public request contract does not fix the internal response paths for extracting AID and CID. Inspect the actual data before continuing rather than assuming a conversion or JSON path. A single response does not establish complete comment or danmaku coverage; available captions and resource access vary by video.

## Continue with an existing Python workflow

- [Comments and danmaku: BVID, AID and CID](https://justoneapi.com/en/blog/bilibili-comments-danmaku-api-guide) separates the two content types and saves bounded response snapshots.
- [Video search, details and subtitle extraction](https://justoneapi.com/en/blog/bilibili-video-subtitles-api-tutorial) explains identifier handling and downloading available subtitle resources.

Read the [API usage guide](../../usage) for authentication. Permissions, pricing, and available trial allowance are shown in the Dashboard; check the selected endpoint before increasing request volume.

## Available APIs

<div class="api-doc-table api-doc-table--platform">

| Endpoint | Method | Description |
| --- | --- | --- |
| [Video Details \(V2\)](./video-details-v2) | `GET` | Retrieves details for a Bilibili video identified by its BVID. Use it to look up a known video for content review, cataloging, or subsequent engagement analysi… |
| [User Published Videos \(V2\)](./user-published-videos-v2) | `GET` | Retrieves videos published by a Bilibili user identified by UID, with an optional continuation parameter from a prior response. Use it to browse a creator's up… |
| [User Profile \(V2\)](./user-profile-v2) | `GET` | Retrieves a Bilibili user profile identified by UID. Use it to look up a known account for creator research, profile review, or subsequent retrieval of that us… |
| [Video Danmaku \(V2\)](./video-danmaku-v2) | `GET` | Retrieves one page of danmaku comments for a Bilibili video segment identified by AID and CID. Use it to review time-synchronized audience reactions or page th… |
| [Video Comments \(V2\)](./video-comments-v2) | `GET` | Retrieves comments for a Bilibili video identified by AID, with optional cursor pagination. Use it to review audience discussion, continue through comment page… |
| [Video Search \(V2\)](./video-search-v2) | `GET` | Searches Bilibili videos by keyword with page-based pagination and sorting by general ranking, play count, publish time, danmaku count, or favorites. Use it to… |
| [Video Ranking \(V1\)](./hot-list-v1) | `GET` | Retrieves the current sitewide video ranking shown on Bilibili's public ranking page. Use it to discover trending videos and plan content research. |
| [Popular Video Feed \(V1\)](./popular-feed-v1) | `GET` | Retrieves a numbered page of Bilibili's public Popular video feed with a page size of 20. Use it to discover popular videos and browse further pages. |
| [Share Link Resolution \(V1\)](./share-link-resolution-v1) | `GET` | Resolve a supported Bilibili short share link that targets a video and return its public redirect URL. Use it to expand video links before subsequent Bilibili… |
| [User Relation Stats \(V1\)](./user-relation-stats-v1) | `GET` | Retrieves relation statistics for a Bilibili user identified by WMID. Use it to compare audience relationships across creator accounts or track relation-count… |
| [Video Captions \(V2\)](./video-captions-v2) | `GET` | Retrieves caption data for a Bilibili video segment identified by BVID, AID, and CID. Use it to obtain subtitles for transcript extraction, accessibility revie… |

</div>

