能力介绍
在经过用户授权的情况下可查询用户的视频列表数据,包括视频基本信息(标题、封面、是否置顶、创建时间等)。
使用场景
可与发布内容至抖音能力联合使用,在发布视频时调起授权弹窗,引导用户授权;待用户发布视频后可获取视频相关信息用于展示在相关页面上或数据分析。
视频数据主要分为两类:
数据类型 | 数据说明 |
实时数据 | 视频列表的核心数据包括:
某视频的信息数据包括:
|
准入条件
暂无准入条件,任一应用均可申请能力。
接入流程
移动/网站应用:自研开发者仅可在页面申请能力。
小程序:自研开发者可通过抖音开放平台页面或接口两种方式申请及管理能力,服务商仅可通过接口代客户小程序管理能力(详见接口列表);
页面操作步骤如下:
步骤 | 说明 |
申请能力 | 移动/网站应用 登录抖音开放平台,选择某移动应用或网站应用,在能力管理页面申请相关能力,获取上述数据需申请2个能力:
小程序应用 登录抖音开放平台,选择要申请能力的小程序,在能力管理页面申请相关能力,获取上述数据需申请2个能力,查询POI地点信息能力暂时不能通过小程序获取:
|
填写信息提交申请 |
|
平台审核 | 平台会根据信息填写的完整度及合理性进行审核,审核时间为 2-3 个工作日。 |
启动开发 |
|
相关文档
文档名称 | 链接 |
小程序调用能力的方法说明 |
接口列表
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 | 该接口用于获取视频分享数据,三十天内创建的视频,才会返回数据 |