# TikTok Transcript Extractor (`clockworks/tiktok-transcript-extractor`) Actor
- **URL**: https://apify.com/clockworks/tiktok-transcript-extractor.md
- **Developed by:** [Clockworks](https://apify.com/clockworks) (Apify)
- **Categories:** AI, Social media, Videos
- **Stats:** 10 total users, 4 monthly users, 98.6% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## 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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
### What is TikTok Transcripts?
TikTok Transcripts is a focused tool for **extracting subtitles and generating transcriptions from TikTok videos.** Give it a list of video URLs and choose how you want the text:
- **Download subtitles** — fetch TikTok's built-in subtitles (available on videos where TikTok has generated them)
- **Download subtitles + transcribe the rest** — subtitles where available, AI speech-to-text for the remainder
- **Transcribe all videos** — generate AI transcriptions for every video regardless of whether subtitles exist
### How to get TikTok transcripts?
1. [Create](https://console.apify.com/sign-up) a free Apify account using your email.
2. Open [TikTok Transcripts.](https://apify.com/clockworks/tiktok-transcripts-scraper)
3. Add one or more TikTok video URLs.
4. Choose your subtitle/transcription mode.
5. Click "Start" and wait for the results.
6. Download subtitle (.vtt) and transcription (.txt) files from the Key-Value Store, or access the links directly from the dataset.
### Input sample
```json
{
"postURLs": ["https://www.tiktok.com/@apifytech/video/7398101551744552225"],
"downloadSubtitlesOptions": "DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES"
}
````
`downloadSubtitlesOptions` accepts one of three values:
| Value | Behaviour |
| -------------------------------------------------- | --------------------------------------------------------------- |
| `DOWNLOAD_SUBTITLES` | Download TikTok subtitles only (skips videos with no subtitles) |
| `DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES` | Subtitles where available, AI transcription for the rest ($) |
| `TRANSCRIBE_ALL_VIDEOS` | AI transcription for every video ($) |
### Output sample
Each dataset item links to the subtitle/transcription files stored in the Key-Value Store:
```json
{
"id": "7398101551744552225",
"text": "📣 Yes, you can scrape job listings #data in a minute!!",
"webVideoUrl": "https://www.tiktok.com/@apifytech/video/7398101551744552225",
"mediaUrls": [],
"videoMeta": {
"subtitleLinks": [
{
"language": "en",
"source": "ASR",
"downloadLink": "https://api.apify.com/v2/key-value-stores/abc123/records/subtitle-7398101551744552225-en"
}
],
"transcriptionLink": null
}
}
```
Subtitle files are saved in `.vtt` format. AI-generated transcriptions are saved as plain text.
### How can I use TikTok transcriptions?
✨ **Content repurposing** — turn TikTok videos into blog posts, newsletters, or social media copy
🔍 **SEO & keyword research** — extract spoken keywords and topics from high-performing videos
📊 **Sentiment analysis** — process transcripts at scale to understand tone and messaging trends
🧏 **Accessibility** — generate subtitles for videos that TikTok hasn't captioned automatically
🤖 **AI pipelines** — feed transcripts into LLMs for summarisation, classification, or Q\&A
### Integrate TikTok Transcripts and automate your workflow
You can connect TikTok Transcripts with thousands of other apps using our integrations:
- [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 [much more](https://docs.apify.com/platform/integrations).
### Scrape any TikTok data you need with dedicated scrapers
### Your feedback
We're always working on improving the performance of our Actors. If you've found a bug or have technical feedback, please create an issue on the Actor's [Issues tab](https://apify.com/clockworks/tiktok-transcripts-scraper/issues/open) in Apify Console.
### FAQ
#### How much does it cost to use TikTok Transcripts?
Downloading TikTok's built-in subtitles is included in the standard scraping cost. AI transcription (speech-to-text) is charged as an additional event — see your plan details for per-video pricing.
Apify provides $5 free usage credits every month on the [Apify Free plan](https://apify.com/pricing).
#### How can I use TikTok Transcripts with the Apify API?
The Apify API gives you programmatic access to the Apify platform. You can use the `apify-client` NPM or PyPI package to run this Actor, fetch results, and integrate it into your own pipelines.
Check out the [Apify API reference](https://docs.apify.com/api/v2) docs for full details, or click on the [API tab](https://apify.com/clockworks/tiktok-transcripts-scraper/api) for code examples.
#### Is it legal to scrape TikTok with TikTok Transcripts?
TikTok Transcripts only accesses publicly available video content. It does not extract private user data. You should be aware that your results may contain personal data, which is 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/).
# 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/@apifyoffice/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/@apifyoffice/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/@apifyoffice/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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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/@apifyoffice/video/7338085038258457889"
]
}' |
apify call clockworks/tiktok-transcript-extractor --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=clockworks/tiktok-transcript-extractor",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "TikTok Transcript Extractor",
"description": null,
"version": "0.0",
"x-build-id": "yjza4gs3g2AS4kJPk"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/clockworks~tiktok-transcript-extractor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-clockworks-tiktok-transcript-extractor",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/clockworks~tiktok-transcript-extractor/runs": {
"post": {
"operationId": "runs-sync-clockworks-tiktok-transcript-extractor",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/clockworks~tiktok-transcript-extractor/run-sync": {
"post": {
"operationId": "run-sync-clockworks-tiktok-transcript-extractor",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"postURLs"
],
"properties": {
"postURLs": {
"title": "Video URL(s)",
"type": "array",
"description": "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.",
"items": {
"type": "string"
}
},
"downloadSubtitlesOptions": {
"title": "Subtitles & Transcription",
"enum": [
"DOWNLOAD_SUBTITLES",
"DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES",
"TRANSCRIBE_ALL_VIDEOS"
],
"type": "string",
"description": "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.",
"default": "DOWNLOAD_SUBTITLES"
},
"videoKvStoreIdOrName": {
"title": "✍️ Name your storage",
"pattern": "^[a-zA-Z0-9-]+$",
"type": "string",
"description": "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.