InsightSocial API
TikTok

Videos › Popular

GET
/v1/tiktok/videos/popular

Returns TikTok's Top Videos board for the US, Japan, Vietnam, Thailand or Indonesia over 7 or 30 days: each video's rank, lifetime and window views, organic views, engagement rate and creator.

Use it for the videos TikTok ranks highest in those five markets. Other markets have no board and return a free 400; use hashtags/popular there.

Metered: 520–900 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

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

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

countryCode?string

Market: US, JP, VN, TH or ID, the only markets TikTok publishes this board for. Defaults to US.

Value in

  • "US"
  • "JP"
  • "VN"
  • "TH"
  • "ID"
period?string

Window in days: 7 or 30. Defaults to 7.

Value in

  • "7"
  • "30"
orderBy?string

How TikTok ranks the board: views (the default), engagement, or six_second_views.

Value in

  • "views"
  • "engagement"
  • "six_second_views"
limit?integer

How many videos to return, 1-20, default 20.

Range1 <= value <= 20

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/videos/popular"
{  "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}

Video › Screen Text GET

Returns the text shown on the video itself: native text stickers plus AI OCR of the cover frame, so burned-in editor captions are caught too. Use it for the on-screen overlay text; the caption lives on post and the spoken words on post/transcript. **100 credits** per call. Re-running the exact same call within 6h is free.

Ai Search GET

Returns a written answer to a plain-English question about X (Twitter), the X posts cited as sources, and how many searches the model ran. Use it for open questions such as what an account has said about a topic this week. A thin answer means thin retrieval, not an empty corpus, so confirm coverage with search/tweets. **100 credits** per call. Re-running the exact same call within 1h is free.