评论回复列表
收藏我的收藏
该接口用于查看指定视频的评论回复列表。
注意
注意:
- •抖音的OAuth API以https://open.douyin.com/开头。
- •调用本接口,需要授权的抖音用户是企业号企业号 。
- •注意参数中item_id作为url参数时,必须encode,只对item_id单独进行encode
- •注意参数中comment_id作为url参数时,必须encode,只对comment_id单独进行encode
状态码排查
请求地址
GET /video/comment/reply/list/
请求头
- •Content-Type: application/json
- •access-token: 调用/oauth/access_token/生成的token,此token需要用户授权。示例: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr
请求参数
URL 请求
参数名称 | 参数类型 | 参数描述 | 参数示例 | 是否必填 |
count | i32 | 每页的数量,最大不超过50,最小不低于1 | 10 | true |
item_id | string | 视频id | @8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w== | true |
comment_id | string | 评论id | @kj5k4hai123d22nGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w== | true |
open_id | string | 通过/oauth/access_token/获取,用户唯一标志 | ba253642-0590-40bc-9bdf-9a1334b94059 | true |
cursor | i64 | 分页游标, 第一页请求cursor是0, response中会返回下一页请求用到的cursor, 同时response还会返回has_more来表明是否有更多的数据。 | 0 | false |
请求样例
curl --location --request GET 'https://open.douyin.com/video/comment/reply/list/?count=10&item_id=@8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==&comment_id=@kj5k4hai123d22nGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==&open_id=ba253642-0590-40bc-9bdf-9a1334b94059&cursor=0' \ --header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr' \
响应参数
参数名称 | | 参数类型 | 参数描述 | 参数示例 |
extra | | struct | | |
| logid | string | 标识请求的唯一id | 202008121419360101980821035705926A |
| now | i64 | 毫秒级时间戳 | 1597213176393 |
| error_code | i32 | 错误码 | 0 |
| description | string | 错误码描述 | |
| sub_error_code | i32 | 子错误码 | 0 |
| sub_description | string | 子错误码描述 | |
data | | struct | | |
| list | [] | | |
| | struct | | |
| cursor | i64 | 用于下一页请求的cursor | 1 |
| has_more | bool | 用于判断是否还有下一页 | true |
响应样例
{ "extra": { "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202008121419360101980821035705926A", "now": 1597213176393, "error_code": 0 }, "data": { "error_code": 0, "description": "", "cursor": 1, "has_more": true, "list": [ { "top": true, "comment_id": "", "comment_user_id": "", "content": "回复内容", "create_time": 1607399832, "digg_count": 647, "reply_comment_total": 12 } ] } }
响应错误样例
{ "extra": { "error_code": 2100005, "description": "Parameter error", "sub_error_code": 0, "sub_description": "", "now": 1594015876138, "log_id": "2020070614111601022506808001045D59" }, "data": { "error_code": 2100005, "description": "Parameter error" } }