TikTok Transcript Scraper

Extract TikTok video transcripts, caption segments, and video metadata from public TikTok video URLs.

What does TikTok Transcript Scraper do?

TikTok Transcript Scraper turns a list of TikTok video links into structured transcript data. It fetches public TikTok video pages, looks for TikTok caption/subtitle metadata, downloads available subtitle files, and saves one dataset row per video.

Who is it for?

• 📣 Social media managers who repurpose TikTok videos into blog posts, captions, and newsletters
• 🧠 AI workflow builders who need transcript text for summarization or classification
• 📊 Brand researchers who monitor creator messaging and campaign language
• 🎬 Video editors who need text from multiple TikTok clips
• 📰 Journalists and analysts who review public short-form video content

Why use this actor?

Manual transcript collection is slow and inconsistent. This actor normalizes transcript availability, subtitle sources, video metadata, engagement counters, and errors into a predictable dataset.

Data you can extract

Field	Description
url	Submitted TikTok URL
finalUrl	Final URL after redirects
videoId	TikTok video ID
authorUsername	Creator username when available
authorDisplayName	Creator display name
description	TikTok caption text
hashtags	Hashtags parsed from TikTok metadata/caption
publishedAt	Publish timestamp when TikTok exposes it
durationSeconds	Video duration
likeCount	Like count
commentCount	Comment count
shareCount	Share count
playCount	Play/view count
transcriptAvailable	Whether readable public captions were found
transcriptText	Full transcript text
transcriptSegments	Timed transcript segments
transcriptLanguage	Transcript language or language code
subtitleSources	Raw subtitle source metadata
error	Reason transcript/metadata was unavailable
scrapedAt	Timestamp of extraction

How much does it cost to scrape TikTok transcripts?

The actor uses pay-per-event pricing. There is a small start event per run and a per-video item event for saved dataset rows. Exact tiered prices are shown on the Apify actor page and may include free monthly usage for eligible Apify users.

How to use TikTok Transcript Scraper

1. Open the actor on Apify.
2. Paste TikTok video URLs into TikTok video URLs.
3. Set Maximum videos for the run.
4. Keep Save videos without transcripts enabled if you want rows for missing captions.
5. Start the run.
6. Download results as JSON, CSV, Excel, XML, RSS, or via API.

Input example

{
  "startUrls": [
    { "url": "https://www.tiktok.com/@tedtoks/video/7295065135788477742" }
  ],
  "maxItems": 1,
  "includeMetadataOnly": true
}

Output example

{
  "url": "https://www.tiktok.com/@example/video/1234567890",
  "videoId": "1234567890",
  "authorUsername": "example",
  "description": "Public TikTok caption #example",
  "transcriptAvailable": true,
  "transcriptText": "This is the transcript text.",
  "transcriptSegments": [
    { "startTime": 0, "endTime": 2.1, "text": "This is the transcript text." }
  ],
  "error": null
}

Transcript availability

Not every TikTok video has public captions. Some creators disable captions, some videos have no speech, and some videos are private, removed, age-gated, or geo-restricted. When captions are missing, the actor can still save a row with transcriptAvailable: false and a clear error value.

Tips for best results

• Use direct TikTok video URLs rather than profile URLs.
• Keep the first run small to confirm the URLs are public.
• Enable metadata-only fallback when auditing a large list.
• Disable metadata-only fallback when you only want rows with transcripts.
• Expect some TikTok videos to return no captions.

Integrations

Use the actor in workflows such as:

• TikTok-to-blog summarization pipelines
• UGC campaign monitoring dashboards
• Creator content research notebooks
• Brand safety review queues
• AI prompt generation from short-form videos
• Cross-platform content repurposing systems

API usage with Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/tiktok-transcript-scraper').call({
  startUrls: [{ url: 'https://www.tiktok.com/@tedtoks/video/7295065135788477742' }],
  maxItems: 1,
  includeMetadataOnly: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

API usage with Python

from apify_client import ApifyClient

client = ApifyClient()
run = client.actor('automation-lab/tiktok-transcript-scraper').call(run_input={
    'startUrls': [{'url': 'https://www.tiktok.com/@tedtoks/video/7295065135788477742'}],
    'maxItems': 1,
    'includeMetadataOnly': True,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

API usage with cURL

curl -X POST 'https://api.apify.com/v2/acts/automation-lab~tiktok-transcript-scraper/runs?token=YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"startUrls":[{"url":"https://www.tiktok.com/@tedtoks/video/7295065135788477742"}],"maxItems":1,"includeMetadataOnly":true}'

MCP usage

Connect this actor to Claude Desktop, Claude Code, or another MCP client through Apify MCP Server. Use this MCP URL:

https://mcp.apify.com/?tools=automation-lab/tiktok-transcript-scraper

Add it to Claude Code with:

$claude mcp add apify-tiktok-transcript "https://mcp.apify.com/?tools=automation-lab/tiktok-transcript-scraper"

For Claude Desktop or other JSON-based MCP clients, add:

{
  "mcpServers": {
    "apify-tiktok-transcript": {
      "url": "https://mcp.apify.com/?tools=automation-lab/tiktok-transcript-scraper"
    }
  }
}

Example prompts:

• "Extract transcripts from these TikTok URLs and summarize common themes."
• "Find the hashtags and transcript text for this list of campaign videos."
• "Turn these TikTok transcripts into newsletter snippets."

Legality

Legal and ethical notes

This actor is designed for public TikTok video pages. You should only process content you are allowed to access and use. Respect TikTok terms, copyright, privacy rights, and applicable laws. Do not use transcript data for harassment, spam, discrimination, or other harmful activity.

Limitations

• Private, deleted, age-gated, or geo-restricted videos may fail.
• TikTok may not expose captions for every video.
• Auto-generated captions can contain mistakes.
• Engagement counters may be missing or rounded depending on TikTok response data.
• Upstream TikTok page structure can change.

FAQ

Can this actor transcribe videos without TikTok captions?

No. The MVP extracts public subtitle/caption files that TikTok exposes for the video. It does not run paid speech-to-text on videos with no captions.

Does it need TikTok login cookies?

No. The actor is designed for public video URLs and does not request your TikTok account credentials.

Troubleshooting

Why is transcriptAvailable false?

The video probably has no public caption file, captions are disabled, the video has no speech, or TikTok did not expose subtitle metadata for the request. Keep includeMetadataOnly enabled to inspect the error field.

Why did a TikTok URL return only an error?

The URL may be private, removed, invalid, region-limited, or blocked by TikTok. Try opening it in a logged-out browser and confirm it is a direct video URL.

Related scrapers

Other automation-lab actors you may use with this actor:

• https://apify.com/automation-lab/tiktok-scraper
• https://apify.com/automation-lab/tiktok-comments-scraper
• https://apify.com/automation-lab/youtube-transcript-scraper
• https://apify.com/automation-lab/video-transcript-scraper

Performance

This actor is HTTP-based and avoids launching a browser for the MVP. That keeps runs lightweight for batches of direct video URLs.

Privacy

The actor does not ask for your TikTok login or cookies. It works from public URLs and saves only data returned by public TikTok pages and subtitle files.

Changelog

• Initial version: public TikTok URL transcript extraction with metadata fallback.

Support

If a public video URL fails unexpectedly, share the run and URL through Apify support so we can inspect the current TikTok response shape.

Final notes

TikTok transcript availability varies by video. For reliable analysis pipelines, keep the error and transcriptAvailable fields in downstream processing so missing captions can be handled gracefully.