tiktok/
user-audience

Use the TikTok Audience Demographics API to check which countries a public TikTok account's followers live in from just a username, with each country's name, ISO code, audience share, and sampled follower count.

TikTok Audience Demographics API

Username input
Follower countries
Share per country
20 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

TikTok Audience Demographics

A TikTok account's audience countries show where its followers live, as each country's share of a follower sample together with the number of sampled followers behind that share. TikTok's native analytics keeps this view for the account owner, so a lookup by username is how brands, agencies and analysts check a creator they do not control.

TikTok Audience Demographics API Features

  • Any public username, no loginSend a public username, with or without @, and get its follower geography without access to the account or a TikTok session.
  • Name, ISO code, share and countEach audience_countries entry carries the country name, a two-letter country_code, a share from 0 to 1 and the number of sampled followers behind it.
  • Largest market firstThe TikTok Audience Demographics API orders countries by share, so the first rows say where most of the audience sits and the tail shows the smaller markets.

TikTok Audience Demographics API Parameters

ParametersRequiredDescription
usernameRequiredThe TikTok username to analyze, with or without the leading @.

How to Use the TikTok Audience Demographics API

Submit a username to the TikTok Audience Demographics API, poll the task, and read one audience record.

  1. POST {"username": "khaby.lame"} to /v1/tiktok/user-audience.
  2. Poll GET /v1/tasks/{task_id} every few seconds until status is succeeded.
  3. Read the single record in results.items and iterate over audience_countries.
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'

# The result has one record; audience_countries[].share is a fraction from 0 to 1.

TikTok Audience Demographics API Use Cases

  • Booking a creator for one market: Before paying for a campaign aimed at a single country, read the share that country holds in the creator's followers; a big following that lives elsewhere will not reach your buyers.
  • Checking whether a geo-targeting push works: When you are trying to grow an audience in a new country, run the same username through the TikTok Audience Demographics API on a schedule and compare that country's share between collected_at timestamps.
  • Ruling out markets you cannot serve: Shops and apps that sell in a fixed list of countries can add up the share of those country_code values and drop creators whose followers mostly live outside them.

TikTok Audience Demographics API Pro Tips

  • Divide count by share in a TikTok Audience Demographics API record to see how large the follower sample is; when it is small, treat countries with close shares as tied instead of ranked.
  • Group country_code values into your own regions, such as EU or LATAM, before comparing creators, because campaigns usually target a region rather than one country.

Beyond the TikTok Audience Demographics API, use these APIs when you need a different type of public TikTok data.

  • TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
  • TikTok Followers List API — Collect normalized profiles visible in public follower lists, with retained source context and supported metrics.
  • TikTok Following List API — Collect public profiles followed by TikTok accounts with normalized identity, biographies, visible metrics, and source-account context.
  • TikTok User Videos API — Collect public profile-feed videos by username with captions, creators, media, timestamps, engagement, and source-account context.
  • TikTok Similar Accounts API — Find the accounts TikTok recommends as similar to a username, with follower counts and bios.
  • TikTok Live Ranking API — Get the daily LIVE creator ranking with ranks, gift-based scores, and follower counts.

Explore other platforms

Combine TikTok data with public data from other supported social platforms.

TikTok Audience Demographics API — FAQ

TikTok Audience Demographics API is a programmatic interface for retrieving the countries where a public TikTok account's followers are located, from its username. It returns one record listing each country's name, ISO code, audience share and sampled follower count.

Yes, for any public account. TikTok shows follower locations only to the account owner, while this lookup needs nothing but the username.

No. The record covers follower country only, with no age, gender or city breakdown.

Yes, send your own username and read the countries as data instead of opening TikTok Analytics, which suits reports across several accounts you manage.

Each share comes from a sample of the account's followers, and count tells you how many sampled followers stand behind it. A country with a small count is a rough signal, not a precise figure.

Per request. One username costs a flat 20 credits however many countries come back, and a username that does not exist fails the task and the credits are returned.