TikTok 数据洞察规则

字段权限分级（scope）

面	所需 scope
账号基础字段（username/display_name/profile_image 等）	user.info.basic / user.info.username / user.info.profile
账号统计（followers_count/following_count/total_likes/videos_count）	user.info.stats
账号受众/日指标（audience_/metrics.）	user.insights
视频基础字段（item_id/create_time/share_url/caption 等）	video.list
视频深度指标（reach/完播率/受众分布等）	video.insights

绑定授权 URL 已含全部所需 scope，正常绑定即可用；缺权限时官方报错透传。

数据门槛与延迟（诚实口径）

• 延迟分级：基础字段（username、share_url、item_id、create_time 等）实时；指标类（likes/views/受众分布/metrics 日序列）T+24~48 小时。
• 100 粉门槛：受众分布类字段（audience_genders/countries/cities/ages、audience_activity）需账号 ≥100 粉丝才有数据。
• 365 天停更：帖子发布超 365 天后数据停止更新。
• 7 天沉默衰减：reach、full_video_watched_rate、total_time_watched、average_time_watched、impression_sources、audience_countries 在视频 7 天无互动后不可得（互动后 24-48h 恢复）。
• 数据可得性以 TikTok Analytics（App 内/网页版）为准——Analytics 里没有的指标 API 也没有（账号需先在 App 内开启 Analytics）。
• 违规过滤：涉及音乐版权等违规的帖子不会出现在 video/list 返回中。

端点口径

• tt insight videos：官方 max_count 上限 20；--video-ids 定点查（配 --ad-post-only 过滤仅广告帖）；游标为数值型 epoch 毫秒。
• tt insight account：--start-date/--end-date（UTC，回溯 ≤60 天）才有 metrics 日序列。
• tt insight benchmark：25 个行业类目枚举（如 BEAUTY），返回该行业 8 项平均值（点赞/评论/分享/粉丝数/粉丝增长/互动率/播放量/发帖数）。

来源：TikTok 官方文档（Accounts API › Insights 章节）。