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.

10 credits per call.

get/v1/tiktok/post

Request

Base URL: https://api.insightsocial.app
URL: https://api.insightsocial.app/v1/tiktok/post
Auth: API key in header x-api-key

Query parameters

urlstring required

Example:https://www.tiktok.com/@mrbeast/video/7654638524729216287

Full URL of the TikTok video

regionstring

Two-letter country code (US, GB, FR, PH). Used only to retry a region-locked video, commonly one from the Philippines, as seen from that country.

trimboolean

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

download_mediaboolean

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.

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.

Response

Success.

successtrue required

platformstring required

endpointstring required

schema_version'2' required

unavailablestring[] required

credits_usedinteger required

credits_remaininginteger required

request_idstring required

cachedboolean required

idempotent_replayboolean required

charge_reasonstring required

free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.