Analytics

Get TikTok follower demographics

Changed on

Returns 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

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

successboolean
accountIdstring
platform'tiktok'
metric'follower_demographics'
demographicsobject

Only the requested breakdowns are present. Entries are sorted by value, largest first.

notestring

Changes