接口说明

获取评论回复列表

使用限制

注意参数中 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