接口说明

获取评论回复列表

使用限制

注意参数中 item_id 作为 url 参数时，必须 encode，只对 item_id 单独进行 encode
注意参数中 comment_id 作为 url 参数时，必须 encode，只对 comment_id 单独进行 encode

基本信息

名称	描述
HTTP URL	https://open.douyin.com/item/comment/reply/list/
HTTP Method	GET
Scope	item.comment
权限要求	需要申请权限需要用户授权申请路径：移动、网站应用控制台-互动权限-管理视频评论

请求参数

请求头

access-token必填String

示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/access_token/生成的token

content-type必填String

示例：application/json

固定值"application/json"

Query

comment_id必填String

示例：%409VwW0qOBUN9mJyD3bNxvGc791GzgOPqBPZZyoA%2BlKVcaZ%2FP860zdRmYqig357zEBTPAmauvAUsItTqnHsp%2BcJw%3D%3D

encode后的评论id，来源于接收评论回复事件

count必填Int32

示例：10

每页的数量，最大不超过20，最小不低于1

device_brand必填String

示例：apple

设备品牌

device_platform必填String

示例：iphone

设备平台

device_type必填String

示例：iPhone13.2

设备类型

ip必填String

示例：127.0.0.1

客户端ip地址（不要传服务端ip，避免影响生产业务）

item_id必填String

示例：%409VwWjvGUTp9kKW%2Bma4huFs791GfuOPuEM5RzrQOuKFAUZ%2Ff660zdRmYqig357zEBoG9CZ3tmAj%2F%2Bzx3ynAUaVA%3D%3D

encode后的视频id

open_id必填String

示例：ba253642-0590-40bc-9bdf-9a1334b94059

通过/oauth/access_token/获取，用户唯一标志

os_version必填String

示例：14.5

操作系统版本号

shark_channel必填String

示例：open_api

通过具体某种渠道发起的请求，例sdk/h5/open_api/system/in_imp/others

cursorInt64

示例：0

分页游标, 第一页请求cursor是0, response中会返回下一页请求用到的cursor, 同时response还会返回has_more来表明是否有更多的数据。

sort_typeString

示例：time

列表排序方式，不传默认按推荐序，可选值：time(时间逆序)、time_asc(时间顺序)

请求示例
curl --location --request GET 'https://open.douyin.com/item/comment/reply/list/?open_id=ec1aa301-641b-4fcd-970c-8b0804c6dd01&cursor=0&count=20&item_id=%409VwW0qOBUN9mJyD3bNxvGc791GzvNPCLPp11oQqvKlMbaPL960zdRmYqig357zEBr7zwUvKC669aK5%2BVMO3qvw%3D%3D&comment_id=%409VwW0qOBUN9mJyD3bNxvGc791GzgOPqBPZZyoA%2BlKVcaZ%2FP860zdRmYqig357zEBTPAmauvAUsItTqnHsp%2BcJw%3D%3D&sort_type=time&device_brand=Apple&device_platform=iphone&device_type=iPhone13%2C2&ip=36.110.186.142&os_version=17.6.1&shark_channel=sdk' \
--header 'Content-Type: application/json' \
--header 'access-token: act.ccfc55d2ac4f4e42d3585b5cc5bec0bbkmrhJe4IKBggGtvCzEpmwccGsl0Q' \

响应参数

Body展开全部子属性

dataStruct

展开子属性

extraStruct

展开子属性

响应示例
正常响应示例异常响应示例
{
  "extra": {
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393,
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": ""
  },
  "data": {
    "error_code": 0,
    "description": "",
    "cursor": 1,
    "has_more": true,
    "list": [
      {
        "create_time": 1607399832,
        "digg_count": 647,
        "reply_comment_total": 12,
        "top": true,
        "comment_id": "",
        "comment_user_id": "",
        "content": "回复内容",
        "avatar": "https://uuue/ehdne",
        "nick_name": "xiaoming"
      }
    ]
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	2100005	参数不合法	自查接口入参类型和取值是否符合规范
200	21000004	系统繁忙，此时请开发者稍后再试	重试后不能解决，提开放平台oncall处理

评论回复列表在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

评论回复列表