BlogCore API

TikTok Transcript API: Get the Text From Any TikTok Link

What TikTok's own APIs cover, and one call that returns a timestamped transcript for any public TikTok, captions or not.

On this page6 sections

Clip tools, social listening dashboards, creator analytics and AI note apps all end up needing the words in a TikTok, not the video. Users paste a link, and the app wants text it can search, summarize, translate or turn into a caption. Getting that reliably is harder than it looks, for two reasons:

  • Many TikToks have no caption track. Creators don't always turn captions on, and plenty of videos are music, voiceover or talking with no subtitles at all. A transcript API that only reads captions returns nothing for those.
  • It breaks on the server. Fetching a TikTok from your laptop works. The same request from AWS, Fly, a Vercel function or an agent sandbox often comes back blocked or empty, because TikTok treats datacenter traffic very differently from a phone.

What TikTok's own APIs cover

TikTok has developer APIs, but none of them is a general transcript endpoint for app builders:

  • The Research API can return a video's speech as text, but access is limited to approved non-commercial researchers. A product can't build on it.
  • The Display API (Login Kit) shows a signed-in user's own videos in your app. It doesn't take a link to someone else's video, and it doesn't return a transcript.
  • oEmbed gives you the title, author and a thumbnail to embed a player.

So for a link a user pasted, the usual options are a caption-scraping API, or downloading the video yourself and running speech-to-text on the audio, which means a downloader, audio extraction and a speech-to-text account to keep working.

One call: captions or speech-to-text

Send the TikTok link to Importly with "mode": "auto". If the video has captions, you get them. If it doesn't, speech-to-text runs on the same request. "wait": true returns the finished transcript in the response:

bash
curl -X POST https://api.importly.io/transcribe \
  -H "Authorization: Bearer $IMPORTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@<user>/video/<id>",
    "mode": "auto",
    "wait": true,
    "maxCostDollars": 0.25
  }'

The result has the whole transcript as text, plus timestamped segments you can show next to the video or cut clips from:

json
{
  "text": "...",
  "source": "importly",
  "language": "en",
  "duration": 42,
  "data": {
    "segments": [
      { "start": 0.4, "end": 3.1, "text": "..." }
    ]
  },
  "costInDollars": 0.01
}

source tells you where it came from: platform_captions when the video had captions, importly when speech-to-text ran. The shape is the same either way, so your code doesn't branch. Details are in the transcripts docs.

A few things worth knowing:

  • Short links work. Users paste full /video/ links and short share links from the app; send whichever you get.
  • Private, deleted or login-only videos fail with a clear code, so you can tell the user instead of retrying. Failed transcriptions are refunded.
  • Long videos: if a job is still running when wait runs out, the response has a jobId, and you collect the transcript by polling GET /transcribe/status or with a webhookUrl.
  • Captions only: send "mode": "captions" if you never want to pay for speech-to-text. A video without captions then fails with a price quote instead, and nothing is charged.

Transcript and video together

If your app also keeps the video, for clipping or re-posting, use one import instead of two calls:

bash
curl https://api.importly.io/import \
  -H "Authorization: Bearer $IMPORTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@<user>/video/<id>",
    "includeTranscript": true,
    "transcriptProvider": "importly",
    "webhookUrl": "https://example.com/webhooks/import"
  }'

You get the MP4 and the transcript in one job. See the TikTok video download API post for the file side.

What it costs

  • From captions: $0.003 per video.
  • Speech-to-text: $0.01 per minute of audio, fetching included, with a $0.01 minimum. Most TikToks are under a minute, so that's usually $0.01 a video, and a three-minute one is $0.03.
  • maxCostDollars caps what a request may cost, so an unexpectedly long video fails instead of running over.

It's free to try, no card required. See pricing.

Have your AI agent build it in

Connect https://mcp.importly.io/mcp to Claude Code, Cursor or another coding agent and ask it to add TikTok transcripts to your app. It gets working code for your stack, writes the integration and tests real calls with your API key, and your backend uses the same key. The steps are in Have your agent build Importly into your app.

FAQ

Does TikTok have an API for transcripts?

Only the Research API returns speech as text, and it's limited to approved non-commercial researchers. The Display API and oEmbed don't return transcripts.

How do I get a transcript of a TikTok with no captions?

Run speech-to-text on its audio. With Importly, "mode": "auto" does that automatically when there are no captions, at $0.01 a minute.

Can I get TikTok transcripts in other languages?

Yes. Pass a language code such as es. For captions it picks that caption track; for speech-to-text it tells the engine which language to expect. Without it, built-in speech-to-text assumes English, so set it for non-English videos.

Why does my TikTok transcript script work locally but fail on my server?

TikTok blocks or limits a lot of datacenter traffic, so requests from cloud servers and sandboxes fail where your home connection works. Importly works the same from a server as from your laptop.

Related: TikTok video download API, Best YouTube transcript API, Podcast transcription API.

Keep reading

Put video and audio links to work in your app

One API for files, transcripts and metadata. Free to try, no card required.

Try free →