视频数据

查询抖音端内用户的视频列数据和视频基本信息。
支持的应用类型:小程序、移动应用、网站应用
能力类型:
小程序能力分级:进阶能力
是否可用于沙盒环境:
支持的调用方:自研、服务商代开发

能力介绍

在经过用户授权的情况下可查询用户的视频列表数据,包括视频基本信息(标题、封面、是否置顶、创建时间等)。

使用场景

可与发布内容至抖音能力联合使用,在发布视频时调起授权弹窗,引导用户授权;待用户发布视频后可获取视频相关信息用于展示在相关页面上或数据分析。

视频数据主要分为两类:

数据类型

数据说明

实时数据

视频列表的核心数据包括:

  • 类型:图集/视频
  • 视频id
  • 视频标题
  • 封面
  • 是否置顶
  • 视频创建时间


某视频的信息数据包括:

  • poi地理位置:国家/省/市/区/经纬度等

准入条件

暂无准入条件,任一应用均可申请能力。

接入流程

移动/网站应用:自研开发者仅可在页面申请能力。

小程序:自研开发者可通过抖音开放平台页面或接口两种方式申请及管理能力,服务商仅可通过接口代客户小程序管理能力(详见接口列表);


页面操作步骤如下:

步骤

说明

申请能力

移动/网站应用

登录抖音开放平台,选择某移动应用或网站应用,在能力管理页面申请相关能力,获取上述数据需申请2个能力:

  1. 「内容运营-视频信息数据」能力;
  2. 「内容运营-视频互动数据」能力;


小程序应用

登录抖音开放平台,选择要申请能力的小程序,在能力管理页面申请相关能力,获取上述数据需申请2个能力,查询POI地点信息能力暂时不能通过小程序获取:

  1. 「视频权限-视频查询」能力;
  2. 「数据权限-视频数据」能力。

填写信息提交申请

  • 申请该能力时需填写真实的使用场景;
  • 若开通后,发现开发者在使用过程中滥用此能力,对用户或平台造成负面影响,平台将有权利随时对该功能进行收回,并视情况进行处罚。

平台审核

平台会根据信息填写的完整度及合理性进行审核,审核时间为 2-3 个工作日。

启动开发

  1. 开发者可先获取 share_id,用来追踪分享的视频是否成功,并获取具体视频信息;
  2. 订阅开放平台 Webhooks 创建视频消息,具体参照Webhooks。通过该视频消息可以拿到 share_id 和视频 item_id 关系,开发者可以根据第二步获取的 share_id 自行匹配 item_id。
  3. 可以根据 Webhooks 获取的 item_id 通过接口获取用户发布的视频,并获取到视频的分享 URL。

相关文档

文档名称

链接

小程序调用能力的方法说明

查看文档

接口列表


API名称

API类型

API描述

接口文档

小程序申请能力

申请能力

OpenAPI

自研开发者可通过该接口申请能力

查看文档

查询申请结果及能力信息

OpenAPI

自研开发者可通过该接口查询申请结果及能力相关信息

查看文档

申请及查询能力(服务商调用)

OpenAPI

服务商可通过该系列接口申请该能力并查询能力使用状态

查看文档

小程序申请提额

scope申请提额

OpenAPI

自研开发者可通过该接口为能力申请提额

查看文档

查询scope配额详情

OpenAPI

自研开发者可通过该接口查询提额状态及能力相关信息

查看文档

申请及查询scope配额信息(服务商调用)

OpenAPI

服务商可通过该接口为能力申请配额并查询申请结果

查看文档

授权

移动/网站应用获取用户授权

Web/JS/Android/iOS

移动/网站应用通过该接口获取用户授权,用户授权后才可获取相关数据

查看文档

小程序获取用户授权

JSAPI

调用基础库方法 tt.showDouyinOpenAuth 拿到临时票据 ticket

查看文档

OpenAPI

调用抖音开放平台获取 access_token 接口

查看文档

实时数据

获取share_id

OpenAPI

该接口用获取 share_id,share_id用于追踪分享的视频是否成功及获取分享视频的的相关数据

查看文档

查询授权账号视频列表数据

OpenAPI

用于分页获取用户所有视频的数据,返回的数据是实时的

查看文档

查询特定视频数据

OpenAPI

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

查看文档

查询抖音视频来源

OpenAPI

该接口用于查询视频来源端

查看文档

查询视频携带的地点信息

OpenAPI

该接口用于 poi 信息的查询,应用场景为在发布内容时查询并携带该 poi 信息发布至抖音

查看文档

离线数据

获取视频基础数据

OpenAPI

该接口用于获取视频基础数据,三十天内创建的视频,才会返回数据

查看文档

获取视频点赞数据

OpenAPI

该接口用于获取视频点赞数据,三十天内创建的视频,才会返回数据

查看文档

获取视频评论数据

OpenAPI

该接口用于获取视频评论数据,三十天内创建的视频,才会返回数据

查看文档

获取视频播放数据

OpenAPI

该接口用于获取视频播放数据,三十天内创建的视频,才会返回数据

查看文档

获取视频分享数据

OpenAPI

该接口用于获取视频分享数据,三十天内创建的视频,才会返回数据

查看文档

该文档是否对你的开发有所帮助?
有帮助
没帮助
相关能力
发布内容至抖音
用户在第三方APP或网页发布的短视频、图片等题材可分享到抖音作品或朋友聊天中
移动应用
网站应用
视频评论管理
批量获取抖音视频评论内容,便于对评论内容进行统一回复管理
小程序
移动应用
网站应用