接口说明

该接口用于获取视频评论数据。

注意事项

用户首次授权应用后，需要第二天才会产生全部的数据；
注意参数中item_id作为url参数时，必须encode，只对item_id单独进行encode。
三十天内创建的视频，才会返回数据。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/item/get_comment/
HTTP Method	GET
Scope	ma.item.data
权限要求	需要申请权限。需通过控制台-小程序应用下，进入“能力-用户数据能力-抖音账号数据”，申请"近30天视频数据查询"能力权限抖音用户通过小程序tt.showDouyinOpenAuth完成授权，调用/oauth/access_token/ 生成token。示例：act.xxx

请求参数

请求头

access-token必填String

示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

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

content-type必填String

示例：application/json

固定值"application/json"

Query

date_type必填Int64

近7/15天；输入7代表7天、15代表15天

item_id必填String

item_id，仅能查询access_token对应用户上传的视频

open_id必填String

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

通过code2Session获取，用户唯一标志

请求示例
curl --location --request GET 'https://open.douyin.com/api/apps/v1/item/get_comment/?open_id=ba253642-0590-40bc-9bdf-9a1334b94059&item_id=' \
--header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr' \

响应参数

Body展开全部子属性

data必填Struct

展开子属性

err_msg必填String

示例："access_token无效"

错误描述

err_no必填Int32

示例：28001003

错误码

log_id必填String

示例："202405291440576E078D8757B9"

日志id

响应示例
正常响应示例异常响应示例
{
  "data": {
    "extra": {
      "now": 1597213176393,
      "error_code": 0,
      "description": "",
      "sub_error_code": 0,
      "sub_description": "",
      "logid": "202008121419360101980821035705926A"
    },
    "data": {
      "result_list": [
        {
          "date": "yyyy-MM-dd",
          "comment": 200
        }
      ]
    }
  },
  "err_no": 0,
  "err_msg": "",
  "log_id": "202008121419360101980821035705926A"
}

获取视频评论数据在线调试

接口说明

注意事项

基本信息

请求参数

响应参数

获取视频评论数据