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

通过 API 获取 TikTok 粉丝数和个人资料信息

TikTok 的 API for Business 通过 GET /business/get/ 返回账户的粉丝数,字段名为 followers_count,同时返回 username、display_name、profile_image、bio_description、is_verified、following_count、total_likes 和 videos_count。每个字段都需要相应权限,例如 user.info.stats。Display API 的 /v2/user/info/ 会对已授权应用的用户返回同一数值,字段名为 follower_count。

easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 get_social_insights 读取 TikTok 账户的个人资料和粉丝数:指定 followers_count、total_likes 或 videos_count 等字段,逐日数据则附上日期,返回的数值即 TikTok 的原始数据。

user.info.stats

/business/get/ 顶部的 followers_count、following_count、total_likes 和 videos_count 所需的权限。

Real time

TikTok 更新 followers_count 及个人资料字段的方式,每日指标通常在 24 至 48 小时后才会提供。

follower_count

Display API 在 /v2/user/info/ 中对该数值的名称,其使用专属的 user.info.stats 权限范围。

60 days

/business/get/ 中每日 followers_count 及其他每日指标可回溯的最长时间。

2 fields

请求未指定字段时,/business/get/ 返回 display_name 和 profile_image。

/business/get/ 会返回哪些个人资料字段?

返回 fields 中指定的字段。fields 是查询字符串中的 JSON 数组,每个字段都需要账户所有者在授权应用时授予相应权限才能获取。未指定任何字段的请求只会返回 display_name 和 profile_image。TikTok 会实时更新下列个人资料与粉丝数字段:

usernameThe handle; user.info.username
display_nameThe nickname; user.info.basic
profile_imageA temporary photo URL, expiring at its x-expires time; user.info.basic
bio_descriptionThe bio, or an empty string; user.info.profile
profile_deep_linkA link to the profile page; user.info.profile
is_verifiedWhether TikTok gave the account a verified badge; user.info.profile
followers_countFollowers now, user.info.stats; per day in metrics, user.insights
following_countAccounts it follows; user.info.stats
total_likesLikes on its videos, all time; user.info.stats
videos_countPublic videos posted, all time; user.info.stats
is_business_accountA Verified Business Account or not; user.account.type
has_advanced_accessAdvanced Access or not; user.account.type

如何请求粉丝数?

向 /business/get/ 发送 GET 请求,在 Access-Token 请求头中传入账户的访问令牌,并传入 business_id(即令牌交换所得的 open_id),同时在 fields 中指定所需字段。当前数值位于 data 的顶部,每日数据位于 metrics 中:

Follower count and profile, trimmed from TikTok's example response
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["display_name","followers_count","following_count","is_verified","daily_new_followers","daily_lost_followers"]'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "display_name": "<DISPLAY_NAME>",
    "followers_count": 13,
    "following_count": 2,
    "is_verified": false,
    "metrics": [
      { "date": "<DATE>", "followers_count": 13, "daily_new_followers": 0, "daily_lost_followers": 0 }
    ]
  }
}

如何逐日追踪粉丝数?

在 fields 中指定 followers_count 后,TikTok 会返回两处数据:data 顶部在 user.info.stats 下的累计总数,以及 metrics 中在 user.insights 下每日的总数。start_date 和 end_date(UTC 时间)用于选择日期,最多可回溯 60 天;若未指定,TikTok 返回请求当天之前的 7 天数据。以下三个每日字段显示总数背后的变化,适用于拥有 Advanced Access 或 Verified Business Account 的账户:

  • daily_new_followers:当天新增的粉丝数。
  • daily_lost_followers:当天流失的粉丝数。
  • daily_total_followers:当天的净增长,即新增减去流失的粉丝数。

Display API 返回什么?

对于已授权 TikTok for Developers 应用的用户,它返回同类的个人资料,请求方式为 GET https://open.tiktokapis.com/v2/user/info/,并在 fields 参数中列出所需字段。其字段名和权限与 API for Business 不同,且其 user 对象不包含每日历史数据:

API for Business: /business/get/Display API: /v2/user/info/
Followersfollowers_countfollower_count
Followingfollowing_countfollowing_count
Likestotal_likeslikes_count
Videosvideos_countvideo_count
Count scopeuser.info.statsuser.info.stats
Username scopeuser.info.usernameuser.info.profile
Photoprofile_imageavatar_url, avatar_url_100, avatar_large_url
Daily historyUp to 60 days in metricsNot in the user object

能否读取其他账户的粉丝数?

这两个端点都无法做到。/business/get/ 仅针对已授权应用的账户返回对应 business_id 的数据,/v2/user/info/ 仅针对发起调用的令牌所属用户返回数据。TikTok 的 Research API 提供 /v2/research/user/info/ 端点,接受用户名并返回 follower_count、following_count、likes_count 和 video_count,但仅限 TikTok 批准的研究人员使用。

easyCoexistence 如何读取个人资料?

通过 get_social_insights 读取账户数据,不指定 object_id:metrics 中的名称会成为 /business/get/ 的字段,params 中的 start_date 和 end_date 用于选择日期,返回的结果即 TikTok 的原始数据。metrics 为空列表时,将请求用户名、显示名称、头像、粉丝数、关注数、点赞数和视频数、两个账户级别标志,以及每日视频播放量、主页访问量和新增粉丝数。list_social_accounts 还会显示账户连接时保存的用户名和显示名称。

Follower counts by day through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["followers_count", "following_count", "total_likes", "videos_count"],
  "params": { "start_date": "2026-10-02", "end_date": "2026-10-31" }
}

常见错误

  • 在令牌上未授予 user.info.stats 时请求 followers_count。TikTok 只有在所有者授予相应权限时才会返回各字段,因此所有者需要重新授权应用。
  • 保存 profile_image 以供日后使用。它是临时 URL,其过期时间位于 x-expires 参数中,因此需要时应重新获取。
  • 从 /business/get/ 读取 follower_count。这是 Display API 的字段名;API for Business 将其称为 followers_count。
  • 期望个人账户返回新增和流失粉丝数。TikTok 仅对拥有 Advanced Access 或 Verified Business Account 的账户返回这些每日字段。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 起,随连接数增加降至 US$ 0.75,前 3 天免费试用。

常见问题

TikTok API 能否展示粉丝增长趋势?

可以,最多 60 天:metrics 中每天的 followers_count,以及拥有 Advanced Access 或 Verified Business Account 的账户可获得的每日新增、流失和净增粉丝数。

TikTok 粉丝数需要哪个权限?

user.info.stats,两个 API 通用:它可解锁 /business/get/ 中的 followers_count,以及 Display API 的 /v2/user/info/ 中的 follower_count。

个人 TikTok 账户能否返回粉丝数?

可以。followers_count 取决于权限,而非账户级别;只有部分每日字段需要 Advanced Access 或 Verified Business Account。

TikTok 粉丝数多久更新一次?

顶层 followers_count 标记为实时,而 metrics 中的每日数据通常会晚 24 至 48 小时到达,时间以 UTC 计。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间