Bilibili Video Comments (App)

API docs
https://api.sandbase.ai/v1/api/bilibili/app/video-comments

Returns user comments for a specified Bilibili video by AV or BV identifier. Supports sorting comments by popularity or post time, with cursor-based pagination.

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
0 required · 4 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Playground

Input
AV ID (choose one of av_id or bv_id)
BV ID (choose one of av_id or bv_id)
Sort mode (3=hot, 2=time)
Pagination cursor
OutputExample
Responseoutputs · 20.5 KB · 578 lines
[
  {
    "data": {
      "code": 0,
      "data": {
        "assist": 0,
        "blacklist": 0,
        "callbacks": null,
        "config": {
          "read_only": false,
          "show_up_flag": true,
          "showtopic": 1
        },
        "control": {
          "answer_guide_android_url": "https://www.bilibili.com/h5/newbie/entry?navhide=1&re_src=6",
          "answer_guide_icon_url": "http://i0.hdslb.com/bfs/emote/96940d16602cacbbac796245b7bb99fa9b5c970c.png",
          "answer_guide_ios_url": "https://www.bilibili.com/h5/newbie/entry?navhide=1&re_src=12",
          "answer_guide_text": "需要升级成为lv2会员后才可以评论,先去答题转正吧!",
          "bg_text": "",
          "child_input_text": "宫廷玉液酒,评论走一走",
          "disable_jump_emote": false,
          "empty_page": null,
          "enable_charged": true,
          "enable_cm_biz_helper": false,
          "giveup_input_text": "不发没关系,请继续友善哦~",
          "input_disable": false,
          "preload_resources": null,
          "root_input_text": "宫廷玉液酒,评论走一走",
          "screenshot_icon_state": 1,
          "show_text": "",
          "show_type": 1,
          "upload_picture_icon_state": 1,
          "web_selection": false
        },
        "cursor": {
          "all_count": 2199,
          "is_begin": true,
          "is_end": false,
          "mode": 3,
          "mode_text": "",
          "name": "热门评论",
          "next": 4,
          "pagination_reply": {
            "next_offset": "CAEiAggE"
          },
          "prev": 0,
          "session_id": "",
          "support_mode": [
            2,
            3
          ]
        },
        "effects": {
          "preloading": ""
        },
        "note": 1,
        "replies": [
          {
            "action": 0,
            "assist": 0,
            "attr": 0,
            "content": {
              "emote": {
                "[笑哭]": {
                  "attr": 0,
                  "id": 509,
                  "jump_title": "笑哭",
                  "meta": "…",
                  "mtime": 1668688325,
                  "package_id": 1,
                  "state": 0,
                  "text": "[笑哭]",
                  "type": 1,
                  "url": "https://i0.hdslb.com/bfs/emote/c3043ba94babf824dea03ce500d0e73763bf4f40.png"
                }
              },
              "jump_url": {},
              "max_line": 6,
              "members": [],
              "message": "弹幕来一句500g是两斤确实绷不住了[笑哭]"
            },
            "count": 1,
            "ctime": 1790200581,
            "dialog": 0,
            "dialog_str": "0",
            "dynamic_id_str": "0",
            "fansgrade": 0,
            "folder": {
              "has_folded": false,
              "is_folded": false,
              "rule": ""
            },
            "invisible": false,
            "like": 9,
            "member": {
              "avatar": "https://i2.hdslb.com/bfs/face/ba04fabd609e34a7cecc4bd824ab88f0a94eccb9.jpg",
              "avatar_item": {
                "container_size": {
                  "height": 1.8,
                  "width": 1.8
                },
                "fallback_layers": {
                  "is_critical_group": true,
                  "layers": "… 3 items in the full response"
                },
                "mid": "3398387"
              },
              "contract_desc": "",
              "face_nft_new": 0,
              "fans_detail": null,
              "handle": "",
              "is_contractor": false,
              "is_senior_member": 0,
              "level_info": {
                "current_exp": 0,
                "current_level": 6,
                "current_min": 0,
                "next_exp": 0
              },
              "mid": "3398387",
              "nameplate": {
                "condition": "单个自制视频总播放数>=100万,数据次日更新",
                "image": "https://i0.hdslb.com/bfs/face/82896ff40fcb4e7c7259cb98056975830cb55695.png",
                "image_small": "https://i1.hdslb.com/bfs/face/627e342851dfda6fe7380c2fa0cbd7fae2e61533.png",
                "level": "稀有勋章",
                "name": "黄金殿堂",
                "nid": 1
              },
              "nft_interaction": null,
              "official_verify": {
                "desc": "音乐人尔康",
                "type": 0
              },
              "pendant": {
                "expire": 0,
                "image": "",
                "image_enhance": "",
                "image_enhance_frame": "",
                "n_pid": 0,
                "name": "",
                "pid": 0
              },
              "rank": "10000",
              "senior": {},
              "sex": "男",
              "sign": "技术流博主,超强剑魂,全职业都能玩,不扯犊子只说实话,提问请关注并在评论区或者直播间提问,每晚7点播,四维土龙代斩可以联系,交流群见视频置顶",
              "tribee": null,
              "uname": "DNF手游無限劍刃",
              "user_sailing": {
                "cardbg": null,
                "cardbg_with_focus": null,
                "pendant": null
              },
              "user_sailing_v2": {},
              "vip": {
                "accessStatus": 0,
                "avatar_subscript": 1,
                "dueRemark": "",
                "label": {
                  "bg_color": "#FB7299",
                  "bg_style": 1,
                  "border_color": "",
                  "img_label_uri_hans": "",
                  "img_label_uri_hans_static": "http://i0.hdslb.com/bfs/vip/b3d1836175ca2ff6032bef017b6e9115bcbaf4a9.png",
                  "img_label_uri_hant": "",
                  "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/sGu57N6pgK.png",
                  "img_label_uri_i18n": "",
                  "img_label_uri_i18n_static": "",
                  "label_goto": "…",
                  "label_id": 65,
                  "label_theme": "ten_annual_vip",
                  "label_type": 1,
                  "path": "http://i0.hdslb.com/bfs/vip/label_annual.png",
                  "text": "十年大会员",
                  "text_color": "#FFFFFF",
                  "use_img_label": true
                },
                "nickname_color": "#FB7299",
                "themeType": 0,
                "vipDueDate": 1815148800000,
                "vipStatus": 1,
                "vipStatusWarn": "",
                "vipType": 2
              }
            },
            "mid": 3398387,
            "mid_str": "3398387",
            "note_cvid_str": "0",
            "oid": 117321125400871,
            "oid_str": "117321125400871",
            "parent": 0,
            "parent_str": "0",
            "rcount": 1,
            "replies": [
              {
                "action": 0,
                "assist": 0,
                "attr": 0,
                "content": {
                  "emote": "…",
                  "jump_url": "…",
                  "max_line": 2,
                  "members": "… 0 items in the full response",
                  "message": "买牛肉不炸了[doge]"
                },
                "count": 0,
                "ctime": 1790231240,
                "dialog": 314892814113,
                "dialog_str": "314892814113",
                "dynamic_id_str": "0",
                "fansgrade": 0,
                "folder": {
                  "has_folded": false,
                  "is_folded": false,
                  "rule": ""
                },
                "invisible": false,
                "like": 0,
                "member": {
                  "avatar": "https://i0.hdslb.com/bfs/face/9a825e990d80d7f97c67b1db7ebcf4252b3a78a1.jpg",
                  "avatar_item": "…",
                  "contract_desc": "",
                  "face_nft_new": 0,
                  "fans_detail": null,
                  "handle": "",
                  "is_contractor": false,
                  "is_senior_member": 0,
                  "level_info": "…",
                  "mid": "520436772",
                  "nameplate": "…",
                  "nft_interaction": null,
                  "official_verify": "…",
                  "pendant": "…",
                  "rank": "10000",
                  "senior": "…",
                  "sex": "男",
                  "sign": "开心快乐每一天!",
                  "tribee": null,
                  "uname": "stk-囧囧",
                  "user_sailing": null,
                  "vip": "…"
                },
                "mid": 520436772,
                "mid_str": "520436772",
                "note_cvid_str": "0",
                "oid": 117321125400871,
                "oid_str": "117321125400871",
                "parent": 314860014033,
                "parent_str": "314860014033",
                "rcount": 0,
                "replies": null,
                "reply_control": {
                  "max_line": 2,
                  "support_share": true,
                  "time_desc": "6天前发布",
                  "translation_switch": 1
                },
                "root": 314860014033,
                "root_str": "314860014033",
                "rpid": 314892814113,
                "rpid_str": "314892814113",
                "state": 0,
                "track_info": "",
                "type": 1,
                "up_action": {
                  "like": false,
                  "reply": false
                }
              }
            ],
            "reply_control": {
              "max_line": 6,
              "sub_reply_entry_text": "共1条回复",
              "sub_reply_title_text": "相关回复共1条",
              "support_share": true,
              "time_desc": "7天前发布",
              "translation_switch": 1
            },
            "root": 0,
            "root_str": "0",
            "rpid": 314860014033,
            "rpid_str": "314860014033",
            "state": 0,
            "track_info": "",
            "type": 1,
            "up_action": {
              "like": false,
              "reply": false
            }
          },
          {
            "action": 0,
            "assist": 0,
            "attr": 0,
            "content": {
              "emote": {
                "[包浆狗狗合集_wink]": {
                  "attr": 0,
                  "id": 100266,
                  "jump_title": "wink",

Examples

Select an example to load its inputs and result into the playground.

API README

Bilibili Video Comments (App) API

Returns a page of comments for one Bilibili video, including each comment's text, like count, author and a few nested replies. It needs a video ID, given as either av_id or bv_id.

Use cases

  • Pull the top comments of a video to study what viewers agree or argue about.
  • Sort comments by post time with mode set to 2 to follow how a discussion develops.
  • Collect comment authors' mid values to find active commenters on a video.
  • Export comment text and like counts for sentiment analysis of a video.

Request

curl -X POST "https://api.sandbase.ai/v1/api/bilibili/app/video-comments" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bv_id": "BV18SCrBGE9E", "mode": 3, "next_offset": 1}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
av_idstringNoAV ID (choose one of av_id or bv_id)
bv_idstringNoBV ID (choose one of av_id or bv_id)
modeintegerNoSort mode (3=hot, 2=time)
next_offsetintegerNoPagination cursor

Example response

Historical provider response sample, trimmed: lists keep their first item and long strings are cut. The single-identifier teaching request above was not re-run for this update.

{
  "code": 0,
  "data": {
    "assist": 0,
    "blacklist": 0,
    "callbacks": null,
    "config": {
      "read_only": false,
      "show_up_flag": true,
      "showtopic": 1
    },
    "control": {
      "answer_guide_android_url": "https://www.bilibili.com/h5/newbie/entry?navhide=1&re_src=6",
      "answer_guide_icon_url": "http://i0.hdslb.com/bfs/emote/96940d16602cacbbac796245b7bb99fa9b5c970c.png",
      "answer_guide_ios_url": "https://www.bilibili.com/h5/newbie/entry?navhide=1&re_src=12",
      "answer_guide_text": "需要升级成为lv2会员后才可以评论,先去答题转正吧!",
      "bg_text": "",
      "child_input_text": "只是一直在等你而已,才不是想被评论呢~",
      "disable_jump_emote": false,
      "empty_page": null,
      "enable_charged": true,
      "enable_cm_biz_helper": false,
      "giveup_input_text": "不发没关系,请继续友善哦~",
      "input_disable": false
    },
    "cursor": {
      "all_count": 1250,
      "is_begin": true,
      "is_end": false,
      "mode": 3,
      "mode_text": "",
      "name": "热门评论",
      "next": 2,
      "pagination_reply": {
        "next_offset": "CAEiAggC"
      },
      "prev": 0,
      "session_id": "",
      "support_mode": [
        2
      ]
    },
    "effects": {
      "preloading": ""
    },
    "note": 1,
    "replies": [
      {
        "action": 0,
        "assist": 0,
        "attr": 0,
        "content": {
          "jump_url": {},
          "max_line": 6,
          "members": [],
          "message": "猎鹰这个队的抽象之处在于老尼打的越菜其他人被踢的可能性反而越高。"
        },
        "count": 33,
        "ctime": 1763432703,
        "dialog": 0,
        "dialog_str": "0",
        "dynamic_id_str": "0",
        "fansgrade": 0,
        "folder": {
          "has_folded": false,
          "is_folded": false,
          "rule": ""
        },
        "invisible": false
      }
    ],
    "top": {
      "admin": null,
      "upper": null,
      "vote": null
    },
    "top_replies": null,
    "upper": {
      "mid": 203680252
    }
  },
  "message": "OK",
  "ttl": 1
}

Response fields

FieldMeaning
data.replies[].content.messageText of the top-level comment.
data.replies[].rpid_strID of the comment, as a string.
data.replies[].likeNumber of likes on the comment.
data.replies[].rcount / data.replies[].countReply counts for the comment. rcount matches the total shown in reply_control.sub_reply_entry_text, for example 26 replies.
data.replies[].ctimePost time of the comment as a Unix timestamp in seconds.
data.replies[].mid_strBilibili user ID of the commenter, as a string.
data.replies[].member.avatarURL of the commenter's avatar image.
data.replies[].replies[]A short preview list of replies to the comment. Each item has its own content.message, ctime and dialog_str.
data.replies[].content.pictures[].img_srcURL of an image attached to the comment. It appears only on comments that have pictures.
data.cursor.all_countTotal comment count reported for the video.
data.cursor.is_endWhether this page is the last one.
data.cursor.pagination_reply.next_offsetCursor string for the next page.

Notes

  • Send either av_id or bv_id. The BV ID looks like BV18SCrBGE9E and the AV ID is a number like 115568241811221. The comments' oid_str matches the AV ID.
  • Set mode to 3 for hot comments or 2 for time order. The response lists these values in data.cursor.support_mode.
  • The sample contains both integer data.cursor.next and string data.cursor.pagination_reply.next_offset. The input schema declares integer next_offset; these are not interchangeable. This guide stops after the first request and does not verify continuation.
  • To get details of the video itself, call Bilibili App Single Video Details. For a commenter's profile, call Bilibili App User Info.

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Read one page of video comments

Send exactly one identifier: bv_id for a BV id, or av_id for a numeric AV identifier represented as a string. The schema describes these as alternatives even though neither field appears in a required array. Do not send a URL, creator id or both identifiers in the first request.

Set mode to 3 for hot comments or 2 for time order. The current schema's next_offset is an integer with default 1. The API reference's teaching request starts at 1; a saved Playground example may contain a different historical cursor, so check it before running. This guide makes one request and stops.

The historical response includes both integer cursor.next and string cursor.pagination_reply.next_offset. They are not interchangeable with the current integer input. This update does not verify continuation: do not convert the opaque string to a number, invent a cursor or fetch every page automatically. A hot-comment sample and nested preview replies do not represent all comments or complete threads.

Use Video Details if you need the title or metadata of the known video first; that is a separate request.

Connect one request to your agent

Already have a key? Keep SANDBASE_API_KEY in your local environment, open the API tab and use its POST /v1/api/ route with Bearer authentication. Already connected your agent? Give it this endpoint and one public video identifier. For a new project, share the setup Skill, Markdown quickstart and your task. Ask for one request and a saved response before adding a larger workflow.

Pricing checked on 2026-11-08: both selected endpoints list $0.001 per call and eligibility for the organization's 100 daily free data API calls, shared across eligible APIs and reset at 00:00 UTC. Eligibility does not tell you the remaining allowance. Inspect current pricing and quota before running. No new business request was made for this guide update.

Read outputs[0].data only from a completed SandBase response, then inspect the Bilibili code and data inside that payload. HTTP 200 or a completed gateway call alone does not establish a successful provider result. Preserve missing values as unknown, not zero. The Bilibili Python integration guide includes a bounded first request and separately dated historical response evidence.

Explore more

Related APIs

All APIs
APIPriceResponse
Bilibili$0.001 per callJSON
Bilibili$0.001 per callJSON
Bilibili$0.001 per callJSON
Bilibili$0.001 per callJSON
Bilibili$0.001 per callJSON
Bilibili$0.001 per callJSON

Questions

FAQ

How do I use the Bilibili Video Comments (App) API?

Send a POST request to https://api.sandbase.ai/v1/api/bilibili/app/video-comments with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Bilibili Video Comments (App) API cost?

$0.001 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Bilibili Video Comments (App) API accept?

No parameters are required. Optional: av_id (string), bv_id (string), mode (integer) and next_offset (integer). The Parameters table and the Playground on this page list every field.

What does the Bilibili Video Comments (App) API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Bilibili developer account or API key?

No. Bilibili Video Comments (App) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Bilibili API access separately.

Should I send both an AV id and a BV id?

No. For this first request, send one of av_id or bv_id. Use a numeric AV identifier as a string or the BV identifier from the video URL. Choose mode 3 for hot comments or 2 for time order; start next_offset at the current integer default 1.

Can I copy the string next_offset from the response into this request?

Do not assume that works. The current input schema declares an integer next_offset, while historical responses also show an opaque string under cursor.pagination_reply.next_offset. This first-request guide does not validate continuation or interchange those fields, and it does not automatically paginate.

Is my first page guaranteed to be free or complete?

Neither. On 2026-11-08 this endpoint listed $0.001 per call and eligibility for 100 daily calls shared across eligible data APIs in the organization, resetting at 00:00 UTC. Check remaining quota and current pricing. A page and its nested reply previews are a sample, not the complete discussion.