InsightSocial API
TikTok

TikTok User Audience API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/tiktok/user/audience?handle=charlidamelio" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Step-by-step: TikTok analytics dashboard

GET
/v1/tiktok/user/audience

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

Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Schema 2.

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

50 credits per call.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

handle*string

TikTok username without the @ symbol

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/tiktok/user/audience?handle=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "property1": null,    "property2": null  }}

Trending GET

Returns a page of popular TikTok videos with caption, view and like counts, author and thumbnail. Every row carries post.ext.region, the country the video is registered to.

User › Followers GET

Returns a page of accounts that follow a TikTok user, each with username, display name, avatar, and its own follower count.