# TikTok Transcript Extractor: Text, Timestamps, SRT, No Login (`transparent_meteorite/tiktok-transcript-extractor`) Actor

Get TikTok transcripts as text: full transcript, timestamped segments, SRT and VTT, language, word count and every caption language, plus views, likes, author and hashtags. Video URLs, short links, IDs or usernames.

- **URL**: https://apify.com/transparent_meteorite/tiktok-transcript-extractor.md
- **Developed by:** [Detroit Web Agent - Open Data](https://apify.com/transparent_meteorite) (community)
- **Categories:** Social media, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.72 / 1,000 transcripts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TikTok Transcript Extractor: Text, Timestamps, SRT, No Login

TikTok transcript extractor that turns TikTok videos into clean text you can search, quote, summarise or feed to an AI model. Paste video links, short links or video IDs, or just type a creator's username, and get one row per video with the full transcript as plain text, timestamped segments, optional SRT and WebVTT subtitle strings, the transcript language, word and character counts, speaking speed and every caption language TikTok lists. Each row also carries the video's essentials: caption, hashtags, views, likes, comments, shares, saves, duration, post date and author.

The transcript text is in the dataset row itself, not behind a download link, so it lands straight in your spreadsheet, database, n8n flow or AI agent. No TikTok account, no cookies to paste, no API key and no speech-to-text bill: the Actor reads the captions TikTok already publishes for the video on its public page.

### Run in 30 seconds

1. Open the **Input** tab. It is prefilled with one creator (`garyvee`) and 10 latest videos.
2. Click **Start**. A run like this takes about 10 to 20 seconds.
3. Open the **Transcripts** view in the Output tab, or export JSON, CSV or Excel.
4. Replace the creator with your own video links, short links, video IDs or usernames and run again.

### What does this Actor do?

- **Video links, short links, IDs:** `https://www.tiktok.com/@user/video/7591981806514162974`, `https://vm.tiktok.com/...`, `https://vt.tiktok.com/...`, `https://www.tiktok.com/t/...` or a bare `7591981806514162974`. Duplicates are removed.
- **Creators:** a username or profile link returns the transcripts of that creator's latest public videos (TikTok's public creator view lists about the newest 10 to 13). Mix creators and video links in one run.
- **Transcript text:** the full transcript as one clean string (`transcript`), with caption formatting tags removed and repeated lines merged.
- **Timestamps:** `segments` gives every caption line with `start` and `end` in seconds, ready for clipping, chaptering or quote search.
- **Subtitle files:** optional `srt` and `vtt` strings you can save as `.srt` / `.vtt` files or upload to an editor.
- **Languages:** the original spoken language by default, your preferred languages in order (for example `en`, `es`), or every caption language TikTok lists for the video.
- **Text metrics:** `wordCount`, `characterCount`, `segmentCount`, `speechSeconds`, `speechCoveragePct` and `wordsPerMinute`.
- **Video essentials:** caption, hashtags, mentions, TikTok's own topic labels and related searches, views, likes, comments, shares, saves, reposts, engagement rate, duration, post date (unix and ISO 8601), author name, followers and verified flag, sound, cover, and the original caption file links.
- **Honest status rows:** a video with no speech, a removed video, an unknown account or a bad input line each get a free status row that says what happened. Nothing is guessed and nothing is charged for them.

### Why use it

| | This Actor | Typical transcript tools |
|---|---|---|
| Transcript text in the row | Yes, plain text + segments | Often only a link to a file you must download |
| Timestamps | Start and end per line, in seconds | Often none |
| SRT and WebVTT | Both, optional | Usually one or none |
| Input | Video URLs, short links, IDs **and** usernames | Usually video URLs only |
| Languages | Original, preferred list, or all | Usually one |
| Word count, speaking speed, coverage | Yes | No |
| Views, likes, author, hashtags in the same row | Yes | Partly |
| Videos without speech | Free status row | Often charged anyway |
| Price per transcript (Free plan) | $0.00095 | Higher, plus per-minute fees for speech-to-text |

#### Head-to-head test (measured 2026-11-20)

Same input for every tool: the same 5 public talking videos (Huberman Lab, GaryVee, MrBeast, Gordon Ramsay). Tools A, B and C are the three most-used TikTok transcript actors in the Apify Store.
| | This Actor | Tool A | Tool B | Tool C |
|---|---|---|---|---|
| Transcript text in the row | **5 of 5** | 0 of 5 (a link to a caption file) | 5 of 5 | 5 of 5 |
| Timestamped lines | **5 of 5** | 0 of 5 | 5 of 5 | 5 of 5 |
| Views, likes and author in the same row | **Yes** | Yes | No | Yes |
| Filled fields per row | **54** | 26 | 7 | 42 |
| Run time for 5 videos | 8.1 s | 16.8 s | 5.5 s | 3.4 s |

Results vary with what TikTok serves on the day. Run time includes the Actor start.

### Input

| Field | What it does |
|---|---|
| `videoUrls` | TikTok video links, short links (vm., vt., /t/) or video IDs, one per line. |
| `profiles` | Usernames (with or without @) or profile links. Each returns its latest videos. |
| `maxVideosPerProfile` | How many of each creator's newest videos to read (default 10). |
| `oldestPostDate` | Skip videos older than a date (`2026-10-01`) or a period (`30 days`). Skipped videos are not charged. |
| `languages` | Preferred transcript languages in order, for example `en`, `es`. The first one the video has becomes `transcript`. |
| `allLanguages` | Also download every other caption language the video lists. Same price per video. |
| `includeSegments` | Timestamped lines (on by default). |
| `includeSrt`, `includeVtt` | Add SRT and WebVTT subtitle strings. |
| `includeNoCaptionRows` | Keep free status rows for videos without captions (on by default). |
| `maxItems` | Stop after this many charged transcripts. |
| `proxyConfiguration` | Apify Proxy is on by default. Leave it as is. |

### Example input

A list of videos with SRT subtitles:

```json
{
  "videoUrls": [
    "https://www.tiktok.com/@hubermanlab/video/7591981806514162974",
    "https://vm.tiktok.com/ZMexample/",
    "7114641064446676267"
  ],
  "includeSrt": true
}
```

The latest videos of several creators, Spanish first when available, only the last 30 days:

```json
{
  "profiles": ["hubermanlab", "@garyvee", "https://www.tiktok.com/@mrbeast"],
  "maxVideosPerProfile": 10,
  "languages": ["es", "en"],
  "oldestPostDate": "30 days"
}
```

### Output

One row per video. Rows with `status` = `ok` hold a transcript and are the only charged rows. Other statuses: `no_captions` (no speech, music only or captions off), `not_found` (removed, private or unknown account), `failed` (could not be read this time, retry), `no_videos` (account without public videos), `invalid_input` (a line that is not a TikTok link, ID or username).

| Group | Fields |
|---|---|
| Transcript | `transcript`, `transcriptLanguage`, `transcriptLanguageCode`, `transcriptSource`, `transcriptSourceUnabbreviated`, `isAutoGenerated` |
| Timing | `segments` (`start`, `end`, `text`), `speechSeconds`, `speechCoveragePct`, `wordsPerMinute` |
| Subtitles | `srt`, `vtt` |
| Counts | `wordCount`, `characterCount`, `segmentCount` |
| Languages | `availableLanguages`, `transcripts` (one entry per downloaded language with text, counts and segments), `spokenLanguage` |
| Video | `id`, `webVideoUrl`, `submittedVideoUrl`, `text`, `hashtags`, `mentions`, `topicLabels`, `searchKeywords`, `createTime`, `createTimeISO`, `durationSeconds` |
| Engagement | `playCount`, `diggCount`, `commentCount`, `shareCount`, `collectCount`, `repostCount`, `engagementRate` |
| Author | `authorUsername`, `authorNickname`, `authorId`, `authorFollowers`, `authorVerified`, `authorProfileUrl`, `authorMeta` (bio, bio link, bio emails, totals) |
| Media | `videoMeta` (size, cover, `subtitleLinks` to the original caption files), `musicMeta`, `mediaUrls` |
| Flags | `isSlideshow`, `isAd`, `isSponsored`, `isPinned`, `isAiGenerated`, `locationCreated` |
| Run | `status`, `message`, `input`, `scrapedAt` |

### Output sample

A real row from a proof run (long strings shortened with "..."):

```json
{
  "status": "ok",
  "message": null,
  "id": "7591981806514162974",
  "webVideoUrl": "https://www.tiktok.com/@hubermanlab/video/7591981806514162974",
  "submittedVideoUrl": "https://www.tiktok.com/@hubermanlab/video/7591981806514162974",
  "input": "@hubermanlab",
  "transcript": "Never miss twice is an idea that, uh, it's an encouragement, it's a. It's an attitude, right? That you show up and, you know, you've been following a new diet for eight days, and then on the ninth day, you binge eat a pizza, and you're like, well, you know, I wish that hadn't happened, but never miss twice. Let's get back on track tomorrow. Or in my case, you know, I wrote a new article every Mond...",
  "transcriptLanguage": "eng-US",
  "transcriptLanguageCode": "en",
  "transcriptSource": "ASR",
  "transcriptSourceUnabbreviated": "auto-generated (speech recognition)",
  "isAutoGenerated": true,
  "wordCount": 227,
  "characterCount": 1196,
  "segmentCount": 29,
  "speechSeconds": 56.3,
  "speechCoveragePct": 97.1,
  "wordsPerMinute": 235,
  "segments": [
    {
      "start": 0.1,
      "end": 2.76,
      "text": "Never miss twice is an idea that, uh,"
    },
    {
      "start": 3.06,
      "end": 4.3,
      "text": "it's an encouragement, it's a."
    },
    {
      "start": 4.301,
      "end": 5.901,
      "text": "It's an attitude, right?"
    },
    "..."
  ],
  "srt": "1\n00:00:00,100 --> 00:00:02,760\nNever miss twice is an idea that, uh,\n\n2\n00:00:03,060 --> 00:00:04,300\nit's an encouragement, it's a.\n\n3\n00:...",
  "vtt": null,
  "availableLanguages": [
    "en"
  ],
  "transcripts": [
    {
      "language": "eng-US",
      "languageCode": "en",
      "source": "ASR",
      "sourceUnabbreviated": "auto-generated (speech recognition)",
      "isAutoGenerated": true,
      "isOriginal": true,
      "text": "Never miss twice is an idea that, uh, it's an encouragement, it's a. It's an attitude, right? That you show up and, you know, you've been following a new diet f...",
      "wordCount": 227,
      "characterCount": 1196,
      "segmentCount": 29,
      "segments": [
        {
          "start": 0.1,
          "end": 2.76,
          "text": "Never miss twice is an idea that, uh,"
        },
        {
          "start": 3.06,
          "end": 4.3,
          "text": "it's an encouragement, it's a."
        },
        {
          "start": 4.301,
          "end": 5.901,
          "text": "It's an attitude, right?"
        },
        "..."
      ],
      "srt": "1\n00:00:00,100 --> 00:00:02,760\nNever miss twice is an idea that, uh,\n\n2\n00:00:03,060 --> 00:00:04,300\nit's an encouragement, it's a.\n\n3\n00:00:04,301 --> 00:00:..."
    }
  ],
  "spokenLanguage": "en",
  "hasOriginalAudio": false,
  "noCaptionReason": null,
  "text": "What Top Performers Do Differently #jamesclear #atomichabits #habits #topperformer #huberman #hubermanlab #hubermanlabpodcast",
  "textLanguage": "en",
  "hashtags": [
    "jamesclear",
    "atomichabits",
    "habits",
    "..."
  ],
  "mentions": [],
  "topicLabels": [],
  "searchKeywords": [
    "andrew huberman",
    "Huberman Podcast",
    "Podcast",
    "..."
  ],
  "createTime": 1767646033,
  "createTimeISO": "2026-01-05T20:47:13.000Z",
  "durationSeconds": 58,
  "playCount": 146100,
  "diggCount": 5300,
  "commentCount": 82,
  "shareCount": 408,
  "collectCount": 1008,
  "repostCount": 0,
  "engagementRate": 3.96,
  "authorUsername": "hubermanlab",
  "authorNickname": "Andrew Huberman",
  "authorId": "6681031681057506309",
  "authorFollowers": 672600,
  "authorVerified": true,
  "authorProfileUrl": "https://www.tiktok.com/@hubermanlab",
  "authorMeta": {
    "id": "6681031681057506309",
    "name": "hubermanlab",
    "nickName": "Andrew Huberman",
    "profileUrl": "https://www.tiktok.com/@hubermanlab",
    "verified": true,
    "privateAccount": false,
    "signature": "Professor at Stanford School of Medicine & host of the Huberman Lab podcast",
    "bioLink": null,
    "bioEmails": [],
    "bioUrls": [],
    "originalAvatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/67cbb7ce8c71a72f5e5c96fa5f437a1c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=e8464...",
    "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/67cbb7ce8c71a72f5e5c96fa5f437a1c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=e8464...",
    "fans": 672600,
    "following": 40,
    "heart": 1800000,
    "video": 133,
    "digg": 19,
    "friends": 0,
    "secUid": "MS4wLjABAAAAvPaSn_rn0gmYY1c-ypPiMNyWobXjUFm5uod2aGevZojX9SXJ-qR_0yHzSAfzEBnG",
    "accountCreateTime": 1555549088,
    "accountCreateTimeISO": "2019-04-18T00:58:08.000Z",
    "commerceCategory": null,
    "isCommerceUser": null,
    "ttSeller": false,
    "isOrganization": null,
    "language": null
  },
  "videoMeta": {
    "duration": 58,
    "height": 1280,
    "width": 720,
    "definition": "720p",
    "format": "mp4",
    "coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oI1CEX6VrIACODn74UIEcfBTTAEfwBDVpIWVyF~tplv-tiktokx-origin.image?dr=9636&x-expires=1795305600&x-...",
    "originalCoverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oI1CEX6VrIACODn74UIEcfBTTAEfwBDVpIWVyF~tplv-tiktokx-origin.image?dr=9636&x-expires=1795305600&x-...",
    "subtitleLinks": [
      {
        "language": "eng-US",
        "languageCode": "en",
        "source": "ASR",
        "sourceUnabbreviated": "auto-generated (speech recognition)",
        "isAutoGenerated": true,
        "isOriginal": true,
        "version": "1:big_caption",
        "downloadLink": "https://v16m-webapp.tiktokcdn-us.com/85964383651823536f2b9a9445e074cc/6b0233a8/video/tos/useast8/tos-useast8-v-0068-tx2/4a182e2994e745b2832a6106f1324a60/?a=1988...",
        "expiresAt": "2026-11-22T00:13:28.000Z"
      }
    ],
    "subtitleLanguages": [
      "eng-US"
    ]
  },
  "musicMeta": {
    "musicId": "7591981847203695391",
    "musicName": "original sound - Andrew Huberman",
    "musicAuthor": "Andrew Huberman",
    "musicOriginal": true,
    "playUrl": "https://v16m.tiktokcdn-us.com/daeb185f5f828b825219ab497e08a882/6affe508/video/tos/useast8/tos-useast8-v-27dcd7-tx2/osaVIOl3VIUClwMbVA1iVRtwBv4RpNiclU2Aj/?a=1233...",
    "coverMediumUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/67cbb7ce8c71a72f5e5c96fa5f437a1c~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=12e7458...",
    "musicAlbum": null
  },
  "mediaUrls": [],
  "isSlideshow": false,
  "isAd": false,
  "isSponsored": false,
  "isPinned": false,
  "isAiGenerated": false,
  "locationCreated": "US",
  "scrapedAt": "2026-11-20T00:12:30.505Z"
}
```

### Use cases

- **AI and LLM pipelines:** send `transcript` to a summariser, classifier or embedding model; the text is already clean, so no audio processing step is needed.
- **Content repurposing:** turn a creator's TikToks into blog posts, newsletters, threads or YouTube descriptions, with `srt` for re-captioning.
- **Brand and keyword monitoring:** search what creators actually say, not just their captions, and alert on product or competitor mentions.
- **Hook research:** read the first `segments` of top-performing videos (sort by `playCount`) to study opening lines and pacing (`wordsPerMinute`).
- **Influencer vetting:** check what a creator talks about across their latest videos before a sponsorship, together with views, engagement rate and followers.
- **Accessibility and translation:** export SRT or WebVTT, or collect every caption language TikTok offers.
- **Academic and market research:** build a text corpus of public TikTok speech with dates, languages and engagement for analysis.

### Limits

- The Actor returns the captions TikTok itself publishes for a video. Videos with no speech, music-only clips, photo slideshows and videos whose captions are off have no transcript; they get a free `no_captions` row with the video's stats.
- Most captions on TikTok are auto-generated speech recognition (`transcriptSource` = `ASR`), so names and slang can be misheard, as on TikTok itself.
- Logged-out TikTok usually lists one caption language per video (the spoken one). `allLanguages` returns every language that is listed publicly; it cannot create a translation that TikTok does not offer.
- A creator input reads the latest videos TikTok's public creator view lists (about 10 to 13). For older videos, paste their links.
- Private, removed and age-restricted videos are reported as `not_found`; nothing behind a login is read.
- The `subtitleLinks` URLs expire after a while (see `expiresAt`); the transcript text in the row does not.
- When a run reaches its time limit it stops cleanly, keeps every row saved and lists unread inputs in `notChecked` in the `OUTPUT` record.

### Pricing and cost control

Pay per transcript. One charged event per video whose transcript is delivered, whatever the number of languages, segments, SRT or VTT you ask for.

| Plan | Price per transcript | Per 1,000 transcripts |
|---|---|---|
| Free | $0.00095 | $0.95 |
| Bronze | $0.00088 | $0.88 |
| Silver | $0.0008 | $0.80 |
| Gold | $0.00072 | $0.72 |
| Platinum | $0.00072 | $0.72 |
| Diamond | $0.00072 | $0.72 |

Plus a start fee of $0.002 per run. No per-minute fees. Not charged: videos without captions, removed or unreadable videos, unknown accounts, invalid input lines and videos skipped by your date filter.

Example: 1,000 talking videos cost $0.95 on the Free plan, plus the $0.002 start fee per run. Set **Maximum cost per run** in the run options, or `maxItems` in the input, and the Actor stops cleanly at the limit.

### Alternatives to this Actor

- **Copying captions by hand:** TikTok shows captions in its app, but there is no export, no timestamps and no way to do it for hundreds of videos.
- **Downloading videos and running speech-to-text yourself:** works for any video, but you pay for the audio processing per minute, need storage for the video files and wait much longer. This Actor uses the captions TikTok already made, so a transcript costs a flat fraction of a cent.
- **Transcript tools that return only file links:** you still have to download, parse and join the caption files. Here the text, segments and subtitle strings are already in the row.
- **General TikTok scrapers:** great for stats, but most do not return transcript text. Use this Actor when the words matter, and the TikTok Profile Scraper below when you only need the numbers.

### Use with the API, n8n, Make, Zapier or AI agents

**API** (one call, returns the rows as JSON):

```bash
curl -X POST "https://api.apify.com/v2/acts/transparent_meteorite~tiktok-transcript-extractor/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"videoUrls":["https://www.tiktok.com/@hubermanlab/video/7591981806514162974"]}'
```

**Python**

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("transparent_meteorite/tiktok-transcript-extractor").call(run_input={"profiles": ["hubermanlab"], "maxVideosPerProfile": 10})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    if row["status"] == "ok":
        print(row["createTimeISO"], row["playCount"], row["wordCount"], row["transcript"][:120])
```

**JavaScript**

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('transparent_meteorite/tiktok-transcript-extractor').call({ videoUrls: ['https://www.tiktok.com/@hubermanlab/video/7591981806514162974'], includeSrt: true });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0].transcript);
```

- **n8n:** add the Apify node, choose "Run an Actor and get dataset items", pick `transparent_meteorite/tiktok-transcript-extractor`, paste the input JSON, then route `status = ok` rows to an AI node (summary, topic, sentiment) and on to Google Sheets, Notion or Slack. Schedule it weekly per creator with `oldestPostDate` = `7 days` for a digest of new videos.
- **Make and Zapier:** use the Apify app's "Run Actor" action with the same input and map `transcript`, `webVideoUrl` and `playCount` to your next step.
- **AI agents (MCP):** connect the Apify MCP server at `https://mcp.apify.com?tools=transparent_meteorite/tiktok-transcript-extractor` to Claude, Cursor or any MCP client, and your agent can fetch TikTok transcripts as a tool.

### Fair use and legal

The Actor reads only what TikTok shows publicly on the web to visitors who are not signed in: the public video page and the caption file it links to. It never logs in, never asks for your cookies and does not read private or friends-only videos. Transcripts are the creators' words: quote and reuse them in line with copyright, fair use and the privacy rules that apply to you. This is an independent tool, not affiliated with TikTok or ByteDance.

New to Apify? [Create a free account](https://console.apify.com/sign-up) and run this Actor in under a minute.

### Related actors

More tools from the same publisher that fit this workflow:

- [TikTok Profile Scraper](https://apify.com/transparent_meteorite/tiktok-public-profile-scraper): profile stats, bio links and recent posts for a creator list
- [TikTok Comments Scraper](https://apify.com/transparent_meteorite/tiktok-comments-scraper): collect comments and replies on videos for sentiment and lead mining
- [YouTube Transcript Extractor](https://apify.com/transparent_meteorite/youtube-transcript-extractor): transcripts as text, SRT or VTT for analysis and repurposing
- [TikTok Scraper](https://apify.com/transparent_meteorite/tiktok-hashtag-search-scraper): discover videos and creators by hashtag, search term or sound
- [TikTok Followers Scraper](https://apify.com/transparent_meteorite/tiktok-followers-scraper): list followers and following of an account

Use from AI agents: every actor here is callable through the Apify MCP server (mcp.apify.com).

### FAQ

**Do I need a TikTok account, cookies or an API key?** No.

**Does it use speech-to-text (AI transcription)?** No. It returns the captions TikTok publishes for the video, which is why it is fast and costs a flat price per video with no per-minute fee. Videos without TikTok captions get a free `no_captions` row.

**Why does a video say `no_captions`?** It has no speech (music, dance, slideshow), the creator turned captions off, or TikTok has not generated captions for it. You are not charged for it. Turn off `includeNoCaptionRows` to hide these rows.

**Can I get a transcript in another language?** Put language codes in `languages` (for example `es`, `en`) or switch on `allLanguages`. You get every caption language TikTok lists publicly for that video. Logged-out TikTok usually lists only the spoken language.

**How accurate is the transcript?** It is the same text TikTok shows as captions. Auto-generated captions (`isAutoGenerated` = true) can mishear names and slang; creator-written captions (`transcriptSource` = `CC`) are exact.

**Can I get all videos of a creator?** A username returns the newest public videos TikTok lists for logged-out visitors (about 10 to 13). For older videos, paste their links or IDs; there is no limit on how many links you send.

**Do short links work?** Yes: `vm.tiktok.com`, `vt.tiktok.com` and `tiktok.com/t/` links are resolved automatically.

**How do I save an SRT file?** Turn on `includeSrt`, then write the `srt` field of each row to `<id>.srt`. The `segments` array has the same timing as JSON.

**What happens if a video is removed?** You get a `not_found` row with the input link. Nothing is charged.

**How fast is it?** About 1 to 2 seconds per video, five videos in parallel.

### Support

Found a video that reads badly or need a field? Open an issue on the Issues tab with the run URL and the video link, and we will reply there.

### Changelog

- **0.2.3**: Caption downloads are hedged: a stalled request no longer holds a video for 15 seconds (5 videos: 31 s to 8 s in our test).
- **0.2**: First release. Video URLs, short links, IDs and usernames; transcript text, timestamped segments, SRT and WebVTT; preferred or all caption languages; word, character and speaking-speed metrics; free status rows for videos without captions.

# Actor input Schema

## `videoUrls` (type: `array`):

TikTok video links (https://www.tiktok.com/@user/video/123...), short links (vm.tiktok.com, vt.tiktok.com, tiktok.com/t/...) or bare video IDs, one per line. Each video gives one row.

## `profiles` (type: `array`):

TikTok usernames (with or without @) or profile URLs. The Actor transcribes each creator's latest public videos (TikTok's public creator embed lists about the newest 10-13).

## `maxVideosPerProfile` (type: `integer`):

How many of each creator's newest videos to transcribe. TikTok's public view lists about 10-13, so that is the practical ceiling.

## `oldestPostDate` (type: `string`):

Optional. A date (2026-10-01) or a period (7 days, 2 weeks, 3 months). Older videos are skipped and not charged.

## `languages` (type: `array`):

Optional language codes in order of preference, for example en, es, pt. The first one TikTok has becomes the main transcript; the others you list are added to `transcripts`. Empty = the video's original spoken language.

## `allLanguages` (type: `boolean`):

Also download every other caption language TikTok lists for the video (translations, when TikTok offers them publicly). Same price per video.

## `includeSegments` (type: `boolean`):

Add `segments`: each caption line with start and end in seconds.

## `includeSrt` (type: `boolean`):

Add the transcript as an SRT subtitle string (`srt`).

## `includeVtt` (type: `boolean`):

Add the transcript as a WebVTT subtitle string (`vtt`).

## `includeNoCaptionRows` (type: `boolean`):

Keep a free status row (with the video's stats) for videos that have no speech or no captions. Off = skip them. They are never charged.

## `maxItems` (type: `integer`):

Stop after this many charged transcripts.

## `proxyConfiguration` (type: `object`):

Apify Proxy (datacenter) is used by default; blocked pages retry on a new session and, if needed, on residential IPs.

## Actor input object example

```json
{
  "profiles": [
    "garyvee"
  ],
  "maxVideosPerProfile": 10,
  "allLanguages": false,
  "includeSegments": true,
  "includeSrt": false,
  "includeVtt": false,
  "includeNoCaptionRows": true,
  "maxItems": 1000,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `transcripts` (type: `string`):

No description

## `stats` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "profiles": [
        "garyvee"
    ],
    "maxVideosPerProfile": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("transparent_meteorite/tiktok-transcript-extractor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "profiles": ["garyvee"],
    "maxVideosPerProfile": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("transparent_meteorite/tiktok-transcript-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "profiles": [
    "garyvee"
  ],
  "maxVideosPerProfile": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call transparent_meteorite/tiktok-transcript-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,transparent_meteorite/tiktok-transcript-extractor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/g2XZhGjbria5aqdTi/builds/7SQOcTBH7ZsEsmNIB/openapi.json
