抖音开放平台Logo
控制台

获取视频评论数据

收藏
我的收藏

接口说明

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


注意事项

  • 用户首次授权应用后，需要第二天才会产生全部的数据；
  • 注意参数中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-tokenString是act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/access_token/生成的token
content-typeString是application/json
固定值"application/json"

请求参数

Query

名称字段类型是否必填示例描述
date_typeInt64是
近7/15天；输入7代表7天、15代表15天
item_idString是

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

open_idString是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

名称字段类型是否必填示例描述
err_msgString是"access_token无效"
错误描述
err_noInt32是28001003
错误码
log_idString是"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"
}

异常响应示例

{
  "data": {
    "extra": {
      "error_code": 2100005,
      "description": "Parameter error",
      "sub_error_code": 0,
      "sub_description": "",
      "now": 1594015876138,
      "log_id": "202008121419360101980821035705926A"
    }
  },
  "err_no": 0,
  "err_msg": "",
  "log_id": "202008121419360101980821035705926A"
}