TikTok User Audience API
Scrape TikTok User Audience data with one API call. Returns audience geography for a TikTok creator: audienceLocations ranks the top countries in the creator's audience with sampled follower counts and percentage share. The ranking is built from a sample of the creator's public followers (typically a few hundred), not the full follower base, so treat the percentages as a concentration ranking rather than a census. When the creator has a public Shop marketplace card, the same response also carries audienceAges and audienceGenders (percentage share) and audienceStates (sampled US-state counts). Age and gender are absent when no marketplace card exists; the country ranking is still returned.
Last updated October 2026Maintained by the SocialCrawl team
Returns where a creator's followers are: the top countries in their audience, with sampled follower counts and each country's share.
Use it for audience geography only. Age and gender are not available publicly on TikTok or any other platform.
Searching 68 platforms in parallel
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchWhat can you do with the User Audience API?
The User Audience endpoint gives you structured TikTok data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/tiktok/user/audience?handle=charlidamelio"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/tiktok/user/audience",
params={
'handle': 'charlidamelio',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/tiktok/user/audience?handle=charlidamelio",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| handle | Yes | TikTok username without the @ symbol |
What does the TikTok User Audience API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "tiktok",
"endpoint": "/v1/tiktok/user/audience",
"data": {
"audienceLocations": [
{
"country": "Pakistan",
"countryCode": "PK",
"count": 167,
"percentage": "12.87%"
},
{
"country": "United States",
"countryCode": "US",
"count": 124,
"percentage": "9.55%"
}
],
"audienceAges": [
{
"key": "18-24",
"percentage": 50.17
},
{
"key": "25-34",
"percentage": 28.22
}
],
"audienceGenders": [
{
"key": "male",
"percentage": 24.16
},
{
"key": "female",
"percentage": 72.46
}
],
"audienceStates": [
{
"state": "CALIFORNIA",
"count": 103700
},
{
"state": "TEXAS",
"count": 91800
}
]
},
"credits_used": 5,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T15:40:39.979Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the TikTok User Audience API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I get TikTok audience demographics with an API?
What audience fields does the endpoint return?
Which TikTok creators have audience data available?
How fresh is the TikTok audience data?
How much does the TikTok Audience API cost?
Ask AI about SocialCrawl
Ready to scrape TikTok User Audience data?
Get your API key and start pulling TikTok data in under 60 seconds.