Social Fetch
TikTok

Get TikTok video transcript

Returns transcript text for a TikTok video when one is available.

Operation

GET/v1/tiktok/videos/transcript

Pricing

Base
1 credit
useAiFallback = trueAI transcript fallback
+10 credits

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Link to the TikTok video whose transcript should be returned.

min 1 chars · max 4096 chars · pattern: ^https:\/\/

languagestring(query)

Optional two-letter language code to request a transcript in a specific language when available.

min 2 chars · max 2 chars

useAiFallbackboolean+10 credits(query)

When true, uses SocialFetch's AI fallback when a transcript is not otherwise available. Adds 10 credits on completed lookups (11 total with the base lookup).

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the transcript lookup resolved to a TikTok video.

one of: found, not_found

datavideo
objectrequirednullable

Video identity when the lookup resolved.

datavideoid
stringrequired

TikTok video id.

min 1 chars

datavideourl
stringrequired

Canonical public TikTok URL for the video.

min 1 chars

datatranscript
objectrequirednullable

Transcript content when one is available for the resolved video.

datatranscriptformat
stringrequired

Transcript format.

one of: webvtt

datatranscriptcontent
stringrequired

Raw transcript text.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Transcript lookup result.

Error codes

insufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page