Insight Social
GET /v1/tiktok/user/audiencebeta

TikTok User Audience API

Returns where a creator's followers are: the top countries in their audience, with sampled follower counts and each country's share.

50 credits a call · single call · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/tiktok/user/audience?handle=charlidamelio" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "tiktok",
"endpoint": "/v1/tiktok/user/audience",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it for audience geography only. Age and gender are not available publicly on TikTok or any other platform.

Parameters

Query parameters for GET /v1/tiktok/user/audience. Send your key in the x-api-key header.

NameRequiredDescription
handleYesTikTok username without the @ symbol

Response

This endpoint returns the platform's own fields in data, in snake_case, rather than a unified post or profile. The reference page lists them.

Every field, error and example is in the TikTok User Audience API reference.

How much does the TikTok User Audience API cost?

50 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

TikTok User Audience API: frequently asked questions

Send GET /v1/tiktok/user/audience with the handle parameter and your key in the x-api-key header. Returns where a creator's followers are: the top countries in their audience, with sampled follower counts and each country's share.