TikTok Video Transcript API

TikTok Video Transcript

Features

• Multi-URL transcript lookupProcess one or more public TikTok video URLs in one task and pass an optional language preference with each lookup.
• Normalized text and provenanceReturn transcript text with language, plaintext or WebVTT format, source URL, record ID, shortcode, and collection time in a consistent structure.
• Available-only recordsEmit a result only when a source returns non-empty transcript text, so the response distinguishes available transcripts without placeholder rows.

Parameters

How to Use

Submit known public TikTok video URLs as an asynchronous task, poll its task ID, then reconcile the normalized transcript records with the requested sources.

1. Prepare one or more resolvable public TikTok video URLs and, when needed, a two-letter language code such as en.
2. POST urls and the optional language to /v1/tiktok/video-transcript, then save the returned task_id.
3. Poll /v1/tasks/{task_id} until the status is succeeded or failed; success can still contain fewer records than submitted URLs.
4. Read data.results.items, match each url to the input set, and follow results.next_cursor while results.has_more is true.

curl -X POST "https://api.socq.ai/v1/tiktok/video-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"],"language":"en"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Best Use Cases

• Searchable spoken-content archives: Index transcript text with source URLs, language, format, shortcodes, and collection time so selected public videos can be searched by spoken terms.
• Keyword and topic analysis: Analyze normalized text across a known video set to locate recurring words, phrases, and themes while retaining the source link for review.
• Accessibility and quotation review: Use available transcript text and format metadata to prepare readable copies or find passages, then verify them against the linked public video.

Pro Tips

• Validate that every target resolves to the intended public TikTok video before submission because the request accepts non-empty URL strings without enforcing the TikTok host or /video/{id} path.
• Canonicalize URLs and remove tracking variants before batching because trimming and deduplication only collapse identical submitted strings.
• When choosing a language, use a two-letter code such as en and route downstream processing by the returned language field rather than assuming the preference was fulfilled.
• Compare returned url values with the submitted list after success so unavailable, private, deleted, restricted, caption-free, or speech-free videos remain visible to your workflow.
• Branch parsing on format, preserve WebVTT cues when present, and use collected_at for lineage because created_at does not contain the video publication time.

Related APIs