该接口用于查询用户特定视频的数据，如点赞数、播放数等，返回的数据是实时的。该接口适用于抖音。

接口说明

注意事项

抖音的 OAuth API 以https://open.douyin.com/ 开头。

可以通过videoid转换itemid，获取 item_id（抖音视频 id）。

只返回用户公开的视频数据，未公开的视频数据不会返回。

如果视频设置为了隐私，则返回创建时间为 0 的记录。

权限要求

需要申请权限。需通过控制台-小程序应用下，进入“能力-用户数据能力-抖音账号数据”，申请"视频数据查询"能力权限

抖音用户通过小程序tt.showDouyinOpenAuth完成授权，调用/oauth/access_token/ 生成token。示例：act.xxx

错误码

进入状态码排查工具进行排查。

curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/v1/video/query/?open_id=ba253642-0590-40bc-9bdf-9a1334******' \ --header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka2******' \ --header 'Content-Type: application/json' \ --data-raw '{"item_ids":[""]}'

{ "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==", "is_reviewed": true, "media_type": 2 } ] } }

请求参数

Query 参数

open_id

string

必需

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

示例值:

ba253642-0590-40bc-9bdf-9a1334******

Header 参数

access-token

string

必需

示例值:

act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka2******

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

item_ids

array[string]

可选

item_id 数组，仅能查询 access_token 对应用户上传的视频（与video_ids字段二选一，平台优先处理item_ids） ["@9VwFxf*****"]

示例

返回响应

🟢200成功

application/json

Body

extra

object

必需

logid

string

标识请求的唯一id

必需

now

integer

毫秒级时间戳

必需

error_code

integer

错误码

必需

description

string

错误码描述

必需

sub_error_code

integer

子错误码

必需

sub_description

string

子错误码描述

必需

data

object

必需

error_code

integer

必需

description

string

必需

list

array [object {11}]

必需

查询特定视频的视频数据

接口说明#

注意事项#

权限要求#

错误码#

请求参数

返回响应

接口说明

注意事项

权限要求

错误码