InsightSocial
GET /v1/tiktok/post/transcript

TikTok Video Transcript API

Returns the spoken text of a TikTok video from its captions, with an option to fall back to AI transcription when no captions exist.

100 credits a call · single call · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/tiktok/post/transcript?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7499229683859426602" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "tiktok",
"endpoint": "/v1/tiktok/post/transcript",
"schema_version": "2",
"data": {
"transcript": {
"language": "<string | null>",
"text": "<string | null>",
"segments": "<array | null>"
}
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it when you need what was said rather than the numbers; post gives you the video's caption and metrics but no transcript.

Parameters

Query parameters for GET /v1/tiktok/post/transcript. Send your key in the x-api-key header.

NameRequiredDescription
urlYesFull URL of the TikTok video
languageNoLanguage of the transcript. 2 letter language code, ie 'en', 'es', 'fr', 'de', 'it', 'ja', 'ko', 'zh'. Selects the caption track, and is passed to AI transcription of a longer video as the spoken language. Without it, AI transcription detects the language itself and can mistake a less common one for English, so set it when you know the language. If AI transcription of a longer video cannot transcribe the language you set, the request returns 404 RESOURCE_NOT_FOUND with error.details.reason: language_unsupported rather than a transcript in another language; retrying returns the same result.
use_ai_as_fallbackNoSet to 'true' to fall back to AI transcription when the video has no captions. AI transcription covers videos up to 10 minutes (600 seconds): a longer video with no captions returns 400 INVALID_REQUEST with error.details.reason: video_too_long, duration_seconds and max_seconds, free and deterministic, so retrying returns the same answer.
max_age_sNoThe oldest cached copy you accept, in seconds. A copy that old or younger is served, with its age in age_s and the X-Cache-Age header. Without it a copy up to 2592000 seconds old is served. A lower value fetches fresh (billed) when the copy is older, and 0 always fetches live, like Cache-Control: no-cache.

Response fields

The same unified schema every typed endpoint returns, so code written for TikTok reads the other platforms too. A field the platform did not provide is null and listed in unavailable.

FieldTypeNotes
languagestring | nullThe content's language as the platform states it, e.g. en, pt-BR. Detected languages come later (§7.1).
textstring | null
segmentsarray | null

Every field, error and example is in the TikTok Video Transcript API reference.

How much does the TikTok Video Transcript API cost?

100 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

TikTok Video Transcript API: frequently asked questions

Send GET /v1/tiktok/post/transcript with the url parameter and your key in the x-api-key header. Returns the spoken text of a TikTok video from its captions, with an option to fall back to AI transcription when no captions exist.