YouTube Transcript Scraper

Extract transcripts and timestamped caption segments from public YouTube videos. Export text for summaries, RAG, content research, and AI-agent workflows.

At a glance

• Transcript extraction: Convert public YouTube captions into clean transcript text.
• Timestamped segments: Keep start and duration values for quotes, clips, RAG chunks, and evidence tables.
• URL and ID input: Use watch URLs, Shorts URLs, youtu.be links, embed URLs, live URLs, or raw video IDs.
• Metadata option: Include public title, channel name, duration, and thumbnail URL when available.
• Batch-safe errors: Videos without public captions save clear status rows instead of failing the whole run.

What can it do?

YouTube Transcript Scraper turns public YouTube captions into structured data.

It accepts YouTube watch URLs, Shorts URLs, youtu.be links, embed URLs, live URLs, or raw video IDs.

For every video, it returns a dataset row with the video ID, URL, title, channel name, caption language, transcript text, and optional timestamped segments.

Videos without public captions are handled gracefully with a clear error message instead of failing the whole run.

Common workflows

• SEO and content teams: repurpose transcripts into briefs, blog drafts, quote libraries, keyword research, and content audits.

• Researchers and analysts: collect spoken content from public videos for media monitoring, qualitative research, public-interest analysis, or education datasets.

• LLM and RAG builders: create clean text chunks from public captions for search, summarization, classification, embeddings, and retrieval workflows.

• Sales and marketing teams: extract talks, interviews, demos, webinars, and competitor videos into searchable text for faster review.

• Journalists and fact checkers: create searchable transcript records for public videos, speeches, interviews, and announcements.

Why use this actor?

• Structured output with one row per video
• Transcript text plus timestamped segments
• Public caption language selection
• Graceful handling for videos with no captions
• Works with video URLs and video IDs
• Low-cost runs for captioned public videos
• Output ready for spreadsheets, APIs, and AI workflows

What data can you extract?

How to use YouTube Transcript Scraper

1. Open the actor on Apify.
2. Paste one or more public YouTube video URLs.
3. Optionally set a preferred caption language such as en, es, or de.
4. Choose whether to include timestamped segments.
5. Click Start.
6. Download the dataset as JSON, CSV, Excel, XML, or HTML.

Example input

{
  "videoUrls": [
    { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
  ],
  "language": "en",
  "includeTimestamps": true,
  "includeMetadata": true,
  "maxVideos": 1
}

Example output

{
  "videoId": "dQw4w9WgXcQ",
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "Example video title",
  "channelName": "Example channel",
  "language": "en",
  "isAutoGenerated": false,
  "transcriptText": "We're no strangers to love...",
  "segments": [
    { "start": 0.0, "duration": 2.1, "text": "We're no strangers to love" }
  ],
  "duration": 213,
  "thumbnailUrl": "https://i.ytimg.com/...",
  "captionsAvailable": true
}

Supported YouTube URL formats

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://www.youtube.com/shorts/VIDEO_ID
• https://www.youtube.com/embed/VIDEO_ID
• https://www.youtube.com/live/VIDEO_ID
• Raw VIDEO_ID values

Caption language selection

Set language to your preferred caption language code.

If that exact language is not available, the actor falls back to a related language variant or the first public caption track.

For example, en may match English captions when present.

The selected language is returned in the language field.

Timestamped transcript segments

Enable includeTimestamps to receive segment-level timing.

Each segment can include:

• start — segment start in seconds
• duration — segment length in seconds
• text — spoken caption text

Disable timestamps when you only need the combined transcript text.

Metadata fields

Enable includeMetadata to include public video details when available.

Metadata can include title, channel name, duration, and thumbnail URL.

Some unavailable or restricted videos may return less metadata.

Handling videos with no captions

Not every public YouTube video has public captions.

When captions are unavailable, the actor still saves a row with:

• captionsAvailable: false
• the video ID and URL
• an error message explaining what happened

This makes batch runs easier to audit because one bad video does not stop the rest of the run.

Tips for best results

• Use public videos with captions enabled.
• Start with a small batch to confirm your input format.
• Use language when you need a specific caption language.
• Keep maxVideos low for testing and increase it after validation.
• Check captionsAvailable before using transcript text in automated workflows.

AI-agent recipe

Goal: turn public webinar or video captions into a summary and quote table.

Input:

{
  "videoUrls": [
    { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
  ],
  "language": "en",
  "includeTimestamps": true,
  "includeMetadata": true,
  "maxVideos": 1
}

Prompt to use with Claude / ChatGPT / MCP: "Extract transcripts from these public YouTube URLs. Create a table with video URL, key claims, notable quotes, and timestamps."

Follow-up automation:

• Schedule: Run after each new public webinar, podcast, or product video is published.
• Export: Docs, Sheets, a vector DB, or Slack summaries for content review.
• Guardrail: Use only public caption tracks returned by the actor; respect copyright and platform terms.

Integrations

You can connect the dataset to:

• Google Sheets for editorial review
• Zapier or Make for automations
• Vector databases for embeddings and retrieval
• BI tools for media analysis
• Internal dashboards for monitoring public video content
• LLM workflows for summarization, tagging, and question answering

API usage with Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/youtube-transcript-scraper').call({
  videoUrls: [{ url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ' }],
  language: 'en',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0].transcriptText);

API usage with Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/youtube-transcript-scraper').call(run_input={
    'videoUrls': [{'url': 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'}],
    'language': 'en',
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items[0].get('transcriptText'))

API usage with cURL

curl -X POST "https://api.apify.com/v2/acts/fetch_cat~youtube-transcript-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"videoUrls":[{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}],"language":"en"}'

MCP and AI agents

Use this actor through Apify MCP when you want an AI assistant to fetch public video transcripts.

MCP server URL pattern:

https://mcp.apify.com/?tools=fetch_cat/youtube-transcript-scraper

Claude Code setup:

claude mcp add apify-youtube-transcripts --transport http --url "https://mcp.apify.com/?tools=fetch_cat/youtube-transcript-scraper"

Claude Desktop JSON config:

{
  "mcpServers": {
    "apify-youtube-transcripts": {
      "url": "https://mcp.apify.com/?tools=fetch_cat/youtube-transcript-scraper"
    }
  }
}

Example prompts:

• "Extract the transcript from this public YouTube video and summarize the key claims."
• "Get transcripts for these five public webinar URLs and make a topic table."
• "Find quotes in this public interview transcript about pricing."

Common use cases

• Video-to-blog repurposing
• Public webinar transcript extraction
• Research corpus creation
• Podcast-style YouTube episode analysis
• Competitive content monitoring
• Training data preparation from public captions
• Subtitle QA and language availability checks

Limitations

This actor extracts public captions only.

It cannot access private videos, members-only videos, deleted videos, region-blocked content unavailable to the runner, or videos without public caption tracks.

Transcript quality depends on the caption track provided for the public video.

Auto-generated captions may contain recognition errors.

Legality and responsible use

Use this actor only for content you are allowed to access and process.

YouTube videos and captions may be protected by copyright or platform terms.

You are responsible for ensuring that your use case, storage, redistribution, and analysis comply with applicable laws, platform rules, and rights-holder requirements.

Troubleshooting

My run succeeded but transcript text is empty

Check the error and captionsAvailable fields. The video probably has no public caption track.

My preferred language was not returned

The requested language may not be available. The actor falls back to another public caption track when needed.

Support

If a public captioned video fails unexpectedly, provide the video URL, input JSON, and run ID so the issue can be reproduced.