Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
44f77f1471
bilibili-API-collect/docs/comment/list.md
Session小胡 1e24c6b188
调整部分接口描述与错误修复 (#1088) 
* fix(search/search_request.md): cookie buvid3

* feat(login/login_action/password.md): more sms desc

* fix: typo

* feat(live/info.md): add ps for getRoomBaseInfo

* fix(danmaku/action.md): broken form

* chore: Browserslist: caniuse-lite is outdated

* feat(comment/list.md): reply/wbi/main param next

* feat(misc/buvid3_4.md): get buvid3 only

* fix: broken links & wrong code type

* feat: close all img & br tags

* feat(login/cookie_refresh.md): missing demo links

* feat(dynamic/detail.md): /lottery_svr/v1/lottery_svr/lottery_notice

* fix(video/action.md): share cookie buvid3

* feat: deprecated stat & attribute

* feat(dynamic/detail.md): reaction

* feat(misc/sign/v_voucher.md): header

* feat(dynamic/detail.md): update detail params & example

* feat(APP_widget/ver.md): /x/v2/version

* feat(video/info.md): update view

* feat(docs/user.md): remove channel

* feat(search/search_request.md): search/type -1200

* feat(user/space.md): audio

* feat(video/player.md): /x/player/wbi/v2

* feat(audio/musicstream_url.md): update web/url

* feat(comment/readme.md): state

* fix(user/medal.md): wrong guard_level desc

* feat(live/message_stream.md): DANMU_MSG

* fix(user/medals): wrong guard_level & guard_icon desc

* feat(live/message_stream.md): format & add more 'cmd'

* feat(live/message_stream.md): add more 'cmd'

* feat(live/message_stream.md): add tips for non-login users

* feat(video/player.md): need_login_subtitle

---------

Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
2024-09-19 23:17:33 +08:00

3723 lines
142 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 评论区明细
## 获取评论区明细_翻页加载
> https://api.bilibili.com/x/v2/reply
*请求方式：GET*
认证方式：Cookie（SESSDATA）或APP
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | -------------------------------------------------------- |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区 id | 必要 | |
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-20 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | -------------------------------- | -------- | ---------------- |
| page | obj | 页信息 | |
| config | obj | 评论区显示控制 | |
| replies | 禁用时：null<br />正常时：array | 评论列表 | |
| hots | 禁用时：null<br />正常时：array | 热评列表 | |
| upper | obj | 置顶评论 | |
| top | null | (?) | |
| notice | 无效时：null<br />有效时：obj | 评论区公告信息 | |
| vote | num | 投票评论? | |
| blacklist | num | (?) | |
| assist | num | (?) | |
| mode | num | 评论区类型id | |
| support_mode | array | 评论区支持的类型id | |
| folder | obj | 折叠相关信息 | |
| lottery_card | null | (?) | |
| show_bvid | bool | 显示bvid? | |
| control | obj | 评论区输入属性 | |
`data`中的`page`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---- |
| num | num | 当前页码 | |
| size | num | 每页项数 | |
| count | num | 根评论条数 | |
| acount | num | 总计评论条数 | |
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------- | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | (?) | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP 觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`replies`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | -------------------------------------- |
| 0 | obj | 评论条目 1 | [对象定义见表](readme.md#评论条目对象) |
| n | obj | 评论条目 (n+1) | 按照指定的顺序排列 |
| …… | obj | …… | …… |
`data`中的`hots`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | -------------------------------------- |
| 0 | obj | 热评条目 1 | [对象定义见表](readme.md#评论条目对象) |
| n | obj | 热评条目 (n+1) | 按照热评热度排列 |
| …… | obj | …… | …… |
`data`中的`upper`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | ---------- | -------------------------------------- |
| mid | num | UP 主 mid | |
| top | 有效时：obj<br />无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时：obj<br />无效时：null | 投票评论？ | |
`data`中的`notice`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ---------------- | ---- |
| content | str | 公告正文 | |
| id | num | 公告 id | |
| link | str | 公告页面链接 url | |
| title | str | 公告标题 | |
`data`中的`folder`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------------- | ---- |
| has_folded | bool | 评论区是否存在折叠评论 | |
| is_folded | bool | 是否折叠? | |
| rule | str | 相关规则页面 url | |
`data`中的`control`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------------ | ---- | ------------------ | ----------------------------------- |
| input_disable | bool | 是否禁止新增评论 | 用户涉及合约争议，锁定该用户所有稿件、动态的评论区，不允许新增评论，`root_input_text`和`child_input_text`值为“当前评论区不可新增评论” |
| root_input_text | str | 评论框文字 | |
| child_input_text | str | 评论框文字 | |
| bg_text | str | 空评论区文字 | |
| web_selection | bool | 评论是否筛选后可见 | false：无需筛选<br />true：需要筛选 |
| answer_guide_text | str | 答题页面链接文字 | |
| answer_guide_icon_url | str | 答题页面图标 url | |
| answer_guide_ios_url | str | 答题页面 ios url | |
| answer_guide_android_url | str | 答题页面安卓 url | |
**示例：**
获取视频`av2`的评论区明细，不显示热评，按照热度排序，每页5项，查看第1页
```shell
curl -G 'https://api.bilibili.com/x/v2/reply' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=2' \
--data-urlencode 'sort=1' \
--data-urlencode 'ps=5' \
--data-urlencode 'pn=1' \
--data-urlencode 'nohot=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"page": {
"num": 1,
"size": 5,
"count": 60971,
"acount": 76792
},
"config": {
"showadmin": 1,
"showentry": 1,
"showfloor": 0,
"showtopic": 1,
"show_up_flag": true,
"read_only": false,
"show_del_log": false
},
"replies": [
{
"rpid": 104192624480,
"oid": 2,
"type": 1,
"mid": 621197713,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1646205507,
"rpid_str": "104192624480",
"root_str": "0",
"parent_str": "0",
"like": 1,
"action": 0,
"member": {
"mid": "621197713",
"uname": "小鹿不跑路",
"sex": "保密",
"sign": "",
"avatar": "http://i1.hdslb.com/bfs/face/3e220c95ead8f2bc72bd2dcee72d195b723192fa.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 4,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1648051200000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "大会员",
"label_theme": "vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "我赶上了我们这个年龄段二次元的末班车，这一年，巨人出了最终季，诚哥的新作玲芽户缔（好像是叫这个）也要在今年秋上映，后悔没有早进入这个圈子，现在只好紧追慢赶，慢慢的补番，我小时候都在干什么啊[大哭]",
"plat": 0,
"device": "",
"members": [],
"emote": {
"[大哭]": {
"id": 5,
"package_id": 1,
"state": 0,
"type": 1,
"attr": 0,
"text": "[大哭]",
"url": "http://i0.hdslb.com/bfs/emote/2caafee2e5db4db72104650d87810cc2c123fc86.png",
"meta": {
"size": 1
},
"mtime": 1597738918,
"jump_title": "大哭"
}
},
"jump_url": {},
"max_line": 6
},
"replies": [],
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": "https://www.bilibili.com/blackboard/foldingreply.html"
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "6小时前发布"
}
},
{
"rpid": 104184937184,
"oid": 2,
"type": 1,
"mid": 560450695,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1646199089,
"rpid_str": "104184937184",
"root_str": "0",
"parent_str": "0",
"like": 0,
"action": 0,
"member": {
"mid": "560450695",
"uname": "還講幾韆",
"sex": "保密",
"sign": "",
"avatar": "http://i1.hdslb.com/bfs/face/e8bcd1f3fed1a8b266e83f7e5952db525b692227.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 3,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "电视宇宙第二个视频[滑稽][滑稽][滑稽]",
"plat": 0,
"device": "",
"members": [],
"emote": {
"[滑稽]": {
"id": 27,
"package_id": 1,
"state": 0,
"type": 1,
"attr": 0,
"text": "[滑稽]",
"url": "http://i0.hdslb.com/bfs/emote/d15121545a99ac46774f1f4465b895fe2d1411c3.png",
"meta": {
"size": 1
},
"mtime": 1645206695,
"jump_title": "滑稽"
}
},
"jump_url": {},
"max_line": 6
},
"replies": [],
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": "https://www.bilibili.com/blackboard/foldingreply.html"
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "7小时前发布"
}
},
{
"rpid": 104179775904,
"oid": 2,
"type": 1,
"mid": 1616523766,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1646195814,
"rpid_str": "104179775904",
"root_str": "0",
"parent_str": "0",
"like": 1,
"action": 0,
"member": {
"mid": "1616523766",
"uname": "关查者网",
"sex": "保密",
"sign": "",
"avatar": "http://i1.hdslb.com/bfs/face/8bb6aab1f6bcc960f4482aa97b8ca4e61cf81d0d.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 3,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1626451200000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "考古队已到达[doge]",
"plat": 0,
"device": "",
"members": [],
"emote": {
"[doge]": {
"id": 26,
"package_id": 1,
"state": 0,
"type": 1,
"attr": 0,
"text": "[doge]",
"url": "http://i0.hdslb.com/bfs/emote/3087d273a78ccaff4bb1e9972e2ba2a7583c9f11.png",
"meta": {
"size": 1
},
"mtime": 1645206695,
"jump_title": "doge"
}
},
"jump_url": {},
"max_line": 6
},
"replies": [],
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": "https://www.bilibili.com/blackboard/foldingreply.html"
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "8小时前发布"
}
},
{
"rpid": 104163851152,
"oid": 2,
"type": 1,
"mid": 27553613,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1646183484,
"rpid_str": "104163851152",
"root_str": "0",
"parent_str": "0",
"like": 1,
"action": 0,
"member": {
"mid": "27553613",
"uname": "念晚心",
"sex": "男",
"sign": "",
"avatar": "http://i2.hdslb.com/bfs/face/8b8f32c22651904a23eeb83b048041b7c1c8ffd6.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 74,
"name": "大会员2018年度勋章",
"image": "http://i2.hdslb.com/bfs/face/421179426c929dfeaed4117461c83f5d07ffb148.png",
"image_small": "http://i0.hdslb.com/bfs/face/682001c2e1c2ae887bdf2a0e18eef61180c48f84.png",
"level": "稀有勋章",
"condition": "2018.6.26-7.8某一天是年度大会员"
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1650470400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"nickname_color": "#FB7299"
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": {
"id": 5476,
"name": "嘉然今天吃什么",
"image": "http://i0.hdslb.com/bfs/garb/item/4442641bd4001214518a81fa8f790ae7469d3cf7.png",
"jump_url": "https://www.bilibili.com/h5/mall/fans/recommend/5461?navhide=1&mid=27553613&from=reply",
"fan": {
"is_fan": 1,
"number": 14705,
"color": "#f76a6b",
"name": "嘉然今天吃什么",
"num_desc": "014705"
},
"type": "suit"
},
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "当时只看优酷和土豆",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 6
},
"replies": [],
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": "https://www.bilibili.com/blackboard/foldingreply.html"
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "12小时前发布"
}
},
{
"rpid": 104163545120,
"oid": 2,
"type": 1,
"mid": 31937033,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1646183209,
"rpid_str": "104163545120",
"root_str": "0",
"parent_str": "0",
"like": 1,
"action": 0,
"member": {
"mid": "31937033",
"uname": "夜声已尽",
"sex": "男",
"sign": "六八四十二",
"avatar": "http://i2.hdslb.com/bfs/face/e35e81a00596883532ba47c58ca0434618fab3d0.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 33465,
"name": "乃琳Queen",
"image": "http://i2.hdslb.com/bfs/garb/item/4ad130e4068f88c54728ac510a172b97e187826f.png",
"expire": 0,
"image_enhance": "http://i2.hdslb.com/bfs/garb/item/4ad130e4068f88c54728ac510a172b97e187826f.png",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 62,
"name": "有爱大佬",
"image": "http://i0.hdslb.com/bfs/face/a10ee6b613e0d68d2dfdac8bbf71b94824e10408.png",
"image_small": "http://i2.hdslb.com/bfs/face/54f4c31ab9b1f1fa2c29dbbc967f66535699337e.png",
"level": "普通勋章",
"condition": "当前持有粉丝勋章最高等级>=15级"
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1671465600000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"nickname_color": "#FB7299"
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": {
"id": 33465,
"name": "乃琳Queen",
"image": "http://i0.hdslb.com/bfs/garb/item/4ad130e4068f88c54728ac510a172b97e187826f.png",
"jump_url": "",
"type": "suit",
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/4ad130e4068f88c54728ac510a172b97e187826f.png",
"image_enhance_frame": ""
},
"cardbg": {
"id": 33494,
"name": "乃琳Queen",
"image": "http://i0.hdslb.com/bfs/garb/item/34f8c1ef43332883f62e17fed44c1a70930e4811.png",
"jump_url": "https://www.bilibili.com/h5/mall/fans/recommend/33498?navhide=1&mid=31937033&from=reply",
"fan": {
"is_fan": 1,
"number": 50766,
"color": "#576690",
"name": "乃琳Queen",
"num_desc": "050766"
},
"type": "suit"
},
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "考古",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 6
},
"replies": [],
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": "https://www.bilibili.com/blackboard/foldingreply.html"
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "12小时前发布"
}
}
],
"hots": [],
"upper": {
"mid": 2,
"top": null,
"vote": null
},
"top": null,
"notice": null,
"vote": 0,
"blacklist": 0,
"assist": 0,
"mode": 3,
"support_mode": [
1,
2,
3
],
"folder": {
"has_folded": false,
"is_folded": false,
"rule": "https://www.bilibili.com/blackboard/foldingreply.html"
},
"lottery_card": null,
"show_bvid": false,
"control": {
"input_disable": false,
"root_input_text": "发一条友善的评论",
"child_input_text": "",
"giveup_input_text": "不发没关系，请继续友善哦~",
"bg_text": "看看下面~来发评论吧",
"web_selection": false,
"answer_guide_text": "需要升级成为lv2会员后才可以评论，先去答题转正吧！",
"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_android_url": "https://www.bilibili.com/h5/newbie/entry?navhide=1&re_src=6",
"show_type": 1,
"show_text": "",
"disable_jump_emote": false
}
}
}
```
</details>
## 获取评论区明细_懒加载
> https://api.bilibili.com/x/v2/reply/wbi/main
> ~~https://api.bilibili.com/x/v2/reply/main~~
*请求方式：GET*
鉴权方式：[Wbi 签名](../misc/sign/wbi.md)
注: Wbi 签名错误时返回 -403 而非 -352
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | ------------------------------------------------------------ |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区 id | 必要 | |
| mode | num | 排序方式 | 非必要 | 默认为 3<br />0 3：仅按热度<br />1：按热度+按时间<br />2：仅按时间 |
| next | num | 翻页 | 非必要 | 不推荐, 已弃用, 优先级比 `pagination_str` 高 |
| pagination_str | obj | 分页信息 | 非必要 | 见下 |
| plat | num | 平台类型 | 非必要 | 如 `1` |
| seek_rpid | str | 空 | 非必要 | 当获取第一页评论时存在 |
| web_location | str | 1315875 | 非必要 | |
`pagination_str`:
| 参数名 | 类型 | 内容 | 备注 |
| ----- | - | ------|------|
| offset | str | 一个套着字符串皮的 JSON Object | 上次响应 `data.cursor.pagination_reply.next_offset` 的值, 获取第一页时为空, 其余见下参考 |
`pagination_str` 中的 `offset`:
| 参数名 | 类型 | 内容 | 备注 |
| ----- | ---- | -- | - |
| type | num | 类型 | 当 URL 参数 mode 为 2 时, 此项为 3<br />当 URL 参数 mode 为 3 时, 此项为 1 |
| direction | num | 方向 | 1: 正序(默认)<br />2: 倒序 |
| data | obj | 分页数据 | 当 type 为 1 时存在 |
| Data | obj | 分页数据 | 当 type 为 3 时存在 |
<!--not typo here-->
`offset` 中的 `data` (type=1):
| 参数名 | 类型 | 内容 | 备注 |
| - | - | - | - |
| pn | num | 页码 (上次响应 `data.cursor.next` 的值) | |
`offset` 中的 `Data` (type=3):
| 参数名 | 类型 | 内容 | 备注 |
| - | - | - | - |
| cursor | num | 上次响应 `data.cursor.next` 的值 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | -------------------------------- | -------- | ---------------- |
| cursor | obj | 游标信息 | |
| hots | 禁用时：null<br />正常时：array | 热评列表 | |
| notice | 无效时：null<br />有效时：obj | 评论区公告信息 | |
| replies | 禁用时：null<br />正常时：array | 评论列表 | |
| top | obj | 置顶信息 | |
| top_replies | obj | 置顶评论 | [对象定义见表](readme.md#评论条目对象) |
| lottery_card | null | 抽奖评论 | |
| folder | obj | 评论折叠信息 | |
| up_selection | obj | (?) | |
| cm | obj | 广告 | |
| cm_info | obj | 广告控制 | |
| effects | obj | (?) | |
| assist | num | (?) | |
| blacklist | num | (?) | |
| vote | num | (?) | |
| lottery | num | (?) | |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主信息 | |
| show_bvid | bool | 显示 bvid? | |
| control | obj | 评论区输入属性 | |
| note | num | 1 | |
| esports_grade_card | null | | |
| callbacks | null | | |
| context_feature | str | | |
`data`中的`cursor`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | -------------- | ----------------------- |
| all_count | num | 全部评论条数 | |
| is_begin | bool | 是否为第一页 | false：否<br />true：是 |
| prev | num | 上页页码 | |
| next | num | 下页页码 | |
| is_end | bool | 是否为最后页 | false：否<br />true：是 |
| mode | num | 排序方式 | |
| support_mode | array | 支持的排序方式 | |
| name | str | 评论区类型名 | |
| pagination_reply | str | 用于下一次请求的偏移信息 | |
| session_id | str | 空 | |
`cursor`中的`pagination_reply`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -- | - |
| next_offset | str | 用于下一次请求的偏移信息 | |
| prev_offset | str | 用于本次请求的偏移信息 | |
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------- | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | ？ | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP 觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`hots`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | -------------------------------------- |
| 0 | obj | 热评条目 1 | [对象定义见表](readme.md#评论条目对象) |
| n | obj | 热评条目 (n+1) | 按照热评热度排列 |
| …… | obj | …… | …… |
`data`中的`replies`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | -------------------------------------- |
| 0 | obj | 评论条目 1 | [对象定义见表](readme.md#评论条目对象) |
| n | obj | 评论条目 (n+1) | 按照指定的顺序排列 |
| …… | obj | …… | …… |
`data`中的`top`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----------------------------- | -------------- | -------------------------------------- |
| admin | 有效时：obj<br />无效时：null | 管理员置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| upper | 有效时：obj<br />无效时：null | UP 主置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时：obj<br />无效时：null | 投票置顶条目 | [对象定义见表](readme.md#评论条目对象) |
`data`中的`upper`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---- |
| mid | num | UP 主 mid | |
`data`中的`notice`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ---------------- | ---- |
| content | str | 公告正文 | |
| id | num | 公告 id | |
| link | str | 公告页面链接 url | |
| title | str | 公告标题 | |
`data`中的`folder`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------------- | ---- |
| has_folded | bool | 评论区是否存在折叠评论 | |
| is_folded | bool | 是否折叠? | |
| rule | str | 相关规则页面 url | |
`data`中的`control`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------------ | ---- | ------------------ | ----------------------------------- |
| input_disable | bool | (?) | |
| root_input_text | str | 评论框文字 | |
| child_input_text | str | 评论框文字 | |
| bg_text | str | 空评论区文字 | |
| web_selection | bool | 评论是否筛选后可见 | false：无需筛选<br />true：需要筛选 |
| answer_guide_text | str | 答题页面链接文字 | |
| answer_guide_icon_url | str | 答题页面图标 url | |
| answer_guide_ios_url | str | 答题页面 ios url | |
| answer_guide_android_url | str | 答题页面安卓 url | |
**示例：**
获取视频`av2`的评论区明细, 按时间排序, 第一页
```shell
curl -G 'https://api.bilibili.com/x/v2/reply/wbi/main' \
--data-urlencode 'oid=2' \
--data-urlencode 'type=1' \
--data-urlencode 'mode=2' \
--data-urlencode 'w_rid=xxx' \
--data-urlencode 'wts=xxx'
```
<details>
<summary>查看响应示例：</summary>
```jsonc
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"cursor": {
"is_begin": true,
"prev": 71880,
"next": 71859,
"is_end": false,
"mode": 2,
"mode_text": "",
"all_count": 86234,
"support_mode": [
2,
3
],
"name": "最新评论",
"pagination_reply": {
"next_offset": "{\"type\":3,\"direction\":1,\"Data\":{\"cursor\":71859}}"
},
"session_id": ""
},
"replies": [
{
"rpid": 237740291920,
"oid": 2,
"type": 1,
"mid": 1201423076,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1723639342,
"mid_str": "1201423076",
"oid_str": "2",
"rpid_str": "237740291920",
"root_str": "0",
"parent_str": "0",
"dialog_str": "0",
"like": 0,
"action": 0,
"member": {
"mid": "1201423076",
"uname": "天堂いyoulin",
"sex": "保密",
"sign": "",
"avatar": "https://i2.hdslb.com/bfs/face/d0925e782198cadc0c400a3ed4fbdf94142357fb.jpg",
"rank": "10000",
"face_nft_new": 0,
"is_senior_member": 0,
"senior": {},
"level_info": {
"current_level": 4,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": "",
"n_pid": 0
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": "",
"use_img_label": true,
"img_label_uri_hans": "",
"img_label_uri_hant": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png"
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"user_sailing_v2": {},
"is_contractor": false,
"contract_desc": "",
"nft_interaction": null,
"avatar_item": {
"container_size": {
"width": 1.8,
"height": 1.8
},
"fallback_layers": {
"layers": [
{
"visible": true,
"general_spec": {
"pos_spec": {
"coordinate_pos": 2,
"axis_x": 0.9,
"axis_y": 0.9
},
"size_spec": {
"width": 1,
"height": 1
},
"render_spec": {
"opacity": 1
}
},
"layer_config": {
"tags": {
"AVATAR_LAYER": {}
},
"is_critical": true,
"layer_mask": {
"general_spec": {
"pos_spec": {
"coordinate_pos": 2,
"axis_x": 0.9,
"axis_y": 0.9
},
"size_spec": {
"width": 1,
"height": 1
},
"render_spec": {
"opacity": 1
}
},
"mask_src": {
"src_type": 3,
"draw": {
"draw_type": 1,
"fill_mode": 1,
"color_config": {
"day": {
"argb": "#FF000000"
}
}
}
}
}
},
"resource": {
"res_type": 3,
"res_image": {
"image_src": {
"src_type": 1,
"placeholder": 6,
"remote": {
"url": "https://i2.hdslb.com/bfs/face/d0925e782198cadc0c400a3ed4fbdf94142357fb.jpg",
"bfs_style": "widget-layer-avatar"
}
}
}
}
}
],
"is_critical_group": true
},
"mid": "1201423076"
}
},
"content": {
"message": "好多20年和18年的[辣眼睛]",
"members": [],
"emote": {
"[辣眼睛]": {
"id": 2374,
"package_id": 1,
"state": 0,
"type": 1,
"attr": 0,
"text": "[辣眼睛]",
"url": "https://i0.hdslb.com/bfs/emote/35d62c496d1e4ea9e091243fa812866f5fecc101.png",
"meta": {
"size": 1,
"suggest": [
""
]
},
"mtime": 1668688325,
"jump_title": "辣眼睛"
}
},
"jump_url": {},
"max_line": 6
},
"replies": [],
"assist": 0,
"up_action": {
"like": false,
"reply": false
},
"invisible": false,
"reply_control": {
"max_line": 6,
"time_desc": "21分钟前发布",
"location": "IP属地：河北"
},
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"dynamic_id_str": "0",
"note_cvid_str": "0",
"track_info": ""
},
// ...
{
"rpid": 237689432448,
"oid": 2,
"type": 1,
"mid": 1647250883,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1723624563,
"mid_str": "1647250883",
"oid_str": "2",
"rpid_str": "237689432448",
"root_str": "0",
"parent_str": "0",
"dialog_str": "0",
"like": 1,
"action": 0,
"member": {
"mid": "1647250883",
"uname": "小烟同学424",
"sex": "保密",
"sign": "墓前玩使命，墓前暑假",
"avatar": "https://i2.hdslb.com/bfs/face/930661ca1bcacf8005efcca499b7380dcd4c2716.jpg",
"rank": "10000",
"face_nft_new": 0,
"is_senior_member": 0,
"senior": {},
"level_info": {
"current_level": 5,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": "",
"n_pid": 0
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": "",
"use_img_label": true,
"img_label_uri_hans": "",
"img_label_uri_hant": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png"
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"user_sailing_v2": {},
"is_contractor": false,
"contract_desc": "",
"nft_interaction": null,
"avatar_item": {
"container_size": {
"width": 1.8,
"height": 1.8
},
"fallback_layers": {
"layers": [
{
"visible": true,
"general_spec": {
"pos_spec": {
"coordinate_pos": 2,
"axis_x": 0.9,
"axis_y": 0.9
},
"size_spec": {
"width": 1,
"height": 1
},
"render_spec": {
"opacity": 1
}
},
"layer_config": {
"tags": {
"AVATAR_LAYER": {}
},
"is_critical": true,
"layer_mask": {
"general_spec": {
"pos_spec": {
"coordinate_pos": 2,
"axis_x": 0.9,
"axis_y": 0.9
},
"size_spec": {
"width": 1,
"height": 1
},
"render_spec": {
"opacity": 1
}
},
"mask_src": {
"src_type": 3,
"draw": {
"draw_type": 1,
"fill_mode": 1,
"color_config": {
"day": {
"argb": "#FF000000"
}
}
}
}
}
},
"resource": {
"res_type": 3,
"res_image": {
"image_src": {
"src_type": 1,
"placeholder": 6,
"remote": {
"url": "https://i2.hdslb.com/bfs/face/930661ca1bcacf8005efcca499b7380dcd4c2716.jpg",
"bfs_style": "widget-layer-avatar"
}
}
}
}
}
],
"is_critical_group": true
},
"mid": "1647250883"
}
},
"content": {
"message": "还。。。有人吗？",
"members": [],
"jump_url": {},
"max_line": 6
},
"replies": [],
"assist": 0,
"up_action": {
"like": false,
"reply": false
},
"invisible": false,
"reply_control": {
"max_line": 6,
"time_desc": "4小时前发布",
"location": "IP属地：陕西"
},
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"dynamic_id_str": "0",
"note_cvid_str": "0",
"track_info": ""
}
],
"top": {
"admin": null,
"upper": null,
"vote": null
},
"top_replies": [],
"up_selection": {
"pending_count": 0,
"ignore_count": 0
},
"effects": {
"preloading": ""
},
"assist": 0,
"blacklist": 0,
"vote": 0,
"config": {
"showtopic": 1,
"show_up_flag": true,
"read_only": false
},
"upper": {
"mid": 2
},
"control": {
"input_disable": false,
"root_input_text": "你渴望拥有力量吗？评论让力量更强大",
"child_input_text": "你渴望拥有力量吗？评论让力量更强大",
"giveup_input_text": "不发没关系，请继续友善哦~",
"screenshot_icon_state": 1,
"upload_picture_icon_state": 1,
"answer_guide_text": "需要升级成为lv2会员后才可以评论，先去答题转正吧！",
"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_android_url": "https://www.bilibili.com/h5/newbie/entry?navhide=1&re_src=6",
"bg_text": "",
"empty_page": null,
"show_type": 1,
"show_text": "",
"web_selection": false,
"disable_jump_emote": false,
"enable_charged": false,
"enable_cm_biz_helper": false,
"preload_resources": null
},
"note": 1,
"esports_grade_card": null,
"callbacks": null,
"context_feature": ""
}
}
```
</details>
## 获取指定评论的回复
> https://api.bilibili.com/x/v2/reply/reply
*请求方式：GET*
认证方式：Cookie（SESSDATA）或APP
按照回复顺序排序
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | ---------------------------------------- |
| access_key | str | APP登录 Token | APP 方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区 id | 必要 | |
| root | num | 根回复 rpid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 <br /> 但 data_replies 的最大内容数为20,因此设置为49其实也只会有20条回复被返回 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | -------------- | -------------------------------------- |
| config | obj | 评论区显示控制 | |
| control | obj | 评论区输入属性 | |
| page | obj | 页面信息 | |
| replies | array | 评论对话树列表 | 最大内容数为20 |
| root | obj | 根评论信息 | [对象定义见表](readme.md#评论条目对象) |
| show_bvid | bool | 显示 bvid? | |
| show_text | str | (?) | |
| show_type | num | (?) | |
| upper | obj | UP主 mid | |
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | ？ | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`control`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------------ | ---- | ------------------ | ----------------------------------- |
| input_disable | bool | (?) | |
| root_input_text | str | 评论框文字 | |
| child_input_text | str | 评论框文字 | |
| bg_text | str | 空评论区文字 | |
| web_selection | bool | 评论是否筛选后可见 | false：无需筛选<br />true：需要筛选 |
| answer_guide_text | str | 答题页面链接文字 | |
| answer_guide_icon_url | str | 答题页面图标 url | |
| answer_guide_ios_url | str | 答题页面 ios url | |
| answer_guide_android_url | str | 答题页面安卓 url | |
`data`中的`page`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---------- | ---- |
| count | num | 二级评论数 | |
| num | num | 当前页码 | |
| size | num | 每页项数 | |
`data`中的`replies`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------ | -------------------------------------- |
| 0 | obj | 对话评论条目 1 | [对象定义见表](readme.md#评论条目对象) |
| n | obj | 对话评论条目 (n+1) | 按照回复顺序排列 |
| …… | obj | …… | …… |
`data`中的`upper`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---- |
| mid | num | UP 主 mid | |
**示例：**
获取视频`av201022189`下评论`rpid=3030790837`的回复，每页5项，获取第1页
```shell
curl -G 'https://api.bilibili.com/x/v2/reply/reply' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=201022189' \
--data-urlencode 'root=3030790837' \
--data-urlencode 'ps=5' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"config": {
"showadmin": 0,
"showentry": 0,
"showfloor": 0,
"showtopic": 0,
"show_up_flag": false,
"read_only": false,
"show_del_log": false
},
"control": {
"input_disable": false,
"root_input_text": "发一条友善的评论",
"child_input_text": "",
"giveup_input_text": "不发没关系，请继续友善哦~",
"bg_text": "看看下面~来发评论吧",
"web_selection": false,
"answer_guide_text": "需要升级成为lv2会员后才可以评论，先去答题转正吧！",
"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_android_url": "https://www.bilibili.com/h5/newbie/entry?navhide=1&re_src=6",
"show_type": 1,
"show_text": "",
"disable_jump_emote": false
},
"page": {
"count": 230,
"num": 1,
"size": 5
},
"replies": [
{
"rpid": 3030802207,
"oid": 201022189,
"type": 1,
"mid": 172604528,
"root": 3030790837,
"parent": 3030790837,
"dialog": 3030802207,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592018067,
"rpid_str": "3030802207",
"root_str": "3030790837",
"parent_str": "3030790837",
"like": 41,
"action": 0,
"member": {
"mid": "172604528",
"uname": "超高校级的认真",
"sex": "男",
"sign": "just do it for yourself",
"avatar": "http://i2.hdslb.com/bfs/face/d0d957faa6162388467cb0750a9d33cf616e73e9.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 5,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1626364800000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "怎么上p站呀，翻吗",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "627天前发布"
}
},
{
"rpid": 3030810089,
"oid": 201022189,
"type": 1,
"mid": 342581997,
"root": 3030790837,
"parent": 3030802207,
"dialog": 3030802207,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592018123,
"rpid_str": "3030810089",
"root_str": "3030790837",
"parent_str": "3030802207",
"like": 7,
"action": 0,
"member": {
"mid": "342581997",
"uname": "VAN样斯基",
"sex": "保密",
"sign": "",
"avatar": "http://i0.hdslb.com/bfs/face/bc9c6d37b5a4c8b3b0a3cd483fd66e63b1ae0cec.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 5,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1626364800000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "回复 @中等校级的努力 :是啊",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "627天前发布"
}
},
{
"rpid": 3030843245,
"oid": 201022189,
"type": 1,
"mid": 92586428,
"root": 3030790837,
"parent": 3030790837,
"dialog": 3030843245,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592018688,
"rpid_str": "3030843245",
"root_str": "3030790837",
"parent_str": "3030790837",
"like": 588,
"action": 0,
"member": {
"mid": "92586428",
"uname": "浪潮工作室",
"sex": "保密",
"sign": "洞见时代的浪潮。",
"avatar": "http://i2.hdslb.com/bfs/face/67f183f13f8fe3afb374916d32f9810df8ef042a.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": 0,
"desc": "专栏优质UP主"
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "不会吧不会吧，不会真的有人上P站不是为了学习吧",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "627天前发布"
}
},
{
"rpid": 3030881609,
"oid": 201022189,
"type": 1,
"mid": 393121222,
"root": 3030790837,
"parent": 3030802207,
"dialog": 3030802207,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592019208,
"rpid_str": "3030881609",
"root_str": "3030790837",
"parent_str": "3030802207",
"like": 110,
"action": 0,
"member": {
"mid": "393121222",
"uname": "鱼氏博物馆",
"sex": "保密",
"sign": "",
"avatar": "http://i1.hdslb.com/bfs/face/f61a8ea36828884d760d855293136a838fa9e848.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 5,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1602691200000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "回复 @中等校级的努力 :p是什么，当然是plane啦，plane站其实就是✈场[doge]所以去p站就是去✈场啦",
"plat": 0,
"device": "",
"members": [],
"emote": {
"[doge]": {
"id": 26,
"package_id": 1,
"state": 0,
"type": 1,
"attr": 0,
"text": "[doge]",
"url": "http://i0.hdslb.com/bfs/emote/3087d273a78ccaff4bb1e9972e2ba2a7583c9f11.png",
"meta": {
"size": 1
},
"mtime": 1645206695,
"jump_title": "doge"
}
},
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "627天前发布"
}
},
{
"rpid": 3030978856,
"oid": 201022189,
"type": 1,
"mid": 11814633,
"root": 3030790837,
"parent": 3030790837,
"dialog": 3030978856,
"count": 0,
"rcount": 0,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592020635,
"rpid_str": "3030978856",
"root_str": "3030790837",
"parent_str": "3030790837",
"like": 60,
"action": 0,
"member": {
"mid": "11814633",
"uname": "我到四川省来",
"sex": "保密",
"sign": "保持内心的平静",
"avatar": "http://i0.hdslb.com/bfs/face/1c7cad967633c718ddef302f4aa39efaed53a2e4.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 1885,
"name": "公主连结凯露",
"image": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"expire": 0,
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 3,
"name": "白银殿堂",
"image": "http://i0.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png",
"image_small": "http://i0.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png",
"level": "高级勋章",
"condition": "单个自制视频总播放数>=10万"
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1715270400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"nickname_color": "#FB7299"
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": {
"id": 1885,
"name": "公主连结凯露",
"image": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"jump_url": "",
"type": "vip",
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"image_enhance_frame": ""
},
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "看有机化学考研视频",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "627天前发布"
}
}
],
"root": {
"rpid": 3030790837,
"oid": 201022189,
"type": 1,
"mid": 342581997,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 268,
"rcount": 230,
"state": 0,
"fansgrade": 0,
"attr": 768,
"ctime": 1592017909,
"rpid_str": "3030790837",
"root_str": "0",
"parent_str": "0",
"like": 8018,
"action": 0,
"member": {
"mid": "342581997",
"uname": "VAN样斯基",
"sex": "保密",
"sign": "",
"avatar": "http://i0.hdslb.com/bfs/face/bc9c6d37b5a4c8b3b0a3cd483fd66e63b1ae0cec.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 5,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1626364800000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "去P站当然只是为了学习啊[doge]",
"plat": 0,
"device": "",
"members": [],
"emote": {
"[doge]": {
"id": 26,
"package_id": 1,
"state": 0,
"type": 1,
"attr": 0,
"text": "[doge]",
"url": "http://i0.hdslb.com/bfs/emote/3087d273a78ccaff4bb1e9972e2ba2a7583c9f11.png",
"meta": {
"size": 1
},
"mtime": 1645206695,
"jump_title": "doge"
}
},
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": "https://www.bilibili.com/blackboard/foldingreply.html"
},
"up_action": {
"like": true,
"reply": true
},
"show_follow": false,
"invisible": false,
"card_label": [
{
"rpid": 3030790837,
"text_content": "UP主觉得很赞",
"text_color_day": "#757575",
"text_color_night": "#939393",
"label_color_day": "#F4F4F4",
"label_color_night": "#1E1E1E",
"image": "",
"type": 0,
"background": "",
"background_width": 0,
"background_height": 0,
"jump_url": ""
}
],
"reply_control": {
"up_reply": true,
"sub_reply_entry_text": "共230条回复",
"sub_reply_title_text": "相关回复共230条",
"time_desc": "627天前发布"
}
},
"show_bvid": true,
"show_text": "",
"show_type": 2,
"upper": {
"mid": 92586428
}
}
}
```
</details>
## 获取指定评论对话树
> https://api.bilibili.com/x/v2/reply/dialog/cursor
*请求方式：GET*
认证方式：Cookie（SESSDATA）或APP
按照对话链排列
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | ---------------------------------------- |
| access_key | str | APP登录 Token | APP 方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区 id | 必要 | |
| root | num | 根回复 rpid | 必要 | |
| dialog | num | 对话树根 rpid | 必要 | |
| size | num | 每页最大项数 | 必要 | |
| min_floor | num | (?) | 非必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | -------------- | ---- |
| cursor | obj | 页楼层信息 | |
| dialog | obj | 对话楼层信息 | |
| replies | array | 评论对话树列表 | |
| assist | num | (?) | |
| blacklist | num | (?) | |
| vote | num | (?) | |
| lottery | num | (?) | |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主 mid | |
| show_bvid | bool | 显示 bvid? | |
| control | obj | 评论区输入属性 | |
| note | num | (?) | |
`data`中的`cursor`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ---------------- | ---- |
| min_floor | num | 本页最低对话楼层 | |
| max_floor | num | 本页最高对话楼层 | |
| size | num | 本页项数 | |
`data`中的`dialog`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------------------- | ---- |
| min_floor | num | 二级评论最低对话楼层 | |
| max_floor | num | 二级评论最高对话楼层 | |
`data`中的`replies`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------ | -------------------------------------- |
| 0 | obj | 对话评论条目 1 | [对象定义见表](readme.md#评论条目对象) |
| n | obj | 对话评论条目 (n+1) | 按照对话链排列 |
| …… | obj | …… | …… |
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------- | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | ？ | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP 觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`upper`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---- |
| mid | num | UP 主 mid | |
`data`中的`control`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------------ | ---- | ------------------ | ----------------------------------- |
| input_disable | bool | (?) | |
| root_input_text | str | 评论框文字 | |
| child_input_text | str | 评论框文字 | |
| bg_text | str | 空评论区文字 | |
| web_selection | bool | 评论是否筛选后可见 | false：无需筛选<br />true：需要筛选 |
| answer_guide_text | str | 答题页面链接文字 | |
| answer_guide_icon_url | str | 答题页面图标 url | |
| answer_guide_ios_url | str | 答题页面 ios url | |
| answer_guide_android_url | str | 答题页面安卓 url | |
**示例：**
获取视频`av201022189`下评论`rpid=3030790837`的对话`rpid=3030978856`，每页最大5项
```shell
curl -G 'https://api.bilibili.com/x/v2/reply/dialog/cursor' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=201022189' \
--data-urlencode 'root=3030790837' \
--data-urlencode 'dialog=3030978856' \
--data-urlencode 'size=5' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"cursor": {
"min_floor": 5,
"max_floor": 99,
"size": 5
},
"dialog": {
"min_floor": 0,
"max_floor": 243
},
"replies": [
{
"rpid": 3030978856,
"oid": 201022189,
"type": 1,
"mid": 11814633,
"root": 3030790837,
"parent": 3030790837,
"dialog": 3030978856,
"count": 0,
"rcount": 0,
"floor": 5,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592020635,
"rpid_str": "3030978856",
"root_str": "3030790837",
"parent_str": "3030790837",
"like": 60,
"action": 0,
"member": {
"mid": "11814633",
"uname": "我到四川省来",
"sex": "保密",
"sign": "保持内心的平静",
"avatar": "http://i0.hdslb.com/bfs/face/1c7cad967633c718ddef302f4aa39efaed53a2e4.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 1885,
"name": "公主连结凯露",
"image": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"expire": 0,
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 3,
"name": "白银殿堂",
"image": "http://i2.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png",
"image_small": "http://i0.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png",
"level": "高级勋章",
"condition": "单个自制视频总播放数>=10万"
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1715270400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"nickname_color": "#FB7299"
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": {
"id": 1885,
"name": "公主连结凯露",
"image": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"jump_url": "",
"type": "vip",
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"image_enhance_frame": ""
},
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "看有机化学考研视频",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "627天前发布"
}
},
{
"rpid": 3049044835,
"oid": 201022189,
"type": 1,
"mid": 34598825,
"root": 3030790837,
"parent": 3032092982,
"dialog": 3030978856,
"count": 0,
"rcount": 0,
"floor": 54,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592368714,
"rpid_str": "3049044835",
"root_str": "3030790837",
"parent_str": "3032092982",
"like": 1,
"action": 0,
"member": {
"mid": "34598825",
"uname": "人宇君sayo",
"sex": "男",
"sign": "",
"avatar": "http://i2.hdslb.com/bfs/face/bf61490cabaedd8e98740f2c98a342ac6d2c607d.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1629561600000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "回复 @緑箭口香糖 :牛的",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "623天前发布"
}
},
{
"rpid": 3049581999,
"oid": 201022189,
"type": 1,
"mid": 479083152,
"root": 3030790837,
"parent": 3030978856,
"dialog": 3030978856,
"count": 0,
"rcount": 0,
"floor": 93,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592378703,
"rpid_str": "3049581999",
"root_str": "3030790837",
"parent_str": "3030978856",
"like": 2,
"action": 0,
"member": {
"mid": "479083152",
"uname": "人间多了许茫然",
"sex": "保密",
"sign": "无聊...\n",
"avatar": "http://i0.hdslb.com/bfs/face/6e7ee177b5cc681b9609c07f8d5eb574b52d409c.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 5,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1632240000000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": null,
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "回复 @我到四川省来 :哈哈，考研不考化学吧",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "623天前发布"
}
},
{
"rpid": 3049578129,
"oid": 201022189,
"type": 1,
"mid": 11814633,
"root": 3030790837,
"parent": 3049581999,
"dialog": 3030978856,
"count": 0,
"rcount": 0,
"floor": 94,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592378760,
"rpid_str": "3049578129",
"root_str": "3030790837",
"parent_str": "3049581999",
"like": 1,
"action": 0,
"member": {
"mid": "11814633",
"uname": "我到四川省来",
"sex": "保密",
"sign": "保持内心的平静",
"avatar": "http://i0.hdslb.com/bfs/face/1c7cad967633c718ddef302f4aa39efaed53a2e4.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 1885,
"name": "公主连结凯露",
"image": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"expire": 0,
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 3,
"name": "白银殿堂",
"image": "http://i2.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png",
"image_small": "http://i0.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png",
"level": "高级勋章",
"condition": "单个自制视频总播放数>=10万"
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1715270400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"nickname_color": "#FB7299"
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": {
"id": 1885,
"name": "公主连结凯露",
"image": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"jump_url": "",
"type": "vip",
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/ecf1b11044845abc92e576dfdf93ad4f5e5a0958.png",
"image_enhance_frame": ""
},
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "回复 @转手告别旧生活 :专业课 考啊",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "623天前发布"
}
},
{
"rpid": 3049748009,
"oid": 201022189,
"type": 1,
"mid": 39891232,
"root": 3030790837,
"parent": 3032092982,
"dialog": 3030978856,
"count": 0,
"rcount": 0,
"floor": 99,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1592382373,
"rpid_str": "3049748009",
"root_str": "3030790837",
"parent_str": "3032092982",
"like": 1,
"action": 0,
"member": {
"mid": "39891232",
"uname": "夏次一町and庵野一洋",
"sex": "保密",
"sign": "嘚儿~驾!",
"avatar": "http://i1.hdslb.com/bfs/face/79fbbc56271053565f6dd4395cd77120bad7c568.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 5,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 452,
"name": "灵笼",
"image": "http://i1.hdslb.com/bfs/face/9c5f14d6749daded668f3f66998baf4a50e7d8da.png",
"expire": 0,
"image_enhance": "http://i1.hdslb.com/bfs/face/9c5f14d6749daded668f3f66998baf4a50e7d8da.png",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1628870400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": ""
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": {
"pendant": {
"id": 452,
"name": "灵笼",
"image": "http://i0.hdslb.com/bfs/face/9c5f14d6749daded668f3f66998baf4a50e7d8da.png",
"jump_url": "",
"type": "vip",
"image_enhance": "http://i0.hdslb.com/bfs/face/9c5f14d6749daded668f3f66998baf4a50e7d8da.png",
"image_enhance_frame": ""
},
"cardbg": null,
"cardbg_with_focus": null
},
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "回复 @緑箭口香糖 :不收费啊",
"plat": 0,
"device": "",
"members": [],
"jump_url": {},
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {
"time_desc": "623天前发布"
}
}
],
"assist": 0,
"blacklist": 0,
"vote": 0,
"lottery": 0,
"config": {
"showadmin": 1,
"showentry": 1,
"showfloor": 0,
"showtopic": 1,
"show_up_flag": true,
"read_only": false,
"show_del_log": true
},
"upper": {
"mid": 92586428
},
"show_bvid": false,
"control": {
"input_disable": false,
"root_input_text": "发一条友善的评论",
"child_input_text": "",
"giveup_input_text": "不发没关系，请继续友善哦~",
"bg_text": "看看下面~来发评论吧",
"web_selection": false,
"answer_guide_text": "需要升级成为lv2会员后才可以评论，先去答题转正吧！",
"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_android_url": "https://www.bilibili.com/h5/newbie/entry?navhide=1&re_src=6",
"show_type": 1,
"show_text": "",
"disable_jump_emote": false
},
"note": 1
}
}
```
</details>
## 获取评论区热评
> https://api.bilibili.com/x/v2/reply/hot
*请求方式：GET*
认证方式：Cookie（SESSDATA）或APP
按照热评排列
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | ---------------------------------------- |
| access_key | str | APP登录 Token | APP 方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区 id | 必要 | |
| root | num | 根回复 rpid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---- |
| page | obj | 页面信息 | |
| replies | obj | 热评列表 | |
`data`中的`page`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | -------- | ---- |
| acount | num | 总评论数 | |
| count | num | 热评数 | |
| num | num | 当前页码 | |
| size | num | 每页项数 | |
`data`中的`replies`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | -------------------------------------- |
| 0 | obj | 热评条目 1 | [对象定义见表](readme.md#评论条目对象) |
| n | obj | 热评条目 (n+1) | 按照热评排列 |
| …… | obj | …… | …… |
**示例：**
获取视频`av2`的评论区热评，每页5项，查看第1页
```shell
curl -G 'https://api.bilibili.com/x/v2/reply/hot' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=2' \
--data-urlencode 'ps=5' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"page": {
"acount": 76796,
"count": 60975,
"num": 1,
"size": 5
},
"replies": [
{
"rpid": 476670,
"oid": 2,
"type": 1,
"mid": 58426,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 2733,
"rcount": 2608,
"floor": 2,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1291350931,
"like": 90425,
"action": 0,
"member": null,
"content": {
"message": "貌似没人来",
"plat": 0,
"device": "",
"members": null,
"jump_url": null,
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {}
},
{
"rpid": 917945205,
"oid": 2,
"type": 1,
"mid": 34762090,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 461,
"rcount": 365,
"floor": 17977,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1532071373,
"like": 29795,
"action": 0,
"member": null,
"content": {
"message": "7.20日，站长被封7天\n\n历史性留名[2233娘_卖萌]",
"plat": 0,
"device": "",
"members": null,
"jump_url": null,
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {}
},
{
"rpid": 2576184175,
"oid": 2,
"type": 1,
"mid": 24512285,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 1066,
"rcount": 1000,
"floor": 40932,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1584945297,
"like": 44309,
"action": 0,
"member": null,
"content": {
"message": "人类最古のav号（挂了的不算）也变成bv了[大哭][大哭][大哭]青春结束了",
"plat": 0,
"device": "",
"members": null,
"jump_url": null,
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {}
},
{
"rpid": 495059,
"oid": 2,
"type": 1,
"mid": 2,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 898,
"rcount": 838,
"floor": 5,
"state": 2,
"fansgrade": 0,
"attr": 0,
"ctime": 1291918239,
"like": 34224,
"action": 0,
"member": null,
"content": {
"message": "wwwww",
"plat": 0,
"device": "",
"members": null,
"jump_url": null,
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {}
},
{
"rpid": 646408628,
"oid": 2,
"type": 1,
"mid": 33066927,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 173,
"rcount": 160,
"floor": 10914,
"state": 0,
"fansgrade": 0,
"attr": 0,
"ctime": 1519135750,
"like": 7197,
"action": 0,
"member": null,
"content": {
"message": "第一首:来夢緑 - kagome-kagome ~ 月の眷属達カラオケ\n第二首:dBu music - 千年幻想郷 -Aurora sky edition-\n第三首:Sensitive Heart - 千年幻想郷 ~ History of the Moon\n第四首:Yellow-Zebra - 月の律动~Rhythm of the moon~(东方永夜抄 “千年幻想郷 ~ History of the Moon”)\n第五首:工藤舞 - D.S.F.S(ヴォヤージュ1969)\n第六首:Angelic Quasar - かの郷は永き幻の\n第七首:東方永夜抄 - 黒髪のアマンダ\n第八首:君の美術館 - 千年幻想郷　~ History of the Moon\n\n------------------------\n这些是av:2出现的音乐，应该不会缺少的喵~。（笑） 如果有需要有兴趣的话欢迎复制喵~~(｀・ω・´)\n复制的9818楼的\n前排提示:本视频只有大会员能看",
"plat": 0,
"device": "",
"members": null,
"jump_url": null,
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {}
}
]
}
}
```
</details>
## 获取指定评论信息
该接口已经弃用
<details>
<summary>点击展开折叠内容：</summary>
> https://api.bilibili.com/x/v2/reply/info
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | -------------------------------------------- |
| type | num | 评论区类型代码 | 非必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区 id | 非必要 | |
| rpid | num | 目标评论 rpid | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 评论条目 | [对象定义见表](readme.md#评论条目对象) |
**示例：**
获取视频`av379743801`评论区下`rpid=95737567200`的信息
```bash
curl -G 'https://api.bilibili.com/x/v2/reply/info' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=379743801' \
--data-urlencode 'rpid=95737567200' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"rpid": 95737567200,
"oid": 379743801,
"type": 1,
"mid": 293793435,
"root": 0,
"parent": 0,
"dialog": 0,
"count": 34,
"rcount": 34,
"floor": 382,
"state": 0,
"fansgrade": 0,
"attr": 514,
"ctime": 1639916028,
"like": 154,
"action": 0,
"member": {
"mid": "293793435",
"uname": "社会易姐QwQ",
"sex": "男",
"sign": "普通带砖技术宅，爱好MC 编程 电子，是车万人也是术术人，粉丝群：1136462265，博客：shakianee.top",
"avatar": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"rank": "10000",
"DisplayRank": "0",
"face_nft_new": 0,
"is_senior_member": 0,
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 2511,
"name": "初音未来13周年",
"image": "http://i0.hdslb.com/bfs/garb/item/4f8f3f1f2d47f0dad84f66aa57acd4409ea46361.png",
"expire": 0,
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/fe0b83b53e2342b16646f6e7a9370d8a867decdb.webp",
"image_enhance_frame": "http://i0.hdslb.com/bfs/garb/item/127c507ec8448be30cf5f79500ecc6ef2fd32f2c.png"
},
"nameplate": {
"nid": 4,
"name": "青铜殿堂",
"image": "http://i2.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png",
"image_small": "http://i0.hdslb.com/bfs/face/6707c120e00a3445933308fd9b7bd9fad99e9ec4.png",
"level": "普通勋章",
"condition": "单个自制视频总播放数>=1万"
},
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1675785600000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"nickname_color": "#FB7299"
},
"fans_detail": null,
"following": 0,
"is_followed": 0,
"user_sailing": null,
"is_contractor": false,
"contract_desc": ""
},
"content": {
"message": "这款机器背后发热超级严重。。。。。最烫的时候有60-70℃手不敢摸，而发烫后会降频，最低会降到0.6Ghz[笑哭][笑哭]\n现在解决办法已经出来了https://b23.tv/suUd3g7",
"plat": 0,
"device": "",
"members": null,
"jump_url": null,
"max_line": 999
},
"replies": null,
"assist": 0,
"folder": {
"has_folded": false,
"is_folded": false,
"rule": ""
},
"up_action": {
"like": false,
"reply": false
},
"show_follow": false,
"invisible": false,
"reply_control": {}
}
}
```
</details>
</details>
## 获取评论区评论总数
> https://api.bilibili.com/x/v2/reply/count
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | -------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区 id | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ---- |
| count | num | 评论条数 | |
**示例：**
获取视频`av2`的评论区总计评论条数
```shell
curl -G 'https://api.bilibili.com/x/v2/reply/count' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=2'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 65521
}
}
```
</details>
Reference in New Issue View Git Blame Copy Permalink