YouTube Transcript API — Videos, Channels, Playlists, SRT/VTT
Pricing
from $1.00 / 1,000 video transcripts
YouTube Transcript API — Videos, Channels, Playlists, SRT/VTT
Bulk YouTube transcripts and subtitles from video, Shorts, channel and playlist URLs, or another Actor's dataset. One item per video: timestamped segments, text, SRT, VTT, language choice. $1 per 1,000 videos on the free plan, from $1 on paid plans; no captions = free. For n8n, Make, MCP agents.
Pricing
from $1.00 / 1,000 video transcripts
Rating
0.0
(0)
Developer
Sherwood
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
1
Monthly active users
13 days ago
Last modified
Categories
Features
Share
YouTube Transcript API — transcripts and subtitles in bulk, $1 per 1,000 videos on the free plan, from $1 on paid plans
Give it YouTube video, Shorts, channel or playlist URLs (or bare video IDs) and get one dataset item per video with the transcript as timestamped segments and plain text, plus SRT and WebVTT on demand, in the language you prefer or machine-translated. Videos without captions are reported and not charged. Nothing is required: the default input runs alone in a few seconds.
Built for agents and workflows (MCP, n8n, Make, the API): a list in, a flat item per video out, the field names of the
most used YouTube transcript Actor (video_id, language_code, is_generated, timestamped, non_timestamped...),
so a workflow written for it keeps working.
What you get
One item per video. A successful item (outputFormats: ["json", "text", "srt"], trimmed):
{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ","video_id": "dQw4w9WgXcQ","source": null,"title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)","channel_name": "Rick Astley","channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw","channel_url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw","video_duration_seconds": 213,"view_count": 1834994377,"thumbnail_url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/sddefault.webp","was_live": false,"language": "English","language_code": "en","is_generated": false,"is_translatable": true,"translation_languages": ["ar", "zh-Hant", "nl", "en", "fr", "de", "hi", "id", "it", "ja", "ko", "..."],"translated_to": null,"translation_error": null,"source_type": "Manual","snippet_count": 61,"total_seconds": 211.32,"duration_human": "3m 31s","timestamped": [{"text": "[♪♪♪]", "start": 1.36, "duration": 1.68},{"text": "♪ We're no strangers to love ♪", "start": 18.64, "duration": 3.0}],"non_timestamped": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules and so do I ♪ ...","srt": "1\n00:00:01,360 --> 00:00:03,040\n[♪♪♪]\n\n2\n...","vtt": null,"available_transcripts": [{"language": "English", "language_code": "en", "is_generated": false, "is_translatable": true}],"status": "ok","success": true,"error": null,"error_type": null,"timestamp": "2026-11-08T09:36:51+00:00"}
A video without a usable transcript keeps the same fields, with status: "skipped" (or "error"), success: false,
error_type and error saying why, and available_transcripts listing what YouTube does offer, so a second run with the
right languages gets it:
status | error_type | Meaning | Charged |
|---|---|---|---|
skipped | TranscriptsDisabled | YouTube lists no caption track (Shorts without captions, ongoing live streams, music without lyrics) | no |
skipped | NoTranscriptFound | tracks exist, none in your languages / transcriptType; see available_transcripts | no |
skipped | VideoUnavailable, AgeRestricted | private, removed, blocked in the US, or sign-in required | no |
error | PoTokenRequired, BotCheck, RateLimited, RequestFailed | YouTube refused this request; try again later | no |
source names the channel or playlist entry a video came from (null for a video given directly).
Input
| Field | Type | Default | What it does |
|---|---|---|---|
videoUrls | array or string | 2 example videos | Video URLs (watch, youtu.be, Shorts, live, embed), bare 11-character IDs, channel URLs or @handles (Videos tab, newest first), playlist URLs. A string is split on commas and new lines. Aliases merged: videoUrl, urls, startUrls, youtube_url, videoIds, channel, playlist. |
languages | array | [] | ISO 639-1 codes in order of preference ("en", "fr", "pt-BR"). First available wins, manual before auto-generated. Empty: the video's own language. |
transcriptType | any / manual / generated | any | Which caption tracks to consider. |
translateTo | string | — | ISO code of YouTube's machine translation of the chosen track. Best effort: YouTube refused every translation in our tests (HTTP 429, see Limits); the original track is then returned with translation_error set. |
outputFormats | array of json, text, srt, vtt | ["json", "text"] | json fills timestamped, text fills non_timestamped, srt and vtt fill the subtitle strings. |
includeMetadata | boolean | true | Title, channel, duration, views, thumbnail: free, from the same YouTube response. |
maxVideosPerSource | integer | 100 | Videos listed per channel (newest first) or playlist, up to 5,000. |
maxVideos | integer | 1,000 | Unique videos per run, over all sources. |
datasetId | dataset | — | Transcribe the videos listed in another Actor's dataset (a channel or search scraper). The URL or ID is read from urlField, else found among url, videoUrl, video_url, youtube_url, videoId, video_id, link, id. |
urlField | string | — | Dotted path of the video URL inside each dataset item ("video.url"). |
When any alias, channel, playlist or datasetId is given, the two example videos of videoUrls are dropped: you never
pay for them by accident.
{"videoUrls": ["https://www.youtube.com/watch?v=UF8uR6Z6KLc", "@veritasium", "https://www.youtube.com/playlist?list=PL8dPuuaLjXtNlUrzyH5r6jN9ulIgZBpdo"],"maxVideosPerSource": 20,"languages": ["en", "fr"],"outputFormats": ["json", "text", "srt"]}
Pricing
- Transcript fetched — per transcript saved, whatever the video length: a five-hour lecture costs the same as a Short. The price depends on your Apify plan: $0.001 on the free plan ($1 per 1,000), $0.0015 on Starter, $0.0012 on Scale, $0.001 on Business and above — the store page shows yours.
- Actor start — $0.00005 per run (Apify's standard start event).
- Skipped videos (no captions, unavailable, age-restricted) and failed requests: free. The platform's usage (compute, proxies, storage) is included; nothing else is charged.
| Plan | Per transcript | Per 1,000 |
|---|---|---|
| Free | $0.001 | $1.00 |
| Starter | $0.0015 | $1.50 |
| Scale | $0.0012 | $1.20 |
| Business and above | $0.001 | $1.00 |
Set a maximum cost per run in Apify and the Actor stops cleanly when it is reached: it transcribes as many videos as the budget allows, in input order, and says so in the run's status.
Via API, Python, n8n, Make or MCP
- API:
POST https://api.apify.com/v2/acts/sherwood~youtube-transcript-batch/run-sync-get-dataset-items?token=...with the input as JSON body returns the items when the run ends (a few seconds for a handful of videos). - Python:
ApifyClient(token).actor("sherwood/youtube-transcript-batch").call(run_input={...}), thenclient.dataset(run["defaultDatasetId"]).list_items().items. - n8n / Make: the Apify node, Actor
sherwood/youtube-transcript-batch, input as above; read the dataset items in the next node. Give the node 512 MB or more. - MCP (Claude, Cursor, ChatGPT...): connect
https://mcp.apify.com, then ask for the transcript of a video, a channel's last 20 videos or a playlist: the agent fillsvideoUrlsand reads the items. - Chaining: run a YouTube channel or search scraper first, then this Actor with its
datasetId(an integration on the first Actor's run does it automatically).
Use it from an AI coding agent
Install the task skill for Claude Code, Codex, Cursor, Gemini CLI or any agent that reads the Agent Skills format:
$npx skills add maxouf/sherwood-skills --skill youtube-transcript
The skill compares this Actor with the other tools for the task, estimates the cost before running, caps the spend and hands back the result as a file. The pipeline skill apify-competitor-watch chains it with the other Actors of the use case. Source: github.com/maxouf/sherwood-skills.
Run it on a schedule
Channels keep publishing. Create a schedule on this Actor, or on a saved task
holding your channel and language settings — Apify's one-minute video shows how: Schedule your Actor.
With a channel URL and maxVideosPerSource set to the number of videos published between two runs, each run transcribes
the newest videos; deduplicate on video_id in your destination. To run it automatically after a channel or search
scraper instead, use the Integrations tab with datasetId (video: Actor-to-Actor integration).
Limits
- Transcripts come from YouTube's own caption tracks (manual or auto-generated). A video without any track is
skipped: no speech-to-text is run. - YouTube serves caption lists to mobile clients without the proof-of-origin token it demands from browsers; a video for
which it demands one anyway (
exp=xpe) is returned aserror: PoTokenRequired. If YouTube extends that requirement, the Actor will need an update: checkstatusanderror_typein your workflow rather than assuming success. - Machine translation (
translateTo) is rate-limited by YouTube per IP: on 2026-11-08 it refused every translation we asked for (HTTP 429), from datacenter and residential IPs alike. The original track is returned,translated_tostaysnullandtranslation_errorexplains. Count on it as a bonus, not as a feature; a translation step in your own workflow (an LLM onnon_timestamped) is the reliable path. - Videos blocked in the United States, private, removed or age-restricted are
skippedwith YouTube's reason. - Channel listing reads the Videos tab (uploads, newest first), not Shorts or live tabs; use playlist URLs for those.
- Items are capped by Apify at 9 MB: for a very long video (tens of hours) the subtitle strings and then the segments are
left out, with
non_timestampedkept.
Related Actors
- Text to Speech API — the other way round: turn text (a transcript, a summary) into audio with subtitles.
- Review Analyzer — AI verdicts on any dataset of texts, transcripts included, through
datasetId. - Google Maps Scraper — places and leads, in the fields of the most used Maps scraper.
- YouTube Scraper and YouTube Channel Scraper — two common sources of video URLs to feed in through
datasetId.
FAQ
Which language do I get when languages is empty? The video's own caption track: the first manual one, else the
first auto-generated one. language_code and is_generated say which.
Can I get all languages of one video? One run per language today; available_transcripts lists them.
Is a channel limited? maxVideosPerSource (default 100, up to 5,000) and maxVideos (default 1,000) cap it; the
Videos tab is read newest first.
Why is a Short skipped? Most Shorts have no caption track at all; error_type: TranscriptsDisabled means YouTube
lists none.
Do you store my transcripts? Only in your run's dataset, under Apify's retention for your plan.
How many videos per run? Up to maxVideos (default 1,000, up to 100,000); 8 videos are processed at once at the
default 512 MB, more with more memory. A 1,000-video channel takes a few minutes.
What does a run cost me? One transcript-fetched event per saved transcript ($0.001 to $0.0015 depending on your plan)
plus the $0.00005 start event. 1,000 videos on the free plan: about $1.00. Videos without captions cost nothing.
Is it an MCP server? It is callable through Apify's MCP server (https://mcp.apify.com) like every Actor of the store:
an agent passes videoUrls and reads the items back, no extra setup.