# TikTok User Audience API (https://www.socialcrawl.dev/platforms/tiktok/user-audience)

> 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.

TL;DR: `GET /v1/tiktok/user/audience` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | TikTok username without the @ symbol |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tiktok/user/audience?handle=charlidamelio" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How 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.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get TikTok audience demographics with the SocialCrawl API
- What does the SocialCrawl TikTok Audience endpoint return?