接口说明

获取抖音短视频评论列表

使用限制

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

基本信息

名称	描述
HTTP URL	https://open.douyin.com/item/comment/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

count必填Int32

示例：10

每页的数量，最大不超过50，最小不低于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，视频id 可以通过查询授权账号视频列表接口或接收评论回复事件获取

open_id必填String

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

用户唯一标志，通过 /oauth/access_token 返回的 open_id 字段获取

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/list/?open_id=43eae150-12eb-4035-8d40-3f9a2bfcdf4e&cursor=0&count=10&item_id=%409VwW0qOBUN9mJyD3bNxvGc791GLuPPGFOJx4rQOvLVAXbvj%2B60zdRmYqig357zEBXe9yX1kW9iI9RBd5IYhjRg%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.0308b91b5f4858eedd25b827fa7ed69ewKUKlr2o6b9zZOe17m4iKlMyZjJB'

响应参数

Body展开全部子属性

dataStruct

展开子属性

extraStruct