InsightSocial API
TikTok

Trending

GET
/v1/tiktok/trending

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.

Use it with feed=local for videos mostly from one country (57% measured). The default feed is largely worldwide whatever region you pass, so filter on post.ext.region.

100 credits per call.

Re-running the exact same call within 1h is free.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

region*string

ISO 3166-1 alpha-2 country code (e.g., US, GB, DE). On the default feed it sets the country the request is routed through and does not filter videos; with feed=local it sets the country the For You feed is built for. Either way, check ext.region on each row for the country a video is actually from.

trim?boolean

Accepted for compatibility; it has no effect with feed=local.

feed?string

global (default): the web trending feed routed through region, mostly worldwide content, about 13 videos in 3 to 12 seconds.

Value in

  • "global"
  • "local"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tiktok/trending?region=string"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Song GET

Returns one TikTok sound's details: title, artist, duration, how many videos use it, and its cover image. Use it when you have a sound's clipId and want the sound itself; song/videos returns the videos made with it. **20 credits** per call. Re-running the exact same call within 6h is free.

User › Audience GET

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. **100 credits** per call. Re-running the exact same call within 24h is free.