用户数据能力
收藏简介
用户数据能力是一套经过用户授权或符合平台规则后，让开发者能够安全、合规地获取和利用相关数据，从而优化服务、实现精准运营的工具集合。
能力类别 | 简要描述 | 主要适用对象 |
抖音账号数据 | 用于获取和用户抖音账号、内容及社交关系相关数据的接口集合。 | 内容运营者、社交功能开发者、数据分析师、需要基于用户社交图谱或内容表现进行个性化推荐或服务的应用。 |
身份数据 | 用于识别和验证用户身份（尤其是商业身份）以及收集销售线索的官方工具。 | 企业、品牌方、需要验证用户商业资质或进行客户关系管理（CRM）及精准营销的应用。 |
设备数据 | 用于获取用户设备地理位置信息（精度和触发方式不同）的接口集合。 | 本 地生活服务（如外卖、到店）、出行导航、同城社交、需要基于位置提供信息或服务（LBS）的应用。 |
注意事项
- •合规性：所有用户数据的获取和使用都必须严格遵守《网络安全法》、《个人信息保护法》等相关法律法规以及抖音开放平台的规则。务必告知用户数据用途并获取明确授权，保护好用户隐私。
- •接口变更：平台能力列表和接口规范可能会有调整。建议时常关注官方公告和文档更新。
- •数据延迟：用户首次授权应用后，部分数据可能需要到第二天才会产生；后续数据通常在第二天十点左右刷新。
- •粉丝数限制：请注意，抖音用户数据的用户统计数据报表，仅展示账号粉丝量为一千以上的数据。对于未达到一千粉丝量的账号，用户授权后也不会展示数据。
- •Token 安全：
access_token 是接口调用的关键凭证，需妥善保管，防止泄露。- •参数编码：调用接口时，如
item_id 作为 URL 参数，必须进行编码。
抖音账号数据
能力名称 | 描述 | 接口文档 |
检查用户粉丝关系 | 检查用户是否关注绑定小程序的抖音号，使用该功能前需通过抖音号管理设置，仅支持品牌号、员工号（能力申请预计 5 个工作日通知审核结果）。 | |
抖音主页数据 | 查询近 30 天该抖音账号的主页数据含点赞、粉丝、评论、分享、主页访问。 | |
近 30 天视频数据 查询 | 查询近30天指定抖音视频的数据，包含标题、发布时间、播放、点赞、评论等。 | |
视频评论数据 | 经用户授权后获取其抖音公开视频下的所有评论及评论回复，包括评论内容、点赞数、回复内容等数据。 |
|
视频数据查询 | 最新 1 天的查询视频 ID 的基础信息（标题、发布时间等）和实时数据（播放、点赞、评论等）。 |
抖音账号数据会分为普通抖音号授权和经营抖音号两种不同的授权方式。
特性维度 | 普通抖音号授权 | 经营抖音号授权 |
权限获取 | 需通过控制台手动申请相关能力权限 | 默认获取权限，完成品牌号、员工号、合作号绑定后即可使用 |
授权方式 | 用户通过小程序 tt.showDouyinOpenAuth 完成授权 | 用户完成经营关系（品牌号、员工号、合作号）授权 |
Token 生成接口 | /oauth/access_token/ | /business_token/ |
Token 示例 | act.xxx | bus_act.xxx |
适用账号类型 | 普通的个人或企业抖音账号 | 经认证的品牌号、员工号、合作号等经营性质账号 |
适用场景 | 需要获取普通用户公开数据或经其授权的数据 | 需要获取与经营账号相关的视频数据、互动数据等，常用于企业或品牌运营分析 |
身份数据
能力名称 | 描述 | 接口文档 |
查询用户经营身份 | 支持查询用户是否具备小程序品牌号、员工号、合作号身份，用于获取用户经营能力授权的前置校验。 | |
线索组件 | 小程序线索组件是抖音小程序官方给线索类经营者提供的便捷能力，通过线索组件，经营者可以直接使用获取手机号能力，可自定义留资方式，在短视频/直播间场景下获得流量精准分发，并支持获取完整的线索数据统计。 查询近 30天 的视频 ID 基础信息（标题、发布时间等）和实时数据（播放、点赞、评论等）。 |
设备数据
能力名称 | 描述 | 接口文档 |
选择地理位置 | 通过内置地图打开指定的地理位置，并推荐附近的POI位置，支持用户选择定位。 | |
模糊地理位置 | 可获取一次用户当前的地理位置信息，在一段时间内若反复获取也仅返回相同的地理位置信息；适用于非频繁定位的场景。 | |
打开地理位置 | 通过内置地图打开指定的地理位置，且地理坐标系格式仅支持GCJ-02。 | |
获取高精度地理位置 | 可实时获取用户精确定位信息，一般适用于打车、外卖等需要频繁获取用户地理位置的场景（能力申请预计5个工作日通知审核结果）。 |
申请权限
- 1.登录开发者平台。
- 2.在右上角点击「控制台」。
- 3.在「我的应用」页面点击「小程序」，在「小程序」页签点击具体应用。
- 4.在应用详情页面左侧导航栏选择「能力」>「用户数据能力」。
- 5.根据实际需求，在「用户数据能力」页面选择相关的 tab 及具体能力，查看准入条件，申请开通。
