Social Fetch
TikTok

Get TikTok video transcript

Get the spoken transcript for a TikTok video.

GET/v1/tiktok/videos/transcript

Pricing

Base
1 credit
useAiFallback = trueAI transcript fallback
+10 credits
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
12

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

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.

On this page

No Headings