InsightSocial API
TikTok

Post

GET
/v1/tiktok/post

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.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url*string

Full URL of the TikTok video

region?string

Two-letter country code for the proxy region (US, GB, FR, PH). The primary source does not take a region, so it is honoured only when a fallback source serves the request; a region-locked video (commonly from the Philippines) that fails on the primary is retried on the fallback with this value.

trim?boolean

Accepted for compatibility; the response is already the canonical shape, so this flag has no effect.

download_media?boolean

Set to true to also download the video/images and get back durable hosted media URLs under data.post.ext.download_media_urls ([{ post_id, cdn_url, type, cached }]). Use these for archiving; the raw media_urls are short-lived signed CDN links that expire. Adds a few seconds of latency while the media is fetched. Availability is source-dependent and most responses will not carry it: when the serving source cannot host durable copies the field is absent, the response carries a data._warnings note saying so, and data.post.content.media_urls still carries the media.

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/post?url=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}

Post › Transcript GET

Returns the spoken text of a TikTok video from its captions, with an option to fall back to AI transcription when no captions exist. Use it when you need what was said rather than the numbers; post gives you the video's caption and metrics but no transcript. **200 credits** per call. Re-running the exact same call within 6h is free.

Profile › Full GET

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](/docs/pagination).