TikTok Analytics API:账户洞察与视频指标
TikTok 的 API for Business 按日返回账户指标,包括粉丝数、视频观看量、主页访问量、点赞、评论和分享,最多可查询过去 60 天。每个视频还可获取全部时间的累计数据,如观看量、点赞、评论和分享。大多数数据会延迟 24 至 48 小时,并且依赖于应用中已开启的 TikTok Analytics。
easyCoexistence 通过 get_social_insights 读取 TikTok 数据,可在 Claude、ChatGPT 或您自己的代码中调用:账户的粉丝数、观看量和点赞数按日统计,或单个视频的观看量、点赞、评论和分享。
账户每日指标的最长回溯期;不指定日期时,API 返回最近 7 天的数据。
每日数据及单帖计数(如点赞、观看量和分享)通常的延迟时长。
帖子发布后,其数据停止更新的时间点。
TikTok 返回粉丝年龄、性别和地区细分数据所需的账户粉丝数门槛。
有哪些账户指标?
GET /business/get/ 返回账户资料,以及所查询日期的指标列表,每天一条记录,时间为 UTC:
followers_count:当前总数,以及每天的总数。video_views、profile_views、likes、comments 和 shares:账户视频的每日合计数。unique_video_views、daily_new_followers、daily_lost_followers和engaged_audience:每日数据,适用于拥有 Advanced Access 或 Verified Business Accounts 的账户。audience_ages、audience_genders、audience_countries和audience_cities:粉丝细分数据,适用于至少有 100 名粉丝的账户。
有哪些视频指标?
GET /business/video/list/ 返回账户的公开帖子及其累计数据,不受 60 天回溯期限制:包括 video_views、likes、comments、shares 和 favorites,以及覆盖人数、观看时长总计与平均值、完整观看率、新增粉丝和流量来源。每页最多返回 20 条帖子,filters.video_ids 可筛选特定帖子。
数据的更新时效如何?
用户名和当前粉丝总数等资料字段为实时更新。每日账户指标,以及观看量、点赞、评论和分享等帖子数据,通常延迟 24 至 48 小时(以 UTC 计);帖子数据在发布后 365 天停止更新。若某视频超过 7 天无人观看、点赞、评论或分享,其覆盖人数、观看时长和流量来源可能缺失。
为什么指标可能缺失?
API 返回的是 TikTok Analytics 中已有的数据。账户拥有者需要至少发布一条视频,并在 TikTok 应用中开启 Analytics,开启之前的数据无法获取。部分指标要求更高:触达受众,以及新增或流失粉丝,仅适用于拥有 Advanced Access 或 Verified Business Accounts 的账户;粉丝细分数据则需要至少 100 名粉丝。
为什么数据可能与 TikTok 应用中的显示不同?
原因在于统计口径不同。video_views 将自然观看与付费观看合并计算,shares 则同时计入 TikTok 之外的分享和应用内发给好友的次数,因此数值可能高于 TikTok 网站上显示的分享数。某一天的点赞数不会扣除之后被撤回的点赞。
easyCoexistence 如何读取这些数据?
通过 get_social_insights 读取。查询账户数据时,请提供 followers_count、video_views 和 likes 等指标,并附上 start_date 与 end_date,它将返回 TikTok 的每日记录。查询单个视频时,将其 item_id 作为 object_id 传入,它会返回观看量、点赞、评论和分享,检索范围为账户最近的 20 条视频;如果是更早的视频,则由您自己的代码调用 business/video/list/ 并使用 filters.video_ids,令牌来自 get_social_credentials。
常见错误
- 把昨天的数据当作最终数据。每日指标可能延迟 24 至 48 小时,因此近期数据可能仍在补充中。
- 请求超过 60 天的账户指标。回溯期到此为止,如需更长的历史数据,请自行保存。
- 用 object_id 查询旧视频。get_social_insights 只检索最近的 20 条;较早的帖子请由您自己的代码按 video_ids 筛选,令牌来自 get_social_credentials。
- 将 API 的分享数与网站数字比较。API 还会计入 TikTok 内发给好友的次数,因此其数值更高。
对于其他 TikTok 数据字段,get_social_credentials 会为您自己的代码提供账户的令牌。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
TikTok API 能显示账户流失了多少粉丝吗?
能。通过 daily_lost_followers 显示,与 daily_new_followers 并列,适用于拥有 Advanced Access 或 Verified Business Accounts 的账户。
TikTok 账户数据最多可以回溯多久?
60 天。不指定日期时,API 返回请求日前一天往前 7 天的数据,以 UTC 计。
TikTok 视频的数据何时停止更新?
发布后 365 天。在此之前,其累计数据仍会更新,通常延迟 24 至 48 小时。
TikTok 视频观看量是否包括付费观看?
包括。API 返回的 video_views 数值同时涵盖自然观看与付费观看。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间