100 free credits. No credit card required
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. Age and gender are not included: platforms do not expose those publicly.
Last updated August 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 51 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·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·Utility·
Universal Search
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·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·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·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
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·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·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·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
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·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·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·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
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·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok API
What 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 |
Example Response
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": "Mexico",
"countryCode": "MX",
"count": 127,
"percentage": "28.22%"
},
{
"country": "Brazil",
"countryCode": "BR",
"count": 40,
"percentage": "8.89%"
},
{
"country": "Philippines",
"countryCode": "PH",
"count": 36,
"percentage": "8.00%"
},
{
"country": "United States",
"countryCode": "US",
"count": 33,
"percentage": "7.33%"
},
{
"country": "Colombia",
"countryCode": "CO",
"count": 20,
"percentage": "4.44%"
},
{
"country": "Argentina",
"countryCode": "AR",
"count": 16,
"percentage": "3.56%"
},
{
"country": "Peru",
"countryCode": "PE",
"count": 14,
"percentage": "3.11%"
},
{
"country": "Venezuela",
"countryCode": "VE",
"count": 12,
"percentage": "2.67%"
},
{
"country": "Ecuador",
"countryCode": "EC",
"count": 10,
"percentage": "2.22%"
},
{
"country": "United Kingdom",
"countryCode": "GB",
"count": 8,
"percentage": "1.78%"
},
{
"country": "Dominican Republic",
"countryCode": "DO",
"count": 7,
"percentage": "1.56%"
},
{
"country": "Iraq",
"countryCode": "IQ",
"count": 7,
"percentage": "1.56%"
},
{
"country": "Chile",
"countryCode": "CL",
"count": 6,
"percentage": "1.33%"
},
{
"country": "Bolivia",
"countryCode": "BO",
"count": 6,
"percentage": "1.33%"
},
{
"country": "Costa Rica",
"countryCode": "CR",
"count": 5,
"percentage": "1.11%"
},
{
"country": "Guatemala",
"countryCode": "GT",
"count": 5,
"percentage": "1.11%"
},
{
"country": "Egypt",
"countryCode": "EG",
"count": 5,
"percentage": "1.11%"
},
{
"country": "Pakistan",
"countryCode": "PK",
"count": 5,
"percentage": "1.11%"
},
{
"country": "Honduras",
"countryCode": "HN",
"count": 5,
"percentage": "1.11%"
},
{
"country": "Germany",
"countryCode": "DE",
"count": 5,
"percentage": "1.11%"
},
{
"country": "Italy",
"countryCode": "IT",
"count": 4,
"percentage": "0.89%"
},
{
"country": "Saudi Arabia",
"countryCode": "SA",
"count": 4,
"percentage": "0.89%"
},
{
"country": "France",
"countryCode": "FR",
"count": 4,
"percentage": "0.89%"
},
{
"country": "Turkey",
"countryCode": "TR",
"count": 4,
"percentage": "0.89%"
},
{
"country": "Israel",
"countryCode": "IL",
"count": 3,
"percentage": "0.67%"
},
{
"country": "China",
"countryCode": "CN",
"count": 3,
"percentage": "0.67%"
},
{
"country": "Canada",
"countryCode": "CA",
"count": 3,
"percentage": "0.67%"
},
{
"country": "South Africa",
"countryCode": "ZA",
"count": 3,
"percentage": "0.67%"
},
{
"country": "El Salvador",
"countryCode": "SV",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Bangladesh",
"countryCode": "BD",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Australia",
"countryCode": "AU",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Azerbaijan",
"countryCode": "AZ",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Nigeria",
"countryCode": "NG",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Spain",
"countryCode": "ES",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Poland",
"countryCode": "PL",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Ivory Coast",
"countryCode": "CI",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Uganda",
"countryCode": "UG",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Morocco",
"countryCode": "MA",
"count": 2,
"percentage": "0.44%"
},
{
"country": "Democratic Republic of the Congo",
"countryCode": "CD",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Panama",
"countryCode": "PA",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Algeria",
"countryCode": "DZ",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Norway",
"countryCode": "NO",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Uruguay",
"countryCode": "UY",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Oman",
"countryCode": "OM",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Afghanistan",
"countryCode": "AF",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Jamaica",
"countryCode": "JM",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Lebanon",
"countryCode": "LB",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Belarus",
"countryCode": "BY",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Benin",
"countryCode": "BJ",
"count": 1,
"percentage": "0.22%"
},
{
"country": "United Arab Emirates",
"countryCode": "AE",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Congo",
"countryCode": "CG",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Portugal",
"countryCode": "PT",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Kenya",
"countryCode": "KE",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Kazakhstan",
"countryCode": "KZ",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Netherlands",
"countryCode": "NL",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Paraguay",
"countryCode": "PY",
"count": 1,
"percentage": "0.22%"
},
{
"country": "New Zealand",
"countryCode": "NZ",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Mali",
"countryCode": "ML",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Belize",
"countryCode": "BZ",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Bosnia and Herzegovina",
"countryCode": "BA",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Ethiopia",
"countryCode": "ET",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Greece",
"countryCode": "GR",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Lithuania",
"countryCode": "LT",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Croatia",
"countryCode": "HR",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Ukraine",
"countryCode": "UA",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Nicaragua",
"countryCode": "NI",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Hungary",
"countryCode": "HU",
"count": 1,
"percentage": "0.22%"
},
{
"country": "Senegal",
"countryCode": "SN",
"count": 1,
"percentage": "0.22%"
}
]
},
"credits_used": 5,
"credits_remaining": 9999,
"request_id": "req-8Kq2ZmR4vT9xLb3P",
"cached": false
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
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
Developer First
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 51 platforms covering 10B+ monthly active users.
One schema, every platform
Query 51 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()[ .JSON ]
{
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}FAQ
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?
Send a GET request to /v1/tiktok/user/audience with the handle parameter (no @ symbol). SocialCrawl returns the creator's audience geography: a ranked audienceLocations list of countries with sampled follower counts and percentage share.
What audience fields does the endpoint return?
The response contains audienceLocations, an array of countries with the country name, ISO country code, sampled follower count, and percentage share. Age and gender are not part of this endpoint. Platforms do not expose those demographics publicly.
Which TikTok creators have audience data available?
Any public TikTok account can be queried. The breakdown is estimated from a sample of roughly 1,000 audience accounts, so very small accounts return coarser splits. Treat the percentages as directional rather than exact.
How fresh is the TikTok audience data?
Each uncached call re-samples the creator's audience live. Responses are cached in the analytics category for 30 minutes, so repeat calls for the same handle stay fast and cost-efficient.
How much does the TikTok Audience API cost?
Each request costs 5 credits on the advanced tier because audience analytics are premium data. New accounts get 100 free credits with no credit card required.
Ask AI about SocialCrawl
Ready to scrape TikTok User Audience data?
Get your API key and start pulling TikTok data in under 60 seconds.