请求方式:GET
认证方式:Cookie(SESSDATA)或APP
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
access_key | str | APP 登录 Token | APP 方式必要 | |
type | num | 评论区类型代码 | 必要 | 类型代码见表 |
oid | num | 目标评论区 id | 必要 | |
sort | num | 排序方式 | 非必要 | 默认为0 0:按时间 1:按点赞数 2:按回复数 |
nohot | num | 是否不显示热评 | 非必要 | 默认为0 1:不显示 0:显示 |
ps | num | 每页项数 | 非必要 | 默认为20 定义域:1-20 |
pn | num | 页码 | 非必要 | 默认为1 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 -404:无此项 12002:评论区已关闭 12009:评论主体的type不合法 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | 正确时:obj 错误时:null |
数据本体 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
page | obj | 页信息 | |
config | obj | 评论区显示控制 | |
replies | 禁用时:null 正常时:array |
评论列表 | |
hots | 禁用时:null 正常时:array |
热评列表 | |
upper | obj | 置顶评论 | |
top | null | (?) | |
notice | 无效时:null 有效时: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 | 对象定义见表 |
n | obj | 评论条目 (n+1) | 按照指定的顺序排列 |
…… | obj | …… | …… |
data
中的hots
数组:
项 | 类型 | 内容 | 备注 |
---|---|---|---|
0 | obj | 热评条目 1 | 对象定义见表 |
n | obj | 热评条目 (n+1) | 按照热评热度排列 |
…… | obj | …… | …… |
data
中的upper
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
mid | num | UP 主 mid | |
top | 有效时:obj 无效时:null |
置顶条目 | 对象定义见表 |
vote | 有效时:obj 无效时: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:无需筛选 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页
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'
查看响应示例:
{
"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
}
}
}
请求方式:GET
鉴权方式:Wbi 签名
注: Wbi 签名错误时返回 -403 而非 -352
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
access_key | str | APP 登录 Token | APP 方式必要 | |
type | num | 评论区类型代码 | 必要 | 类型代码见表 |
oid | num | 目标评论区 id | 必要 | |
mode | num | 排序方式 | 非必要 | 默认为 3 0 3:仅按热度 1:按热度+按时间 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 当 URL 参数 mode 为 3 时, 此项为 1 |
direction | num | 方向 | 1: 正序(默认) 2: 倒序 |
data | obj | 分页数据 | 当 type 为 1 时存在 |
Data | obj | 分页数据 | 当 type 为 3 时存在 |
offset
中的 data
(type=1):
参数名 | 类型 | 内容 | 备注 |
---|---|---|---|
pn | num | 页码 (上次响应 data.cursor.next 的值) |
offset
中的 Data
(type=3):
参数名 | 类型 | 内容 | 备注 |
---|---|---|---|
cursor | num | 上次响应 data.cursor.next 的值 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 -404:无此项 12002:评论区已关闭 12009:评论主体的type不合法 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | 正确时:obj 错误时:null |
数据本体 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
cursor | obj | 游标信息 | |
hots | 禁用时:null 正常时:array |
热评列表 | |
notice | 无效时:null 有效时:obj |
评论区公告信息 | |
replies | 禁用时:null 正常时:array |
评论列表 | |
top | obj | 置顶信息 | |
top_replies | obj | 置顶评论 | 对象定义见表 |
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:否 true:是 |
prev | num | 上页页码 | |
next | num | 下页页码 | |
is_end | bool | 是否为最后页 | false:否 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 | 对象定义见表 |
n | obj | 热评条目 (n+1) | 按照热评热度排列 |
…… | obj | …… | …… |
data
中的replies
数组:
项 | 类型 | 内容 | 备注 |
---|---|---|---|
0 | obj | 评论条目 1 | 对象定义见表 |
n | obj | 评论条目 (n+1) | 按照指定的顺序排列 |
…… | obj | …… | …… |
data
中的top
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
admin | 有效时:obj 无效时:null |
管理员置顶条目 | 对象定义见表 |
upper | 有效时:obj 无效时:null |
UP 主置顶条目 | 对象定义见表 |
vote | 有效时:obj 无效时:null |
投票置顶条目 | 对象定义见表 |
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:无需筛选 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
的评论区明细, 按时间排序, 第一页
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'
查看响应示例:
{
"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": ""
}
}
请求方式:GET
认证方式:Cookie(SESSDATA)或APP
按照回复顺序排序
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
access_key | str | APP登录 Token | APP 方式必要 | |
type | num | 评论区类型代码 | 必要 | 类型代码见表 |
oid | num | 目标评论区 id | 必要 | |
root | num | 根回复 rpid | 必要 | |
ps | num | 每页项数 | 非必要 | 默认为20 定义域:1-49 但 data_replies 的最大内容数为20,因此设置为49其实也只会有20条回复被返回 |
pn | num | 页码 | 非必要 | 默认为1 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 -404:无此项 12002:评论区已关闭 12009:评论主体的type不合法 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | 正确时:obj 错误时:null |
数据本体 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
config | obj | 评论区显示控制 | |
control | obj | 评论区输入属性 | |
page | obj | 页面信息 | |
replies | array | 评论对话树列表 | 最大内容数为20 |
root | obj | 根评论信息 | 对象定义见表 |
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:无需筛选 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 | 对象定义见表 |
n | obj | 对话评论条目 (n+1) | 按照回复顺序排列 |
…… | obj | …… | …… |
data
中的upper
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
mid | num | UP 主 mid |
示例:
获取视频av201022189
下评论rpid=3030790837
的回复,每页5项,获取第1页
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'
查看响应示例:
{
"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
}
}
}
请求方式:GET
认证方式:Cookie(SESSDATA)或APP
按照对话链排列
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
access_key | str | APP登录 Token | APP 方式必要 | |
type | num | 评论区类型代码 | 必要 | 类型代码见表 |
oid | num | 目标评论区 id | 必要 | |
root | num | 根回复 rpid | 必要 | |
dialog | num | 对话树根 rpid | 必要 | |
size | num | 每页最大项数 | 必要 | |
min_floor | num | (?) | 非必要 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 -404:无此项 12002:评论区已关闭 12009:评论主体的type不合法 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | 正确时:obj 错误时: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 | 对象定义见表 |
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:无需筛选 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项
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'
查看响应示例:
{
"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
}
}
请求方式:GET
认证方式:Cookie(SESSDATA)或APP
按照热评排列
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
access_key | str | APP登录 Token | APP 方式必要 | |
type | num | 评论区类型代码 | 必要 | 类型代码见表 |
oid | num | 目标评论区 id | 必要 | |
root | num | 根回复 rpid | 必要 | |
ps | num | 每页项数 | 非必要 | 默认为20 定义域:1-49 |
pn | num | 页码 | 非必要 | 默认为1 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 -404:无此项 12002:评论区已关闭 12009:评论主体的type不合法 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | 正确时:obj 错误时:null |
数据本体 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
page | obj | 页面信息 | |
replies | obj | 热评列表 |
data
中的page
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
acount | num | 总评论数 | |
count | num | 热评数 | |
num | num | 当前页码 | |
size | num | 每页项数 |
data
中的replies
数组:
项 | 类型 | 内容 | 备注 |
---|---|---|---|
0 | obj | 热评条目 1 | 对象定义见表 |
n | obj | 热评条目 (n+1) | 按照热评排列 |
…… | obj | …… | …… |
示例:
获取视频av2
的评论区热评,每页5项,查看第1页
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'
查看响应示例:
{
"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": {}
}
]
}
}
该接口已经弃用
点击展开折叠内容:
请求方式:GET
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
type | num | 评论区类型代码 | 非必要 | 类型代码见表 |
oid | num | 目标评论区 id | 非必要 | |
rpid | num | 目标评论 rpid | 必要 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 -404:无此项 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | 正确时:obj 错误时:null |
评论条目 | 对象定义见表 |
示例:
获取视频av379743801
评论区下rpid=95737567200
的信息
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'
查看响应示例:
{
"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": {}
}
}
请求方式:GET
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
type | num | 评论区类型代码 | 必要 | 类型代码见表 |
oid | num | 目标评论区 id | 必要 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 -404:无此项 12009:评论主体的type不合法 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | 正确时:obj 错误时:null |
数据本体 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
count | num | 评论条数 |
示例:
获取视频av2
的评论区总计评论条数
curl -G 'https://api.bilibili.com/x/v2/reply/count' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=2'
查看响应示例:
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 65521
}
}