Get TikTok followers
Use UniPost account metrics to read TikTok follower count from the normalized account response. You do not need to call a TikTok-native endpoint for this task.
The API to use is GET/v1/accounts/{account_id}/metrics. TikTok followers come from the approved user.info.stats scope and are returned as data.follower_count.
Direct answer
| Question | Answer |
|---|---|
| Which UniPost API gets TikTok followers? | GET/v1/accounts/{account_id}/metrics |
| Which TikTok scope is required? | user.info.stats |
| Which response field should I read? | data.follower_count |
Should I use video.list? | No. video.list is for public videos and post-level TikTok video inventory, not follower count. |
Steps
- List accounts with GET/v1/accounts and pick the TikTok account id. You can filter with
platform=tiktokwhen listing accounts. - Confirm the account is active. If the account was connected before TikTok analytics scopes were granted, reconnect it so the token includes
user.info.stats. - Call GET/v1/accounts/{account_id}/metrics with that account id.
- Read
data.follower_countfrom the response.
Request
Response
Scope notes
user.info.profile powers TikTok profile fields such as username, bio, profile links, and verification status.
user.info.stats powers follower count, following count, likes count, and video count.
video.list powers public videos and post-level TikTok video lookup; it is not the followers API.
Troubleshooting
| Symptom | What to do |
|---|---|
| The account is disconnected or returns a reconnect-required state. | Reconnect the TikTok account so the new token includes user.info.stats. |
The response has an upstream error in platform_specific. | Retry later or surface the request id to support. Upstream rate limits and provider errors are reported separately from real zero counts. |
| The account has zero followers. | Check whether platform_specific.upstream_status is present. If it is absent, the zero is the platform value. |