抖音开放平台Logo
开发者文档
控制台
  • OpenAPI 列表
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 关系能力
  • 内容能力
  • 互动评论
  • 私信群聊
  • 企业号开放能力(内测结束暂不开放)
  • 评论管理(企业号)
  • 评论列表
  • 评论回复列表
  • 回复视频评论
  • 生活服务开放能力
  • 工具能力
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权
  • Scope: video.comment 需要申请权限 需要用户授权
    该接口用于查看指定视频的评论回复列表。
    注意
    能力改造中,暂不开放申请,详情请参考平台公告
    注意:
      调用本接口,需要授权的抖音用户是企业号企业号
      注意参数中item_id作为url参数时,必须encode,只对item_id单独进行encode
      注意参数中comment_id作为url参数时,必须encode,只对comment_id单独进行encode

    状态码排查

    请求地址

    GET /video/comment/reply/list/

    请求头

      Content-Type: application/json
      access-token: 调用/oauth/access_token/生成的token,此token需要用户授权。示例: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

    请求参数

    URL 请求

    参数名称
    参数类型
    参数描述
    参数示例
    是否必填
    count
    i32
    每页的数量,最大不超过50,最小不低于1
    10
    true
    item_id
    string
    视频id
    @8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==
    true
    comment_id
    string
    评论id
    @kj5k4hai123d22nGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==
    true
    open_id
    string
    通过/oauth/access_token/获取,用户唯一标志
    ba253642-0590-40bc-9bdf-9a1334b94059
    true
    cursor
    i64
    分页游标, 第一页请求cursor是0, response中会返回下一页请求用到的cursor, 同时response还会返回has_more来表明是否有更多的数据。
    0
    false

    请求样例

    curl --location --request GET 'https://open.douyin.com/video/comment/reply/list/?count=10&item_id=@8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==&comment_id=@kj5k4hai123d22nGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==&open_id=ba253642-0590-40bc-9bdf-9a1334b94059&cursor=0' \ --header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr' \

    响应参数

    参数名称
    参数类型
    参数描述
    参数示例
    extra
    struct
    logid
    string
    标识请求的唯一id
    202008121419360101980821035705926A
    now
    i64
    毫秒级时间戳
    1597213176393
    error_code
    i32
    错误码
    0
    description
    string
    错误码描述
    sub_error_code
    i32
    子错误码
    0
    sub_description
    string
    子错误码描述
    data
    struct
    list
    []
    struct
    cursor
    i64
    用于下一页请求的cursor
    1
    has_more
    bool
    用于判断是否还有下一页
    true

    响应样例

    { "extra": { "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202008121419360101980821035705926A", "now": 1597213176393, "error_code": 0 }, "data": { "error_code": 0, "description": "", "cursor": 1, "has_more": true, "list": [ { "top": true, "comment_id": "", "comment_user_id": "", "content": "回复内容", "create_time": 1607399832, "digg_count": 647, "reply_comment_total": 12 } ] } }

    响应错误样例

    { "extra": { "error_code": 2100005, "description": "Parameter error", "sub_error_code": 0, "sub_description": "", "now": 1594015876138, "log_id": "2020070614111601022506808001045D59" }, "data": { "error_code": 2100005, "description": "Parameter error" } }