查询特定视频的视频数据
Scope: video.data 需要用户授权 需要申请权限 该接口 用于查询用户特定视频的数据, 如点赞数, 播放数等,返回的数据是实时的。该接口适用于抖音。只返回用户公开的视频数据,未公开的视频数据不会返回。如果视频设置为了隐私,则返回创建时间为 0 的记录。
注意:
- 抖音的 OAuth API 以https://open.douyin.com/开头。
有两种方式获取 item_id(抖音视频 id):
状态码排查
请求地址
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"
}
}
诚邀您对本文档易读易用性进行评价
好用
不好用