TikTok audience demographics through the API
TikTok's API for Business returns a TikTok account's follower demographics from GET /business/get/: audience_ages, audience_genders, audience_countries and audience_cities, each a list of shares of followers, for accounts with at least 100 followers. Hourly follower activity comes as audience_activity in each day's metrics, for accounts with Advanced Access or Verified Business Accounts and the same 100 followers. All need the user.insights scope.
easyCoexistence reads a TikTok account's follower demographics with get_social_insights from Claude, ChatGPT or your own code: ask for audience_ages, audience_genders, audience_countries, audience_cities or audience_activity and it returns TikTok's lists as they stand.
Followers an account needs before TikTok returns its age, gender, country and city breakdowns.
Age groups in audience_ages: 18-24, 25-34, 35-44, 45-54 and 55+.
Time zone of audience_activity, the hourly count of followers active on TikTok.
Usual delay for audience_countries, audience_genders and audience_activity, which TikTok computes offline.
Which demographics does the account endpoint return?
GET /business/get/ returns them when they are named in fields. The four breakdowns sit at the top of data, one list per dimension, and the hourly activity sits in metrics, one set per day:
audience_ages: the share of followers in each age group, 18-24, 25-34, 35-44, 45-54 and 55+.audience_genders: the share of followers by gender: Female, Male or Other.audience_countries: the share of followers per country or region, as an ISO 3166-1 alpha-2 code.audience_cities: the share of followers per city, bycity_name.audience_activity: for each day, the followers active on TikTok in each hour, as hour and count.
How do you request them?
With the field names in fields, a JSON array, and a date range in UTC for the daily metrics that carry audience_activity. start_date and end_date reach back up to 60 days, and without them TikTok returns the 7 days up to the day before the request:
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=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
--data-urlencode 'start_date=2026-10-24' \
--data-urlencode 'end_date=2026-10-30'What does the response look like?
Each breakdown is a list of objects pairing a group with its percentage, and each day in metrics carries its date and an audience_activity list of hours. The values below are TikTok's own examples, trimmed to the gender list and a few hours:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"audience_genders": [
{ "gender": "Female", "percentage": 0.7554470336505679 },
{ "gender": "Male", "percentage": 0.24455296634943213 }
],
"metrics": [
{
"date": "<DATE>",
"audience_activity": [
{ "hour": "20", "count": 1 },
{ "hour": "23", "count": 4 },
{ "hour": "7", "count": 4 }
]
}
]
}
}Which accounts get which breakdowns?
Age, gender, country and city shares come once the account has at least 100 followers; TikTok's own example for a 13-follower account returns those lists empty. audience_activity also needs 100 followers, and on top of that an account with Advanced Access, which comes from linking it to a TikTok for Business account or an unverified Business Center, or a Verified Business Account. Every one of these fields needs the user.insights scope on the token.
How fresh are the demographics?
A day or two behind. TikTok lists audience_countries, audience_genders and audience_activity among the fields that usually lag 24 to 48 hours, in UTC, and gives the same update time for ages and cities. The figures come from TikTok Analytics, which the owner turns on in the app after publishing a first video, and data from before that is not available. TikTok bases the demographics on several factors, including what users put in their profiles.
How do follower demographics differ from a video's viewers?
They describe different people. The account lists cover the followers. /business/video/list/ returns breakdowns of the people who watched one post: audience_genders, audience_countries and audience_cities of up to 10 entries each, and audience_types, which splits viewers into new and returning, followers and non-followers. Those need the video.insights scope instead of user.insights.
How does easyCoexistence read them?
With get_social_insights on the account: leave out object_id, list the field names as metrics, and pass start_date and end_date in params when you want audience_activity for particular days. It returns TikTok's lists as they stand, so the shares and hours read exactly as above.
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
"params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}Common mistakes
- Expecting breakdowns for a small account. TikTok returns age, gender, country and city shares from 100 followers, and its example for a 13-follower account shows the lists empty.
- Reading audience_activity hours as local time. TikTok reports them in UTC+0, so shift them to the audience's time zone before planning posts.
- Treating follower demographics as viewer demographics. The account lists describe followers; a video's audience_countries describes the people who watched it.
- Expecting audience_activity on a personal account. TikTok returns it for accounts with Advanced Access or Verified Business Accounts that have at least 100 followers.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Can the TikTok API show my followers' age and gender?
Yes. /business/get/ returns audience_ages and audience_genders, shares of followers per group, once the account has at least 100 followers and the token has user.insights.
Which age groups does TikTok's API use?
18-24, 25-34, 35-44, 45-54 and 55+, each with the share of followers in it.
Does the TikTok API say when my followers are online?
audience_activity gives the followers active on TikTok per hour, in UTC+0, inside each day's metrics, for Advanced Access or Verified Business Accounts with 100 followers or more.
How does the TikTok API give follower countries?
As ISO 3166-1 alpha-2 country or region codes in audience_countries, each with the share of followers from there.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on