# TikTok Post Transcript API (https://www.socialcrawl.dev/platforms/tiktok/post-transcript)

> Returns the transcript of a TikTok video. Supports auto-generated captions and AI-powered transcription as fallback. `transcript` is one string in one of two forms, and `transcript_format` names it: `webvtt` (WebVTT cues with timestamps) when it comes from the video's caption track or from AI transcription of a longer video, `text` (plain text, with `duration_seconds` and `duration_minutes`) when it comes from AI transcription of a shorter one. Read `transcript_format` rather than guessing from the video's length. A video over 2 minutes is transcribed on demand and can take a minute or more, so allow up to 300 seconds before your HTTP client times out.

TL;DR: `GET /v1/tiktok/post/transcript` costs 10 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the TikTok video |
| `language` | no | Language 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` at 0 credits rather than a transcript in another language; retrying returns the same result. |
| `use_ai_as_fallback` | no | Set to 'true' to fall back to AI transcription when the video has no captions. Included in the endpoint's 10 credits (no surcharge). 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. |
| `moments` | no | Optional CSV of moment kinds to find: brand, sponsor_read, product_demo, call_to_action. Returns data.moments = [{ kind, start_ms, end_ms, quote }] when the transcript has timestamps. Price of the extra step is an owner decision; today it does not add credits. |
| `brand` | no | Optional, with moments=. The company or product to look for, so a namesake is not counted. |
| `q` | no | Optional question about the video, up to 300 characters, for example q=what discount code do they give. Returns data.moments = [{ kind: "answers_query", start_ms, end_ms, quote }] for each stretch of about six transcript lines that states the answer: a stretch that only shares the topic is left out, and a question the video never answers returns an empty list. The quote is one line copied from the transcript and the times come from the segments. Send moments= or q=, not both. If the step cannot run, the transcript is returned without data.moments and data._warnings carries moments_unavailable. Today it does not add credits. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/tiktok/post/transcript" \
  --data-urlencode "url=https://www.tiktok.com/@stoolpresidente/video/7499229683859426602" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a TikTok video transcript with an API?

Send a GET request to /v1/tiktok/post/transcript with the url parameter set to the full TikTok video URL. SocialCrawl returns the video's transcript, using TikTok's auto-generated captions where available.

### Which languages does the TikTok Transcript API support?

Pass language with a 2-letter code: en (English), ko (Korean), es (Spanish), fr (French), de (German), it (Italian), ja (Japanese), or zh (Chinese). Support depends on TikTok's auto-caption coverage for each video.

### What if the TikTok video has no native transcript?

Pass use_ai_as_fallback=true and the endpoint runs AI transcription when TikTok's native captions are missing. This costs 10 credits and only works on videos under 2 minutes long.

### Can I pull a TikTok transcript without a second API call?

Yes. The /v1/tiktok/post endpoint accepts get_transcript=true, which includes the transcript directly in the video details response and skips the transcript endpoint entirely.

### How much does the TikTok Transcript API cost?

Each request costs 10 credits on the premium tier because transcripts are a premium data category. New accounts get 100 free credits with no credit card required, around 10 transcripts free.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get a TikTok video transcript with the SocialCrawl API
- Does the SocialCrawl TikTok Transcript API support Korean?