# TikTok Transcript Extractor (`clockworks/tiktok-transcript-extractor`) Actor Get TikTok transcripts and subtitles from any TikTok video. Download subtitles where available or add AI video-to-text transcription where captions are missing. Results include engagement data, ready for content analysis, trend tracking, AI pipelines, keyword research, and content repurposing. - **URL**: https://apify.com/clockworks/tiktok-transcript-extractor.md - **Developed by:** [Clockworks](https://apify.com/clockworks) (Apify) - **Categories:** Social media, Videos, AI - **Features:** Limited permissions - **Stats:** 1,319 total users, 535 monthly users, 99.7% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.70 / 1,000 videos 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 ### What is TikTok Transcript Extractor? TikTok Transcript Extractor downloads subtitles and generates AI transcriptions from TikTok videos. Give it a list of video URLs, choose how to handle videos that lack built-in subtitles, and it outputs a downloadable subtitle file (.vtt) and plain-text transcription (.txt) for each video. Each result includes: - Subtitle file (.vtt) and/or plain-text transcription (.txt), depending on which mode you select and whether TikTok subtitles are available for the video - Video ID, URL, caption text, detected language, and hashtags, publication metadata - Engagement metrics: views, likes, comments, and shares - Author metadata: username, display name, follower count, and verification status ### TikTok subtitles vs. transcripts: what's the difference? TikTok auto-generates subtitles (also called captions) for most videos using automatic speech recognition (ASR), but not all videos have them. A **transcript** is a plain-text version of a video's spoken content, generated by the Actor's built-in AI speech-to-text engine. Unlike subtitles, transcripts aren't segmented by timestamp. They're a continuous block of text, useful for feeding into LLMs, search indexing, or content repurposing. TikTok Transcript Extractor offers three modes: - **`DOWNLOAD_SUBTITLES`**: fetches TikTok's built-in subtitles only. Videos without subtitles return no text. Downloading existing subtitles comes with no extra cost on top of scraping the videos. - **`DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES`**: uses TikTok's subtitles where they exist and runs AI speech-to-text on the rest. Recommended for most use cases. - **`TRANSCRIBE_ALL_VIDEOS`**: runs AI speech-to-text on every video regardless of built-in subtitle availability. Useful when you need consistent output format or when TikTok's subtitles are inaccurate. > AI transcription modes take longer than subtitle-only runs, as each video's audio is processed through speech-to-text after scraping. ### What can you use TikTok transcripts for? 📈 **Trend and content performance analysis:** Transcripts come paired with views, likes, comments, and shares, so you can [analyze which keywords, hooks, and topics drive engagement](https://blog.apify.com/analyze-tiktok-viral-content-with-transcripts/). 🕵️ **Competitor tracking:** Monitor what creators in your niche are saying [at scale](https://apify.com/use-cases/tiktok-trend-analysis). **♻️ Content repurposing:** Turn TikTok videos into blog posts, newsletters, or social media copy without watching each video. **🖋 Content creation and script writing:** Scrape popular videos in your niche, feed the transcripts to an AI for [creative intelligence](https://apify.com/use-cases/creative-intelligence), and generate new scripts inspired by what's working. 🔍 **SEO and keyword research:** Extract spoken keywords and topics from high-performing videos to inform your content strategy. **🤖 AI pipelines:** Feed transcripts into LLMs for summarization, classification, [sentiment analysis](https://apify.com/use-cases/sentiment-analysis), or Q\&A workflows. **📰 Research and media monitoring:** Archive spoken content from public TikTok accounts for [academic](https://blog.apify.com/unl-research-lab-scaled-multi-platform-social-media-research/) and [behavioral research](https://blog.apify.com/tiktok-user-behavior-with-apify/), [journalism](https://blog.apify.com/how-can-the-media-use-web-scraping-and-automation/), or [open-source intelligence (OSINT)](https://blog.apify.com/osint-social-media-scraping/). ### How to get TikTok transcripts 1. [Create](https://console.apify.com/sign-up) a free Apify account using your email. The free plan includes $5 of monthly usage. 2. Open [TikTok Transcript Extractor](https://apify.com/clockworks/tiktok-transcript-extractor). 3. Add one or more TikTok video URLs. 4. Choose your transcription mode. 5. Click **Start** and wait for the run to finish. 6. Download TikTok transcripts and/or subtitles in bulk from the **Storage** tab in Apify Console, or access individual file links in the **Output** tab under `videoMeta.subtitleLinks[].downloadLink` and `videoMeta.transcriptionLink`. Each dataset also includes video metadata and can be exported as JSON, CSV, Excel, XML, or HTML. 7. Optionally connect to other tools via [Apify integrations](https://apify.com/integrations), run programmatically via the [API](https://apify.com/clockworks/tiktok-transcript-extractor/api), use the [Apify MCP server](https://apify.com/mcp) to run this Actor directly from AI assistants like Claude or ChatGPT, or follow a [complete workflow example](https://blog.apify.com/tiktok-trends-for-businesses/). https://www.youtube.com/watch?v=u0CxoMVRAWE ### How much does it cost to use TikTok Transcript Extractor? This Actor uses [pay-per-event pricing](https://help.apify.com/en/articles/10700066-what-is-pay-per-event). You are charged a fee for each video processed depending on your Apify plan. See the [pricing tab](https://apify.com/clockworks/tiktok-transcript-extractor/pricing) for current rates by plan. All Apify accounts include $5 of free monthly usage to get you started. Subtitle download is free of charge and included in the per-video fee. If the AI transcription add-on is enabled, an extra cost applies per started minute of video transcribed. If the `DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES` mode is selected, the Actor only transcribes videos where TikTok's built-in subtitles are unavailable, so you pay the transcription fee only for those videos. For example, scraping 100 videos on the Business plan with ~70% subtitle coverage: - Video fee: 100 videos × $1.70/1,000 = $0.17 - AI transcription: 30 videos × avg. 2 min = 60 started minutes × $0.027/min = $1.62 - Total: ~$1.79 ### Input TikTok Transcript Extractor accepts a list of TikTok video URLs and a mode that controls how it handles subtitles and transcription. See the [Input schema](https://apify.com/clockworks/tiktok-transcript-extractor/input-schema) for the full specification. If you don't have a list of URLs yet, use [TikTok Scraper](https://apify.com/clockworks/tiktok-scraper) first to search videos by keyword, hashtag, or profile username and extract subtitles in the same run. ![TikTok Transcript Extractor input](https://raw.githubusercontent.com/apify-projects/actor-readme-images/refs/heads/master/tiktok_transcript_extractor_input.png) The same input in JSON: ```json { "postURLs": ["https://www.tiktok.com/@apifytech/video/7398101551744552225"], "downloadSubtitlesOptions": "DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES" } ``` | Field | Type | Description | | -------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `postURLs` | array | Required. TikTok video URLs to process. Enter URLs one by one, or copy-paste them in bulk. | | `downloadSubtitlesOptions` | string | Optional. `DOWNLOAD_SUBTITLES` — fetches TikTok's built-in subtitles only. Videos without subtitles return no text. Default option. `DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES` — downloads TikTok subtitles where available, generates AI transcription for videos that don't have them. [Extra cost applies](https://apify.com/clockworks/tiktok-transcript-extractor/pricing) based on your plan. Recommended for most use cases. `TRANSCRIBE_ALL_VIDEOS` — AI transcription for all videos, including those that already have TikTok subtitles. [Extra cost applies](https://apify.com/clockworks/tiktok-transcript-extractor/pricing) based on your plan. | | `videoKvStoreIdOrName` | string | Optional. Custom name for the Apify Storage where subtitle and transcription files are saved. [Key-value stores](https://docs.apify.com/platform/storage/key-value-store) are unnamed by default and deleted at the end of your plan's [data retention period](https://docs.apify.com/platform/storage/usage#data-retention). Naming your storage preserves it until deleted manually. Up to 63 characters; letters, digits, and hyphens only, no spaces (e.g. tiktok-transcripts-2026). | #### What affects subtitle coverage? Not all TikTok videos have built-in subtitles. Coverage across a broad, topic-diverse sample is on average 60–75%, but your actual rate will vary. Several factors affect it: - **Language:** Non-English content typically has lower auto-generated subtitle coverage. - **Video age:** Videos published before November 2023, when TikTok began rolling out auto-captions globally, are unlikely to have subtitles. Fresh content in the first 24–48 hours may also lack them while TikTok processes the video. Most videos that don't receive subtitles within 48 hours of upload won't receive them at all. - **Content type:** Slideshows don't have spoken audio, so they return no subtitles or transcription. Videos with heavy music, minimal speech, or unclear audio are also less likely to be captioned. TikTok often doesn't generate subtitles for reposted content. Note: A portion of videos may return empty transcript files as they don't contain any meaningful speech to transcribe (typically dance, lip-sync, or music-heavy content) ### Output Each result contains a subtitle file (.vtt) or transcription file (.txt) saved in Apify Storage, with direct download links included in the dataset (`videoMeta.subtitleLinks[].downloadLink` and `videoMeta.transcriptionLink`). To download files in bulk, go to the Key-value store inside the Storage tab after the run completes. ![TikTok Transcript Extractor storage](https://raw.githubusercontent.com/apify-projects/actor-readme-images/refs/heads/master/tiktok_transcript_extractor_storage.png) The dataset also includes video metadata and engagement stats: video URL, caption text, publish date, views, likes, comments, shares, author details, and music info. You can export the full dataset as JSON, CSV, Excel, XML, or HTML from the **Output** tab in Apify Console. **Example of output with TikTok subtitles** ```json { "id": "7458054754124549384", "text": "How cute\nDoes anyone else have a staffy that use to be this small??? #staffy", "textLanguage": "en", "webVideoUrl": "https://www.tiktok.com/@albionparkgerringongvet/video/7458054754124549384", "createTimeISO": "2025-01-09T23:01:36.000Z", "playCount": 10800, "diggCount": 252, "commentCount": 44, "shareCount": 62, "authorMeta": { "name": "albionparkgerringongvet", "nickName": "Albion Park Gerringong Vet", "verified": false, "fans": 160 }, "videoMeta": { "subtitleLinks": [ { "language": "eng-US", "source": "ASR", "sourceUnabbreviated": "automatic speech recognition", "downloadLink": "https://api.apify.com/v2/key-value-stores/abc123/records/subtitle-...-7458054754124549384-eng-US.vtt" } ], "transcriptionLink": null } } ``` **Example of output with AI-generated transcript** ```json { "id": "7642374094767279391", "text": "Watch these little fluffballs play, cuddle, and melt hearts instantly", "textLanguage": "en", "webVideoUrl": "https://www.tiktok.com/@shitzupuppies11/video/7642374094767279391", "createTimeISO": "2026-05-21T15:54:51.000Z", "playCount": 10800, "diggCount": 252, "commentCount": 44, "shareCount": 62, "authorMeta": { "name": "shitzupuppies11", "nickName": "Shitzupuppies", "verified": false, "fans": 160 }, "videoMeta": { "subtitleLinks": [], "transcriptionLink": "https://api.apify.com/v2/key-value-stores/abc123/records/transcription-shitzupupp-20260521155451-7642374094767279391.txt" } } ``` Each output item contains the following key fields (see the [Output schema](https://apify.com/clockworks/tiktok-transcript-extractor/output-schema) for the full list): | Field | Type | Description | | ----------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `text` | string | Post description written by the creator, including hashtags. Not related to the video's spoken content. | | `authorMeta` | object | Creator profile data including `name`, `nickName`, `verified`, `fans`, `following`, `heart`, and `video` count. | | Engagement metrics | number | `playCount`, `diggCount`, `commentCount`, `shareCount` | | `videoMeta.subtitleLinks` | array | Subtitle file links. Each entry has `language`, `source` (`ASR` = automatic speech recognition, `MT` = machine translation, `LC` = live captions), `sourceUnabbreviated`, and a `downloadLink` to the .vtt file in the key-value store. Empty array `[]` if no subtitles are available. | | `videoMeta.transcriptionLink` | string | Link to the plain-text AI transcription file in the Key-value store, or `null` if AI transcription was not run or produced no output. | ### Other TikTok Actors Use dedicated scrapers to extract specific TikTok data. - 🎵 [TikTok Scraper](https://apify.com/clockworks/tiktok-scraper): the most comprehensive tool for scraping TikTok videos, hashtags, profiles, search results, comments, and transcripts at scale - 📥 [TikTok Data Extractor](https://apify.com/clockworks/free-tiktok-scraper): [download structured AI-ready datasets](https://blog.apify.com/how-to-scrape-tiktok-tutorial/) in bulk - 🗣 [TikTok Profile Scraper](https://apify.com/clockworks/tiktok-profile-scraper): extract videos, follower counts, and bio data for [creator research](https://blog.apify.com/find-best-tiktok-influencers/) and [audience analysis](https://blog.apify.com/tiktok-user-behavior-with-apify/) - 📹 [TikTok Video Scraper](https://apify.com/clockworks/tiktok-video-scraper): scrape views, likes, captions, and posting date from video URLs for [tracking performance](https://apify.com/use-cases/creative-intelligence) and [creative analysis](https://blog.apify.com/analyze-social-media-videos-for-creative-intelligence/) - \#️⃣ [TikTok Hashtag Scraper](https://apify.com/clockworks/tiktok-hashtag-scraper): pull videos published under a hashtag with engagement stats and creator data - 📊 [TikTok Hashtag Analytics](https://apify.com/clockworks/tiktok-ads-scraper): analyze hashtag performance, reach, and content benchmarks - 💬 [TikTok Comments Scraper](https://apify.com/clockworks/tiktok-comments-scraper): ideal for [sentiment analysis](https://apify.com/use-cases/sentiment-analysis) and audience research - 👥 [TikTok Followers Scraper](https://apify.com/clockworks/tiktok-followers-scraper): extract follower and following lists from any public TikTok account for [influencer evaluation](https://blog.apify.com/find-best-tiktok-influencers/), audience analysis, and [lead generation](https://blog.apify.com/tiktok-lead-generation/) - 🕵️ [TikTok User Search Scraper](https://apify.com/clockworks/tiktok-user-search-scraper): search TikTok users by keyword and extract profile data for [influencer discovery](https://blog.apify.com/find-micro-influencers-on-tiktok/) and competitor research - 🎸 [TikTok Sound Scraper](https://apify.com/clockworks/tiktok-sound-scraper): track viral audio trends and music-driven campaigns by looking for videos using a specific sound - 🧭 [TikTok Explore Scraper](https://apify.com/clockworks/tiktok-explore-scraper): browse TikTok's Explore categories (Gaming, Food, Beauty, and more) to monitor trending content by vertical - 🔍 [TikTok Discover Scraper](https://apify.com/clockworks/tiktok-discover-scraper): enter a hashtag and get related videos, trending subtopics, and tag breadcrumbs for topic-level trend mapping - 🛒 [TikTok Shop Scraper](https://apify.com/clockworks/tiktok-shop-scraper): scrape product listings, prices, sales volume, and seller data from TikTok Shop by keyword ### Your feedback We're always working on improving TikTok Transcript Extractor. If you've found a bug or have a feature request, please create an issue on the [Issues tab](https://apify.com/clockworks/tiktok-transcript-extractor/issues/open). We monitor it actively. ### Error items When the Actor cannot retrieve data for a given video URL (for example if the video has been deleted or set to private), it pushes an **error item** to the dataset instead of silently skipping it. Other videos in the same run are unaffected. You can identify error items by the presence of an `errorCode` field. **Example error item:** ```json { "url": "https://www.tiktok.com/@user/video/7398101551744552225", "error": "Post URL is gone or private", "errorCode": "POST_NOT_FOUND_OR_PRIVATE" } ``` | `errorCode` | Meaning | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `POST_NOT_FOUND_OR_PRIVATE` | The video has been deleted or set to private | | `POST_SENSITIVE` | TikTok has flagged the video as sensitive content and restricted access | | `INVALID_URLS` | One or more input URLs were malformed. Valid format: `https://www.tiktok.com/@username/video/1234567890123456789` | | `INVALID_INPUT` | The Actor configuration is invalid (for example, a required field is missing or settings are incompatible). The entire run is terminated immediately. | ### FAQ #### Can I generate a transcript from any TikTok video? Yes. TikTok Transcript Extractor generates plain-text transcripts from public TikTok video URLs using AI speech-to-text. Select a transcription mode that includes AI, and it outputs a .txt file with the spoken content. #### Can I try TikTok Transcript Extractor for free? Yes. All Apify accounts include $5 of free monthly usage, which resets every month. No credit card is required to [sign up](https://console.apify.com/sign-up). See the [pricing tab](https://apify.com/clockworks/tiktok-transcript-extractor/pricing) to estimate how many transcripts you can get for free. #### How do I download TikTok transcripts in bulk? After the run completes, go to the Storage tab in Apify Console and open the Key-value store linked to the run. All subtitle (.vtt) and transcription (.txt) files are stored there and can be downloaded at once. Individual download links are also available in the output dataset under `videoMeta.subtitleLinks[].downloadLink` and `videoMeta.transcriptionLink`. #### Can I schedule TikTok transcript collection? Yes. Use [schedules](https://docs.apify.com/platform/schedules) to run TikTok Transcript Extractor automatically at any interval: hourly, daily, or on a custom cron expression. #### Is there an official TikTok API for transcripts? TikTok's official API does not expose subtitle or transcript data. TikTok Transcript Extractor accesses the same subtitle data TikTok's own apps use, so no TikTok API key is required. #### Can I use TikTok Transcript Extractor via the API? Yes. The [Apify API](https://apify.com/clockworks/tiktok-transcript-extractor/api) gives you programmatic access to trigger runs, pass input, and retrieve results. You can also connect the [Apify MCP server](https://apify.com/mcp) to run this Actor directly from AI assistants like Claude or ChatGPT. Just describe what you need, for example: "Give me subtitles for the TikTok videos from this list of links." The AI will handle input configuration and return the results. #### Can I integrate TikTok Transcript Extractor with other apps? Yes. TikTok Transcript Extractor connects with [n8n](https://docs.apify.com/platform/integrations/n8n), [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Google Drive](https://docs.apify.com/platform/integrations/drive), and more via [Apify integrations](https://apify.com/integrations). #### Is it legal to scrape TikTok transcripts? TikTok Transcript Extractor accesses only publicly available video content. It does not extract private user data. Your results may contain personal data subject to GDPR in the EU and similar regulations elsewhere. Only scrape data for legitimate purposes. Read more about [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) and [ethical web scraping practices](https://blog.apify.com/what-is-ethical-web-scraping-and-how-do-you-do-it/). # Changelog This Actor's version history is a separate document: https://apify.com/clockworks/tiktok-transcript-extractor/changelog.md # Actor input Schema ## `postURLs` (type: `array`): URLs of TikTok videos to fetch subtitles or transcripts for. You can enter URLs one by one, or upload or link to a text file. ## `downloadSubtitlesOptions` (type: `string`): Choose how to handle subtitles and audio transcription for input videos. Subtitles are provided by TikTok for some videos, and transcription means that this Actor will use speech-to-text AI to generate a video transcript. Transcripts are charged as an extra event according to your plan. ## `videoKvStoreIdOrName` (type: `string`): Name (or ID) of the Key-Value Store where subtitles and transcriptions will be saved. Omit to use the default store. Using a named store bypasses data retention so files are kept until manually deleted.

The name can contain uppercase letters, lowercase letters, digits, or hyphens, no spaces. ## Actor input object example ```json { "postURLs": [ "https://www.tiktok.com/@apifylife/video/7338085038258457889" ], "downloadSubtitlesOptions": "DOWNLOAD_SUBTITLES" } ``` # Actor output Schema ## `dataset` (type: `string`): Dataset containing all scraped data # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "postURLs": [ "https://www.tiktok.com/@apifylife/video/7338085038258457889" ] }; // Run the Actor and wait for it to finish const run = await client.actor("clockworks/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "postURLs": ["https://www.tiktok.com/@apifylife/video/7338085038258457889"] } # Run the Actor and wait for it to finish run = client.actor("clockworks/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 '{ "postURLs": [ "https://www.tiktok.com/@apifylife/video/7338085038258457889" ] }' | apify call clockworks/tiktok-transcript-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,clockworks/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 ` 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/vv5IWl1VaemRlGAiv/builds/QGGHcRJx81ezzWvou/openapi.json