TikTok

Get TikTok video transcript

Get the spoken transcript for a TikTok video by URL — Get TikTok video transcript.

GET/v1/tiktok/videos/transcript
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
url*stringquery

Link to the TikTok video whose transcript should be returned.

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

languagestringoptionalquery

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

min 2 chars · max 2 chars

useAiFallbackbooleanoptional+10 creditsquery

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

Response fields
13

Endpoint-specific response payload.

datalookupStatus
string

Whether the transcript lookup resolved to a TikTok video.

one of: found, not_found

Video identity when the lookup resolved.

datavideoid
string

TikTok video id.

min 1 chars

datavideourl
string

Canonical public TikTok URL for the video.

min 1 chars

Transcript content when one is available for the resolved video.

datatranscriptformat
string

Transcript format.

one of: webvtt

datatranscriptcontent
string

Raw transcript text.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/tiktok/videos/transcript?url=https://www.tiktok.com/@mrbeast/video/7596844935442189598" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Transcript lookup result.