YouTube Video Transcript & Channel Captions Scraper

Thirdwatch portfolio: 5K users across 88 public Actors, 2M+ records delivered, and >99% run success. Explore all Thirdwatch Actors.

Pull transcripts from individual videos or complete YouTube channels — full text, timestamps, rich metadata, every language track, no API key.

Pull transcripts and closed captions from individual YouTube videos or whole channels, at scale, with no API key. Filter channel videos by exact publish date. Every successful record combines the transcript with title, description, views, duration, engagement, channel identity, thumbnails, tags, and publication metadata.

Built for RAG pipelines over video libraries, sentiment analysis, video summarization, accessibility workflows, and agentic tools that read video content.

What you get

A clean, structured transcript and metadata record per video. Choose a preferred language or let the actor fall back to whatever is available. Returns both the full joined transcript_text (ideal for vector stores) and a segments array with per-line timestamps (ideal for subtitle overlays and chapter generation).

Use videoUrls for an ad-hoc batch or channelUrls to build a dated transcript corpus from one or more channels. Both modes use the same inexpensive direct-HTTP extraction path and automatically retry IP-dependent failures through residential proxy only when necessary.

Output fields

Field	Description
video_id	11-character YouTube video ID
video_url	Canonical watch URL
title, description	Video title and full description
published_at, upload_date	Exact publication dates
view_count, like_count, comment_count	Public engagement metrics when YouTube exposes them
duration_seconds	Full video duration
channel_id, channel_name, channel_url	Channel identity
channel_username, channel_thumbnail, subscriber_count	Public channel profile fields when available
thumbnail, category, tags	Video discovery metadata
language_code	Actual caption language returned (ISO 639-1)
language_name	Human-readable language name
is_auto_generated	true if auto-captions, false if human-written
auto_translated	true if auto-translated into the requested language
available_languages	Array of {code, name, is_auto_generated} for every track on the video
transcript_text	Full transcript joined into one string
segments	Array of {text, start, duration} per caption line
segment_count	Number of caption lines
total_duration_seconds	Total covered duration
data_source	Origin tag
used_residential_proxy	true only when the direct request was blocked and the paid fallback succeeded

Failures are not written to the paid result dataset. They are available in the run's ERRORS key-value-store record with codes such as no_captions_available, private_video, region_locked, age_restricted_or_login_required, video_unavailable, no_player_response, transcript_fetch_failed, and empty_transcript.

Example output

{
    "video_id": "dQw4w9WgXcQ",
    "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Never Gonna Give You Up",
    "channel_name": "Rick Astley",
    "published_at": "2009-10-25",
    "view_count": 1700000000,
    "duration_seconds": 213,
    "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
    "language_code": "en",
    "language_name": "English",
    "is_auto_generated": false,
    "auto_translated": false,
    "available_languages": [
        {"code": "en", "name": "English", "is_auto_generated": false},
        {"code": "es", "name": "Spanish", "is_auto_generated": false},
        {"code": "en", "name": "English (auto-generated)", "is_auto_generated": true}
    ],
    "transcript_text": "We're no strangers to love You know the rules and so do I ...",
    "segment_count": 58,
    "total_duration_seconds": 212.48,
    "segments": [
        {"text": "We're no strangers to love", "start": 18.8, "duration": 7.0},
        {"text": "You know the rules and so do I", "start": 25.8, "duration": 3.5},
        {"text": "A full commitment's what I'm thinking of", "start": 29.3, "duration": 3.7}
    ],
    "data_source": "youtube_timedtext"
}

Example unbilled error diagnostic (no captions published)

{
    "failed_count": 1,
    "failed_videos": [
        {
            "video_id": "abc123XYZ_0",
            "video_url": "https://www.youtube.com/watch?v=abc123XYZ_0",
            "error": "no_captions_available",
            "available_languages": [],
            "data_source": "youtube_innertube"
        }
    ]
}

Input parameters

Parameter	Required	Description
videoUrls	One of	YouTube URLs. Supports watch?v=, youtu.be/, shorts/, embed/.
videoIds	One of	Raw 11-character video IDs. Either videoUrls or videoIds must be provided.
channelUrls	One of	YouTube channel URLs or handles. Supports @handle, /channel/, /c/, and /user/.
maxVideosPerChannel	No	Maximum matching videos per channel. Default 10, max 200.
startDate	No	Only channel videos published on or after this YYYY-MM-DD date.
endDate	No	Only channel videos published on or before this YYYY-MM-DD date.
languageCode	No	Preferred caption language. Default en.
preferManual	No	Prefer human-written captions over auto-generated. Default true.
includeTimestamps	No	Include the segments array. Default true. Turn off for smaller RAG payloads.
includeAutoTranslate	No	Fall back to YouTube auto-translate if the requested language isn't available. Default false.
includeMetadata	No	Include rich video, engagement, and channel metadata. Default true.
useResidentialProxy	No	Allow residential retry after a direct IP-dependent failure. Direct HTTP is always tried first. Default true.
maxResults	No	Global cap on transcripts returned. Default 10, max 10000.

Pricing

Only successfully delivered transcripts are billed. Ordinary direct-HTTP transcripts start at $0.003 per video; subscriber tiers reduce that to $0.0025, $0.002, and $0.0015. If YouTube blocks direct cloud egress and the residential fallback succeeds, that transcript has one additional $0.004 proxy fallback event. Videos without captions and other failed inputs are recorded under ERRORS and are not billed as results.

Use cases

• AI engineers (RAG): index thousands of talks, lectures, tutorials for semantic search. transcript_text drops straight into your vector store.
• Content marketers: generate written blog posts, newsletters, and social clips from podcast and YouTube content at scale.
• Product & research teams: run sentiment analysis across competitor channels and track topic drift over time.
• Accessibility & compliance: build closed-caption corpora in bulk for ADA / WCAG compliance.
• Agent builders: plug into Claude / GPT / MCP workflows so an agent can "read" a YouTube URL.
• Language learners & translators: grab multilingual caption tracks side-by-side for study material.
• Video summarization tools: feed full transcripts into an LLM to generate chapter markers, key takeaways, and tl;drs.

Limitations

• Not all videos have transcripts — some uploaders disable captions entirely. Those videos are listed in the unbilled ERRORS record with no_captions_available.
• Auto-generated transcripts are lower quality — especially for music, accents, and technical content. Set preferManual: true (default) to pick human-written tracks whenever available.
• Age-restricted and private videos are blocked — they appear in the unbilled ERRORS record rather than the paid result dataset. Region-locked videos behave the same way.
• YouTube occasionally throttles heavy uninterrupted runs; the actor backs off automatically on rate limits.

Compared to alternatives

• starvibe/youtube-video-transcript — both actors support video and channel transcripts, date filters, languages, timestamps, and metadata. Thirdwatch adds native batch URL/ID input, manual-caption preference, optional auto-translation, explicit unbilled failure diagnostics, and a direct-HTTP price starting 70% lower.
• Apify's pintostudio/youtube-transcript-scraper — similar scope at $0.01 per transcript; our direct path starts at $0.003 and keeps failed videos unbilled.
• youtube-transcript-api (Python library) — free to run yourself, but you handle the proxy, consent cookie, and retry logic. This actor is a hosted drop-in with built-in reliability.
• Official YouTube Data API — captions endpoint requires OAuth and channel ownership; not usable for third-party videos.

Pairs well with

• YouTube Scraper — pull video metadata (title, description, views, likes, channel) first, then feed the IDs here for transcripts.
• Google News Scraper — enrich news-video transcripts with source articles.
• Reddit Scraper — cross-reference discussion threads with the video's transcript.

FAQ

Does this work on YouTube Shorts? Yes — youtube.com/shorts/{id} URLs work identically to regular videos.

Do I need an API key? No. The actor uses YouTube's public caption endpoints — no OAuth, no Google Cloud project.

Can I get transcripts for private videos? No. Private videos return a private_video error. Only publicly published videos are supported.

Which languages are supported? Every language a video has published captions for. Use languageCode to pick your preferred track, or enable includeAutoTranslate to cross-translate.

What happens if captions are disabled? The video is omitted from paid results and recorded under ERRORS with error: "no_captions_available", so your pipeline can filter, retry, or skip it without paying for a transcript that was not delivered.

Can I feed this straight into a vector DB? Yes — the transcript_text field is a single joined string designed for RAG ingestion. Turn off includeTimestamps to drop the segments array and shrink payloads further.

---

Built by Thirdwatch. Questions? Open an issue or reach out on the Apify Store listing.

Last verified: 2026-08