Social

Query Bilibili Replies

0calls
4 credits / call

Want to analyse a Bilibili video's comment section? This endpoint makes it easy to fetch reply data — including hot replies and newest replies — with pagination support.

GET
uapis.cn
/api/v1/social/bilibili/replies
Query parameters
4
oid
string
required

Free Bilibili Live Room API - Real-time live status and popularity

sort
string

Sort order. Supports 0/time (by time), 1/like (by likes), 2/reply (by reply count), and 3/hot/hottest/Newest (by hotness). Defaults to 0/time.

ps
string

QQ User Info API - Fetch avatar, nickname, and level in one call

pn
string

Page number to fetch, starting at 1. Defaults to 1.

Overview

Given a video's oid (typically the video's aid), the endpoint returns the video's replies page by page. Choose a sort order and pagination parameters to fetch exactly the data you need.

Parameters

  • sort (sort order)
    • 0 or time: sort by time
    • 1 or like: sort by likes
    • 2 or reply: sort by reply count
    • 3 or hot (also hottest, Newest): sort by hotness

Response fields

  • hots (hot replies): Returned only on page 1; may contain a hot-replies list whose items share the same shape as items in replies.
  • replies (reply list): An array of replies for the current page. Inside each item:
    • root: ID of the root reply. 0 when the reply itself is top-level.
    • parent: ID of the reply being replied to. Also 0 when the comment is the root.

Query parameters

oid
stringrequired

Free Bilibili Live Room API - Real-time live status and popularity

sort
stringoptional

Sort order. Supports 0/time (by time), 1/like (by likes), 2/reply (by reply count), and 3/hot/hottest/Newest (by hotness). Defaults to 0/time.

ps
stringoptional

QQ User Info API - Fetch avatar, nickname, and level in one call

pn
stringoptional

Page number to fetch, starting at 1. Defaults to 1.

Response

200 / OK

Success. Returns the reply list for the requested page and sort order.

JSON
{
  // Pagination summary.
  "page": {
    // Current page number.
    "num": 1,
    // Page size.
    "size": 5,
    // Total root replies (replies directly on the video).
    "count": 81682,
    // Total replies in the comment area (including nested replies).
    "acount": 123456
  },
  // Parent reply rpid. `0` indicates the parent is the root.
  "config": null,
  // Hot-replies list. Same shape as items in `replies`. Empty when not on page 1 or when no hot replies exist.
  "hots": null,
  // Reply list for the current page.
  "replies": [
    {
      // Unique reply ID.
      "rpid": 4189337397,
      // Comment-area object ID — the video aid.
      "oid": 1706416465,
      // Author user mid.
      "mid": 12345678,
      // Root reply rpid. `0` indicates the comment itself is the root.
      "root": 4189337300,
      // Live status. 0 = not live, 1 = live, 2 = looping content.
      "parent": 4189337300,
      // Number of nested replies under this reply.
      "count": 520,
      // Reply post time as Unix timestamp (seconds).
      "ctime": 1579532400,
      // Like count for this reply.
      "like": 1314,
      // Reply-author user information.
      "member": {
        // User nickname.
        "uname": "Comment-area identity tag.",
        // User gender.
        "sex": "male",
        // User avatar URL.
        "avatar": "http://i0.hdslb.com/bfs/face/....jpg",
        "level_info": {
          // User Bilibili level.
          "current_level": 6
        }
      },
      // Reply content.
      "content": {
        // Reply text content.
        "message": "(Sample reply text)"
      },
      // Nested reply list. Same shape as the parent reply object, but typically smaller and may require a separate request.
      "replies": [
        {}
      ]
    }
  ],
  // Creator-related info. `null` when unavailable.
  "upper": null,
  // Pinned-reply info. `null` when not present.
  "top": null,
  // Comment-area announcement info. `null` when none.
  "notice": null,
  // Comment-area voting status. Usually 0 when no vote is configured.
  "vote": 0,
  // Reply-fold-related info. `null` when unavailable.
  "folder": null,
  // Comment-area restriction info. `null` when none.
  "control": null,
  // Pagination cursor for in-app navigation. `null` for page-based scenarios.
  "cursor": null
}