InsightSocial APIProfile › Full
Returns a TikTok profile plus its latest 10 videos and computed stats: engagement rate by views and by followers, posting cadence, the top post, and the mix of formats.
Use it instead of profile when you want the account, its recent posts, and the engagement maths in one call rather than three.
100 credits per call.
Re-running the exact same call within 6h is free.
Paginates by cursor — see Pagination.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
TikTok username or handle, with or without a leading @. One of the identity params is required. Provide at least one of: handle, user_id.
Numeric TikTok user id. Use it instead of the handle when you already have the stable id, which survives a rename. One of the identity params is required. Provide at least one of: handle, user_id.
How many of the fetched recent posts to return and compute the metrics over (1-100, default 25). One call reads one page, which on TikTok is 10 videos, so a larger value returns that page and a _warnings note; pass posts_cursor back as cursor for the next page.
Pass a prior response's posts_cursor to read the next page of posts.
CSV subset of posts,computed (default both). include=computed omits the raw posts[] array from the response to save payload. The metrics are computed from the same fetched posts either way, so they do not change.
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/profile/full"{ "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}Post GET
Returns one TikTok video in full: caption, engagement counts, author, sound, video metadata, and any on-screen text the creator typed with TikTok's text tool (post.ext.on_screen_texts). Use it when you already have a video URL and want that single video's numbers, rather than a list from profile/videos or search. **20 credits** per call. Re-running the exact same call within 6h is free.
Profile › Playlists GET
Returns the playlists a TikTok creator has published on their profile, each with its playlist id, its name, and the number of videos it holds. Use it to find a playlist id before calling playlist/videos. TikTok does not publish a view total for a playlist, so engagement stays null on every row. **20 credits** per call. Re-running the exact same call within 24h is free.