查询特定视频的视频数据

Scope: video.data 需要用户授权 需要申请权限 该接口 用于查询用户特定视频的数据, 如点赞数, 播放数等,返回的数据是实时的。该接口适用于抖音。只返回用户公开的视频数据,未公开的视频数据不会返回。如果视频设置为了隐私,则返回创建时间为 0 的记录。

注意:

有两种方式获取 item_id(抖音视频 id):

  1. 查询视频分享结果和数据
  2. 发布抖音视频

状态码排查

进入【状态码排查工具】

请求地址

POST /video/data/

请求头

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

请求参数

URL 请求

参数名称参数类型参数描述参数示例是否必填
暂无数据

Body 请求

参数名称参数类型参数描述参数示例是否必填
暂无数据

请求样例

响应参数

参数名称参数类型参数描述参数示例是否必填
暂无数据

响应样例

{
  "extra": {
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393,
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": ""
  },
  "data": {
    "error_code": 0,
    "description": "",
    "list": [
      {
        "title": "测试视频 #测试话题 @抖音小助手",
        "create_time": 1571075129,
        "video_status": 5,
        "share_url": "https://www.iesdouyin.com/share/video/QDlWd0EzdWVMU2Q0aU5tKzVaOElvVU03ODBtRHFQUCtLUHBSMHFRT21MVkFYYi9UMDYwemRSbVlxaWczNTd6RUJRc3MrM2hvRGlqK2EwNnhBc1lGUkpRPT0=/?region=CN&mid=6753173704399670023&u_code=12h9je425&titleType=title",
        "cover": "https://p3-dy.byteimg.com/img/tos-cn-p-0015/cfa0d6421bdc4580876cb16974539ff6~c5_300x400.jpeg",
        "is_top": false,
        "statistics": {
          "digg_count": 200,
          "download_count": 10,
          "play_count": 300,
          "share_count": 10,
          "forward_count": 10,
          "comment_count": 100
        },
        "item_id": "@8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==",
        "video_id": "7000000001",
        "is_reviewed": true,
        "media_type": 2
      }
    ]
  }
}

响应错误样例

{
  "data": {
    "error_code": 2100005,
    "description": "Parameter error"
  },
  "extra": {
    "error_code": 2100005,
    "description": "Parameter error",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1594015876138,
    "log_id": "2020070614111601022506808001045D59"
  }
}
诚邀您对本文档易读易用性进行评价
好用
不好用