TikTok Transcript API Documentation
Quickstart, endpoint reference, errors and credits.
Draft notice
Owner check needed: endpoint, parameter, limit and error names here come from the planning spec, not from the live service. Confirm them against the real API before launch.
Quickstart: your first TikTok transcript
Get a key, send one GET request, read the transcript. Create an API key and fetch a TikTok transcript with one request. Includes the response shape, error handling and next steps. Examples run against a mock.
OpenAuthentication
Bearer token or x-api-key header. How to authenticate with the TikTok transcript API using a bearer API key or an x-api-key header, and how to keep keys safe.
OpenGET /tiktok/transcript
Parameters and response fields. Reference for the TikTok transcript endpoint: query parameters, JSON fields, formats and credits. Names are illustrative and marked to be confirmed.
OpenAsync jobs for speech-to-text
202, job id, polling. How speech-to-text requests return a 202 and a job id, how to poll the job, and when credits are charged. Illustrative contract, run against a mock.
OpenOutput formats
JSON, SRT, VTT, TXT. Output formats of the TikTok transcript API: JSON with timed segments, SRT, VTT and plain text, with examples of each and when to pick which.
OpenLanguages
lang and available_languages. How the lang parameter works for TikTok transcripts, what available_languages tells you, and what happens when a language is missing.
OpenPython guide
requests example. Call the TikTok transcript API from Python with requests: timeouts, typed errors, retries and the saved SRT and VTT files. Runs against a local mock.
OpenJavaScript and Node guide
fetch example. Call the TikTok transcript API from Node.js with fetch: key handling, typed errors and reading the transcript. Runs against a local mock.
OpenRate limits and errors
Codes, retries, limits. Error codes, HTTP statuses and retry rules for the TikTok transcript API, plus the 3 parallel request limit. Names are illustrative, to be confirmed.
OpenCredits and billing
What costs credits. How credits work for the TikTok transcript API: what costs credits, what is free, plan allowances and where to see your balance.
OpenRead the details
Everything you need to fetch a TikTok transcript from code, with every limit written down.
- Start with the quickstart: one request, one transcript.
- The endpoint reference lists parameters and fields.
- Typed errors; failures cost 0 credits.
- Details marked to be confirmed are not yet verified.
Start with the quickstart, then keep the endpoint reference and the error list open. Every example runs against a local mock, and every API detail that the owner has not confirmed is marked to be confirmed.
You need an API key from the dashboard: get an API key or log in. Plans are on the pricing page.