# TikTok Transcript Scraper | Captions + AI Fallback (`zrk1212/tiktok-transcript-scraper`) Actor

Get TikTok video transcripts from video URLs or profiles. Uses TikTok's own captions first and low-cost AI speech-to-text only when captions are missing. Text, timestamps, SRT, language, views and likes.

- **URL**: https://apify.com/zrk1212/tiktok-transcript-scraper.md
- **Developed by:** [zachary klein](https://apify.com/zrk1212) (community)
- **Categories:** Social media, Videos, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 caption transcripts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Scraper

Get the transcript of any public TikTok video from its link, or from a creator's latest videos. The actor uses TikTok's own captions first, at caption prices, and low-cost AI speech-to-text only for videos that have no captions. You get clean text, timestamps, optional SRT and WebVTT, the language, and the video's views, likes and comments.

### What does it do?

- **Captions first.** Reads the captions TikTok already made for the video and picks the right track: the language actually spoken, not a machine translation, unless you ask for a specific language.
- **AI fallback only when needed.** If a video has no captions, its audio is transcribed with Whisper speech-to-text and you pay per started minute, at a fraction of typical AI transcription prices. Music and silent videos are detected, and you are not charged AI minutes for them.
- **Three ways in.** Video links (including vm.tiktok.com short links and bare IDs), profile usernames (latest N videos), or the dataset ID of any other TikTok scraper, for example a hashtag or search scraper.
- **Ready-to-use output.** Plain text, timestamped segments, SRT and WebVTT subtitles, word count, language, caption type, plus video stats.
- **Honest billing.** Deleted, private, blocked or invalid videos are free error rows. You can drop rows without a transcript so they are not charged either.

### Who is it for?

- **Content researchers and agencies** studying hooks, scripts and formats that perform.
- **Brands** monitoring what creators say about them.
- **AI and RAG pipelines** that need TikTok speech as text for LLMs.
- **Accessibility and subtitling** workflows that need SRT or WebVTT files.
- **Social listening and trend analysis**, and **academic research** on short-form video.

### What data do you get?

| Field | Example |
|---|---|
| `url` | https://www.tiktok.com/@nasa/video/7707774305056083213 |
| `authorUsername`, `authorName`, `authorVerified` | nasa, NASA, true |
| `description`, `hashtags` | From MAX POWER to Mars..., \["space"] |
| `createdAt` | 2026-11-13T21:41:18.000Z |
| `durationSec` | 146 |
| `views`, `likes`, `comments`, `shares`, `saves` | 100300, 3878, 1374, 413, 318 |
| `transcript` | From turning up the power at Kennedy Space Center to turning our sights toward the Red Planet... |
| `wordCount` | 377 |
| `language` | en |
| `transcriptSource` | `native` (TikTok captions), `ai` (speech-to-text) or `none` |
| `captionKind` | `ASR` (TikTok auto captions), `CREATOR` (captions uploaded by the creator) or `MT` (machine translation) |
| `availableCaptionLanguages` | \["eng-US", "spa-ES"] |
| `segments` | \[{"start": 0.42, "end": 2.66, "text": "From turning up the power..."}] |
| `srt`, `vtt` | Subtitle text (optional) |
| `aiMinutesBilled` | 0 |
| `status`, `statusMessage` | OK |
| `inputSource` | url, profile:nasa or dataset:abc123 |

`status` tells you what happened when there is no transcript: `NO_CAPTIONS` (AI fallback off), `NO_SPEECH` (music or no talking), `AI_SKIPPED_FREE_PLAN`, `AI_SKIPPED_TOO_LONG`, `AI_SKIPPED_LIMIT`, `AI_FAILED` or `AI_DISABLED`.

Errors come as separate rows with `error: true`, `errorCode` (`NOT_FOUND`, `PRIVATE_VIDEO`, `PRIVATE_ACCOUNT`, `PHOTO_POST`, `INVALID_URL`, `INVALID_USERNAME`, `PROFILE_NOT_FOUND`, `PROFILE_EMPTY`, `DATASET_ERROR`, `BLOCKED`, `UNKNOWN`) and a plain-English `errorMessage`. They are never charged.

### How much does it cost?

| What you get | Price | 100 videos | 1,000 videos | 10,000 videos |
|---|---|---|---|---|
| Transcript from TikTok captions | $1.50 per 1,000 | $0.15 | $1.50 | $15 |
| AI transcript (videos without captions, paid plans) | $0.004 per started minute | about $0.40 | about $4 | about $40 |
| Video without a transcript (stats only) | $0.50 per 1,000 | $0.05 | $0.50 | $5 |
| Errors (deleted, private, invalid, blocked) | Free | | | |

A typical mix (most videos with captions, some short videos needing AI) costs about $2 per 1,000 videos. Rows without a transcript are charged at the stats-only price when the reason is on the video's side (no captions and AI off, music only, too long for your AI limit, or free plan). If AI fails on our side or your spending limit is too low for AI, the row is free. Turn on **Skip videos without a transcript** to pay only for transcripts. Apify's free monthly credit lets you try it at no cost.

**AI transcription is only on paid Apify plans.** It costs real money per minute of audio, and runs on the free plan earn the developer nothing, so on the free plan you get TikTok captions only.

### How to use it

1. Click **Try for free**.
2. Paste video links into **Video URLs**, and/or usernames into **Profiles** (set **Videos per profile**).
3. Keep **AI transcription when captions are missing** on if you want a transcript for every video (paid plans).
4. Optional: set a **Preferred caption language**, and turn on SRT or WebVTT output.
5. Click **Start** and download the results as JSON, CSV or Excel.

```json
{
    "videoUrls": ["https://www.tiktok.com/@nasa/video/7707774305056083213"],
    "profiles": ["nasa"],
    "maxVideosPerProfile": 10,
    "aiFallback": true,
    "includeSrt": true
}
```

#### Hashtags and search

The actor does not search TikTok by hashtag or keyword yet. Run any TikTok hashtag or search scraper first, then paste its dataset ID into **Dataset ID from another TikTok scraper**. The actor reads the video links from it.

### Example output

```json
[
    {
        "id": "7707774305056083213",
        "url": "https://www.tiktok.com/@nasa/video/7707774305056083213",
        "inputSource": "url",
        "authorUsername": "nasa",
        "authorName": "NASA",
        "createdAt": "2026-11-13T21:41:18.000Z",
        "durationSec": 146,
        "views": 100300,
        "language": "en",
        "transcriptSource": "native",
        "captionKind": "CREATOR",
        "transcript": "From turning up the power at Kennedy Space Center to turning our sights toward the Red Planet, NASA had a week to remember...",
        "wordCount": 377,
        "segments": [{ "start": 0.42, "end": 2.66, "text": "From turning up the power at Kennedy Space Center" }],
        "aiMinutesBilled": 0,
        "status": "OK"
    },
    {
        "id": "7708876685579455757",
        "url": "https://www.tiktok.com/@garyvee/video/7708876685579455757",
        "authorUsername": "garyvee",
        "durationSec": 29,
        "language": "en",
        "transcriptSource": "ai",
        "captionKind": null,
        "transcript": "What are you scared of? Failing? Not failing, but still being at the same place when my friends are at the next level...",
        "wordCount": 117,
        "aiMinutesBilled": 1,
        "status": "OK"
    }
]
```

### Use it via API, MCP, n8n, Make, Zapier

Call it from any language with the Apify API, from AI agents through the Apify MCP server, or from n8n, Make and Zapier with the Apify integration.

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

### FAQ

**Why do some videos have no transcript?**
Music, dance and other non-verbal videos have no speech, and TikTok does not caption every talking video. On paid plans the AI fallback transcribes talking videos without captions. Videos with only music come back as `NO_SPEECH`, and AI minutes are not charged.

**What is the difference between native and AI transcripts?**
Native transcripts are TikTok's own captions (auto-generated or uploaded by the creator). AI transcripts come from Whisper speech-to-text on the video's audio. Both have timestamps.

**Which languages are supported?**
Every language TikTok captions, plus Whisper's 90+ languages for AI transcripts. By default you get the language spoken in the video. Set **Preferred caption language** to get a TikTok translation when one exists.

**Do you charge for failed videos?**
No. Deleted, private, blocked and invalid videos are free error rows, and so are AI failures on our side.

**Is it legal?**
The actor reads only public video pages without logging in, and collects only what TikTok shows publicly. Transcripts are the creators' words: research, analysis and accessibility are common uses, but check copyright before republishing them.

**Can I use residential proxies?**
You do not need to. The actor starts on datacenter proxies and automatically retries on residential proxies only for videos that datacenter proxies cannot load. If you select the residential group, the run still starts on datacenter proxies, because TikTok challenges residential IPs more often and that only makes runs slower.

**Something broke?**
TikTok changes its website often. Open an Issue on the actor page and we will fix it within 24 hours.

### Related actors

- [Luma Event Scraper: Organizer Leads](https://apify.com/zrk1212/luma-organizer-leads)
- [Bulk PageSpeed Insights & Core Web Vitals Checker](https://apify.com/zrk1212/pagespeed-bulk-auditor)

# Changelog

This Actor's version history is a separate document: https://apify.com/zrk1212/tiktok-transcript-scraper/changelog.md

# Actor input Schema

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

TikTok video links, for example https://www.tiktok.com/@user/video/1234567890123456789. Short links (vm.tiktok.com, vt.tiktok.com, tiktok.com/t/), m.tiktok.com links and bare numeric video IDs also work. Photo posts return an error item because they have no audio.

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

TikTok usernames, with or without @, or profile links. The actor takes the latest videos of each profile.

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

How many of the most recent videos to take from each profile.

## `datasetId` (type: `string`):

ID of an Apify dataset made by another TikTok scraper (for example a hashtag or search scraper). The actor reads webVideoUrl, url, videoUrl, postUrl or submittedVideoUrl from each item.

## `aiFallback` (type: `boolean`):

When a video has no TikTok captions, transcribe its audio with AI speech-to-text. Paid Apify plans only. Charged per started minute of audio. Turn off to get captions only.

## `maxAiDurationSec` (type: `integer`):

Videos longer than this are not AI transcribed, which protects your budget. Captions are still returned for long videos.

## `preferredLanguage` (type: `string`):

Optional language code such as en or es. If TikTok offers captions in this language (including its translations), they are used. Empty means the language spoken in the video.

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

Add timestamped segments (start, end, text) to each row.

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

Add the transcript as SRT subtitle text in the srt field.

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

Add the transcript as WebVTT subtitle text in the vtt field.

## `skipVideosWithoutTranscript` (type: `boolean`):

Do not output (and do not charge for) videos that end up with no transcript.

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

Apify Proxy. The actor starts on datacenter proxies and retries blocked videos on residential proxies automatically. Selecting the residential group is not needed: it is used only as that automatic fallback.

## Actor input object example

```json
{
  "videoUrls": [
    "https://www.tiktok.com/@nasa/video/7707774305056083213",
    "https://www.tiktok.com/@luisitocomunica/video/7708880086925135112"
  ],
  "profiles": [
    "nasa"
  ],
  "maxVideosPerProfile": 4,
  "aiFallback": true,
  "maxAiDurationSec": 600,
  "includeSegments": true,
  "includeSrt": false,
  "includeVtt": false,
  "skipVideosWithoutTranscript": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `results` (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 = {
    "videoUrls": [
        "https://www.tiktok.com/@nasa/video/7707774305056083213",
        "https://www.tiktok.com/@luisitocomunica/video/7708880086925135112"
    ],
    "profiles": [
        "nasa"
    ],
    "maxVideosPerProfile": 4,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("zrk1212/tiktok-transcript-scraper").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 = {
    "videoUrls": [
        "https://www.tiktok.com/@nasa/video/7707774305056083213",
        "https://www.tiktok.com/@luisitocomunica/video/7708880086925135112",
    ],
    "profiles": ["nasa"],
    "maxVideosPerProfile": 4,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("zrk1212/tiktok-transcript-scraper").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 '{
  "videoUrls": [
    "https://www.tiktok.com/@nasa/video/7707774305056083213",
    "https://www.tiktok.com/@luisitocomunica/video/7708880086925135112"
  ],
  "profiles": [
    "nasa"
  ],
  "maxVideosPerProfile": 4,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call zrk1212/tiktok-transcript-scraper --silent --output-dataset

```

## MCP server setup

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

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/9w9mih2vnNf7O89Do/builds/IHsq5ZVXDZKQHbmdg/openapi.json
