通过 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 的原始数据。
/business/get/ 顶部的 followers_count、following_count、total_likes 和 videos_count 所需的权限。
TikTok 更新 followers_count 及个人资料字段的方式,每日指标通常在 24 至 48 小时后才会提供。
Display API 在 /v2/user/info/ 中对该数值的名称,其使用专属的 user.info.stats 权限范围。
/business/get/ 中每日 followers_count 及其他每日指标可回溯的最长时间。
请求未指定字段时,/business/get/ 返回 display_name 和 profile_image。
/business/get/ 会返回哪些个人资料字段?
返回 fields 中指定的字段。fields 是查询字符串中的 JSON 数组,每个字段都需要账户所有者在授权应用时授予相应权限才能获取。未指定任何字段的请求只会返回 display_name 和 profile_image。TikTok 会实时更新下列个人资料与粉丝数字段:
如何请求粉丝数?
向 /business/get/ 发送 GET 请求,在 Access-Token 请求头中传入账户的访问令牌,并传入 business_id(即令牌交换所得的 open_id),同时在 fields 中指定所需字段。当前数值位于 data 的顶部,每日数据位于 metrics 中:
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/ | |
|---|---|---|
| Followers | followers_count | follower_count |
| Following | following_count | following_count |
| Likes | total_likes | likes_count |
| Videos | videos_count | video_count |
| Count scope | user.info.stats | user.info.stats |
| Username scope | user.info.username | user.info.profile |
| Photo | profile_image | avatar_url, avatar_url_100, avatar_large_url |
| Daily history | Up to 60 days in metrics | Not 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 还会显示账户连接时保存的用户名和显示名称。
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 的账户返回这些每日字段。
每个连接每月 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 监控
验证时间