开发
API

一、能力介绍

小程序平台联合抖音开放平台,将抖音服务基础设施和创新行业解决方案能力给到小程序开发者们,满足对于内容获取、分享的个性化需求,现已开放内测申请。

能力概览

目前共提供有视频权限、用户权限、互动权限、数据权限、其他特殊权限等五大块能力,可根据自身产品特性进行申请。

视频权限

权限名称权限描述Scope 及文档链接
视频发布及管理服务器端直接发布图片或视频,同时支持获取内容数据以及管理内容状态video.create
video.delete

video.data

video.list
关键词视频管理包含通过关键词获取抖音视频及该视频下评论,并进行回复的能力video.search
video.search.comment

用户权限

权限名称权限详情Scope 及文档链接
关注和粉丝列表搜索用户并获取用户公开信息和关注列表following.list
fans.list
授权动态续期refresh_token 支持动态续期,每次续期+30 天,续期次数上限为 5 次renew_refresh_token

互动权限

权限名称权限详情Scope 及文档链接
评论管理(普通用户)获取并管理评论item.comment

数据权限

权限名称权限详情Scope 及文档链接
用户数据用户授权后,该接口可用于查询用户的获赞、评论、分享,主页访问等相关数据data.external.user
视频管理用户授权后,该接口可用于查询作品的获赞,评论,分享等相关数据data.external.item
粉丝画像数据用户授权后,该接口可用于获取用户粉丝画像数据fans.data
星图数据包含星图达人与达人对应各指数评估分,以及星图 6 大热门维度下的达人榜单star_top_score_display
star_tops

star_top_score_display
抖音影视综榜单数据获取抖音电影榜,电视剧榜以及综艺榜discovery.ent
抖音热点(限时免费)获取抖音热门内容hotsearch
话题榜单数据【限时免费】获取抖音话题榜单数据data.external.billboard_topic
粉丝喜好数据(粉丝喜好、粉丝热评)用户授权后,该接口可用于查询用户粉丝喜好、粉丝热评等相关数据data.external.fans_favourite
热门视频数据【限时免费】获取抖音热门视频数据data.external.billboard_hot_video
粉丝来源数据用户授权后,该接口可用于查询用户的粉丝来源分布占比数据data.external.fans_source
直播榜单数据【限时免费】获取抖音直播榜单数据data.external.billboard_live
音乐榜单数据【限时免费】获取抖音音乐榜单数据data.external.billboard_music
道具榜单数据【限时免费】获取抖音道具榜单数据data.external.billboard_prop
达人榜单数据【限时免费】可获取抖音(搞笑、游戏、美食、体育、娱乐明星、剧情、汽车、旅游、二次元)达人榜单数据data.external.billboard_game
data.external.billboard_drama
data.external.billboard_car
data.external.billboard_amusement
data.external.billboard_cospa
data.external.billboard_food
data.external.billboard_travel
data.external.billboard_stars
data.external.billboard_sport

特殊权限

权限名称权限详情Scope 及文档链接
查询小程序挂载权限提供一个接口给开发者校验小程序 appid 是否可挂载到短视频micapp.is_legal
增量授权请求用户新增授权项时,仅需请求当前权限,且历史已授权项同步更新有效期incremental_authorization

二、权限申请流程

  • 进入开发者平台(https://microapp.bytedance.com/)【功能管理-抖音能力】,点击【前往官网】;
  • 在应用管理下方选择【小程序】,当前仅支持小程序的拥有者管理该权限。选择对应的小程序后,在操作版块点击【权限管理】;
  • 选择需要的权限,点击【申请开通】;
  • 填写相关信息,说明能力使用场景后,点击【提交申请】,平台会于 5 个工作日内完成审核。

三、开发文档

小程序平台提供小程序获取抖音权限的能力,展示出抖音权限授权弹窗,对应开发文档:https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/authorization/tt-show-douyin-open-auth

点击纠错
评价此篇文档