Analytics
Get TikTok follower demographics
Changed onReturns the share of a TikTok account's followers by age, gender, country and city. Without breakdown it returns all four.
- Each value is a share of followers from 0 to 1, and each list is sorted largest first. It is not a follower count.
- Age, gender and country lists add up to 1. The city list can add up to less, because TikTok does not place every follower in a listed city.
- These are followers of the account, not the viewers of its videos. Viewer countries per video are on GET /v1/analytics?postId=...
- TikTok updates this data every 24-48 hours.
Requirements
- The account needs at least 100 followers (400 tiktok_insufficient_followers otherwise).
- The account owner must turn on Analytics in the TikTok app and have published at least one video. Until then an account with enough followers gets empty lists.
- Requires the user.insights scope, which an account gets by connecting through the TikTok for Business app (412 tiktok_insights_scope_missing otherwise). Accounts on the original TikTok integration must reconnect.
- Requires the Analytics add-on.
get/v1/analytics/tiktok/demographics
Request
- Base URLhttps://zernio.com/api
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
accountIdstring required
The Zernio SocialAccount ID for the TikTok account.
breakdownstring
Comma-separated list of demographic dimensions: age, gender, country, city. Defaults to all four.
Response
Follower demographics for the account
Changes
- info
endpoint added
- info