Skip to content
All Bilibili APIs
CommentsBilibiliVideo Comment Reply · List

Bilibili comment replies

Read public nested replies under a root comment on a Bilibili video by BV ID, comment ID, and page.

POST/v1/bilibili/videos/comment-replies

Chinese name: B站评论回复 · 视频评论回复 · 列表 按 BV 号、根评论 ID 和页码读取 B站公开评论下的楼中楼回复。
bilibili.videos.comments.replies@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

bvidstringrequired

pattern: "^BV[0-9A-Za-z]{10}$" · minLength: 1 · maxLength: 256

Example: "BV1M1421t7hT"

comment_idstringrequired

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

Example: "237109455120"

pageintegeroptional

default: 1 · minimum: 1 · maximum: 50

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bvid": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^BV[0-9A-Za-z]{10}$"
    },
    "comment_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^\\d{1,20}$"
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "bvid",
    "comment_id"
  ],
  "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/videos/comment-replies \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bvid":"BV1M1421t7hT","comment_id":"237109455120"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_bilibili_videos_comments_replies",
  "message": "success",
  "data": {
    "items": [
      {
        "rpid": 237109455999,
        "oid": 1156219960,
        "mid": 12345678,
        "ctime": 1718000000,
        "like": 88,
        "rcount": 0,
        "content": {
          "message": "公开评论"
        },
        "member": {
          "mid": "12345678",
          "uname": "公开用户"
        },
        "root": 237109455120,
        "parent": 237109455120
      }
    ]
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "bilibili.videos.comments.replies",
    "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": {
              "rpid": {},
              "oid": {},
              "mid": {},
              "root": {},
              "parent": {},
              "ctime": {},
              "like": {},
              "rcount": {},
              "content": {},
              "member": {}
            },
            "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.videos.comments.replies"
        },
        "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 when the video and root comment are known and you need the replies.

Not for

  • Do not use it to discover top-level comments or for danmaku.

Known limitations

  • The BV ID and comment ID must belong to the same public thread.
  • Page-number paging can repeat or skip items between pages.
  • Deleted, private, or restricted content is absent.

Billing

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

See all pricing →