登录开始免费试用
easyCoexistence 官方 API

TikTok Analytics API:账户洞察与视频指标

TikTok 的 API for Business 按日返回账户指标,包括粉丝数、视频观看量、主页访问量、点赞、评论和分享,最多可查询过去 60 天。每个视频还可获取全部时间的累计数据,如观看量、点赞、评论和分享。大多数数据会延迟 24 至 48 小时,并且依赖于应用中已开启的 TikTok Analytics。

easyCoexistence 通过 get_social_insights 读取 TikTok 数据,可在 Claude、ChatGPT 或您自己的代码中调用:账户的粉丝数、观看量和点赞数按日统计,或单个视频的观看量、点赞、评论和分享。

60 days

账户每日指标的最长回溯期;不指定日期时,API 返回最近 7 天的数据。

24 to 48 h

每日数据及单帖计数(如点赞、观看量和分享)通常的延迟时长。

365 days

帖子发布后,其数据停止更新的时间点。

100

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 内发给好友的次数,因此其数值更高。
使用 EasyCoexistence 完成这些操作

对于其他 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 监控

验证时间