该接口用于获取视频基础数据。
权限要求
需要申请权限。需通过控制台-小程序应用下，进入“能力-用户数据能力-抖音账号数据”，申请"近30天视频数据查询"能力权限
抖音用户通过小程序tt.showDouyinOpenAuth完成授权，调用/oauth/access_token/ 生成token。示例：act.xxx

接口说明

注意事项

用户必须在抖音完成创作者服务中心--开通数据看盘能力--立即开通流程，接口才能拿到相应数据

用户首次授权应用后，需要第二天才会产生全部的数据；后续的数据会在第二天十点左右刷新。

注意参数中 item_id 作为 url 参数时，必须 encode，只对 item_id 单独进行 encode。

三十天内创建的视频，才会返回数据。

错误码

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

curl --location --request GET 'http://dev-cn.your-api-server.com/api/apps/v1/item/get_base/?open_id=ba253642-0590-40bc-9bdf-9a1334b94059&item_id=' \ --header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr'

{ "extra": { "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202008121419360101980821035705926A", "now": 1597213176393, "error_code": 0 }, "data": { "error_code": 0, "description": "", "result": { "total_like": 200, "total_comment": 200, "total_share": 200, "avg_play_duration": 200, "total_play": 200 } } }

请求参数

Query 参数

open_id

string

必需

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

示例值:

ba253642-0590-40bc-9bdf-9a1334b94059

item_id

string

必需

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

Header 参数

access-token

string

必需

接口调用凭证，见基本信息的权限要求，调用对应token接口生成

示例值:

act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

返回响应

🟢200成功

application/json

Body

extra

object

必需

description

string

错误码描述

必需

sub_error_code

integer

子错误码

必需

sub_description

string

子错误码描述

必需

logid

string

标识请求的唯一id

必需

now

integer

毫秒级时间戳

必需

error_code

integer

错误码

必需

data

object

必需

error_code

integer

必需

description

string

必需

result

object

必需

获取视频基础数据

接口说明#

错误码#

请求参数

返回响应

接口说明

错误码