youtube-transcript
/youtube-transcript
Get the transcript (captions, subtitles) of YouTube videos, Shorts, whole channels or playlists as text, timed segments, SRT or VTT, with language, auto-generated flag and video metadata. Use when the user asks for a YouTube transcript, to summarise or quote a video, to cite timestamps, or to load a channel into RAG, and especially when youtube-transcript-api raises RequestBlocked or IpBlocked, yt-dlp is asked to sign in, or a local fetch from a cloud server is blocked. Runs an Arcadium Data actor on Apify with the user's own APIFY_TOKEN (pay per transcript).
- Author
- arcadiumdata ↗
- Repository
- skills ↗
- Licence
- MIT
- Last repository change
- 03.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 1
- URLs in SKILL.md
- 6
No signals detected. Repository changed on 03.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
What it does and when to use it
Get the transcript (captions, subtitles) of YouTube videos, Shorts, whole channels or playlists as text, timed segments, SRT or VTT, with language, auto-generated flag and video metadata. Use when the user asks for a YouTube transcript, to summarise or quote a video, to cite timestamps, or to load a channel into RAG, and especially when youtube-transcript-api raises RequestBlocked or IpBlocked, yt-dlp is asked to sign in, or a local fetch from a cloud server is blocked. Runs an Arcadium Data actor on Apify with the user's own APIFY_TOKEN (pay per transcript).
Original author description
Get the transcript (captions, subtitles) of YouTube videos, Shorts, whole channels or playlists as text, timed segments, SRT or VTT, with language, auto-generated flag and video metadata. Use when the user asks for a YouTube transcript, to summarise or quote a video, to cite timestamps, or to load a channel into RAG, and especially when youtube-transcript-api raises RequestBlocked or IpBlocked, yt-dlp is asked to sign in, or a local fetch from a cloud server is blocked. Runs an Arcadium Data actor on Apify with the user's own APIFY_TOKEN (pay per transcript).
How it works
- When to use it
- Prerequisites
- Cost
- Workflow
- MCP instead of the CLI
- Troubleshooting
SKILL.md preview
---
name: youtube-transcript
description: Get the transcript (captions, subtitles) of YouTube videos, Shorts, whole channels or playlists as text, timed segments, SRT or VTT, with language, auto-generated flag and video metadata. Use when the user asks for a YouTube transcript, to summarise or quote a video, to cite timestamps, or to load a channel into RAG, and especially when youtube-transcript-api raises RequestBlocked or IpBlocked, yt-dlp is asked to sign in, or a local fetch from a cloud server is blocked. Runs an Arcadium Data actor on Apify with the user's own APIFY_TOKEN (pay per transcript).
license: MIT
metadata:
author: Arcadium Data
author_url: https://arcadiumdata.io
category: content
keywords: "youtube transcript, youtube captions, youtube subtitles, srt, vtt, youtube-transcript-api, RequestBlocked, video summary, timestamps, channel transcripts"
apify-actors: "arcadium/youtube-transcripts"
---
# YouTube transcript
Transcripts of YouTube videos, fetched in the Apify cloud and returned as one JSON row per video.
**Disclosure:** the actor this skill runs is built and sold by Arcadium Data, the author of this skill. You pay Apify per transcript delivered (see Cost). No affiliate codes are used.
## When to use it
- The user gives one or more YouTube links or video IDs and wants the text, a summary, quotes or timestamps.
- The user wants the transcripts of a channel or playlist (newest first, optional date range).
- A local tool fails: `youtube-transcript-api` raises `RequestBlocked` or `IpBlocked` (YouTube blocks most cloud-provider IPs, as that library's README explains), or `yt-dlp` asks to sign in to confirm you are not a bot. If a local tool works for the user, it is fine to keep using it; this skill is for when it does not.
Out of scope:
- Videos without captions: the actor does not download or transcribe audio.
- Age-restricted and members-only videos (they need a signed-in account; the actor never logs in).
- Comments, video or audio downloads. For a broad topic search across many videos, use the `youtube-transcript-research` skill.
## Prerequisites
- Apify account and `APIFY_TOKEN`, or `apify login`. Apify CLI (`npm i -g apify-cli`) or the Apify MCP server (`https://mcp.apify.com`).
## Cost
Free Apify plan prices; paid plans pay less. Videos without captions, private, age-restricted or missing videos, repeats and error rows are free.
| Actor | Charged event | Free plan | Start fee per run |
| --- | --- | --- | --- |
| `arcadium/youtube-transcripts` | `transcript` | $2.48 per 1,000 | $0.001 |
Worked example: 10 videos in one run = 10 x $0.00248 + $0.001 = **about $0.026**.
## Workflow
### 1. Build the input
<!-- input: youtube-transcripts -->
```json
{
"urls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
"languages": ["en"],
"includeSegments": true
}
```
- `urls`: video links, `youtu.be` links, Shorts links, bare video IDs (`dQw4w9WgXcQ`), channel URLs (`https://www.youtube.com/@kurzgesagt`) or playlist URLs. Put every video in one run (one start fee).
- Channels and playlists: add `maxVideosPerSource` (for example 20) and optionally `publishedAfter` / `publishedBefore` (`YYYY-MM-DD`).
- `languages`: in order of preference; `en` also matches `en-US` and `en-GB`. If none exists, the original spoken language is returned and `languageMatched` is `false`.
- `captionType`: `any` (default, creator captions first), `manual` or `auto`.
- `subtitleFormat`: `srt` or `vtt` adds a ready subtitle file to each row.
- `includeSegments: false` when only the plain text is needed (smaller output).
From youtube-transcript-api: `YouTubeTranscriptApi().fetch(video_id, languages=["de", "en"])` maps to `{"urls": [video_id], "languages": ["de", "en"]}`. The segments use the same `text`, `start` and `duration` fields.
### 2. Run it
apify actors call arcadium/youtube-transcripts --input-file transcripts.json --user-agent arcadium-skills/youtube-transcript --json 2>/dev/null
apify datasets get-items DATASET_ID --format json --user-agent arcadium-skills/youtube-transcript 2>/dev/null > transcripts.out.json
(`DATASET_ID` is `.defaultDatasetId` from the call output.) Without the CLI, one HTTP call returns the rows: `POST https://api.apify.com/v2/acts/arcadium~youtube-transcripts/run-sync-get-dataset-items` with header `Authorization: Bearer $APIFY_TOKEN` and the input as the JSON body. In Python: `ApifyClient(token).actor("arcadium/youtube-transcripts").call(run_input=...)`, then iterate `client.dataset(run.default_dataset_id).iterate_items()` (apify-client 3.x).
### 3. Read the rows
Filter on `rowType` first.
- `transcript` rows: `videoId`, `url`, `title`, `channelName`, `publishDate`, `durationSeconds`, `viewCount`, `transcript` (full text), `segments` (`start`, `duration` in seconds, `text`), `wordCount`, `language`, `isAutoGenerated`, `languageMatched`, `availableLanguages`, and `srt` / `vtt` when asked.
- `error` rows (free): `code` and `message`, plus the `input` they are about.
For a summary or quotes, cite timestamps as `<url>&t=<start>s` using the `start` of the segment (rounded down). Quote the text exactly and say when captions are auto-generated (`isAutoGenerated: true`): they have no punctuation and names or numbers may be misheard. For long transcripts, use `wordCount` to decide whether to summarise in chunks.
## MCP instead of the CLI
With the Apify MCP server connected, call `arcadium/youtube-transcripts` with the same input. To expose only this actor as a tool: `https://mcp.apify.com/?tools=arcadium/youtube-transcripts`.
## Troubleshooting
- `no_match`: the video has no captions (or none of the requested `captionType`). Nothing to retry.
- `not_found`: private, removed or unknown video or channel.
- `unavailable`: age-restricted, members-only, not yet published, or a temporary error; retry later only for the temporary case.
- `blocked`: YouTube still refused after all retries; run again later.
- `languageMatched: false`: the requested language does not exist; check `availableLanguages`. `translateTo` returns a native track in that language only when the video has one, because YouTube currently refuses its machine translation to anonymous clients (`translationStatus: "unavailable"`); translate the text yourself in that case.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · arcadiumdata/skills | 100 | MIT |
| tubeagentkit/youtube-transcript-skills | 100 | MIT |
| davepoon/buildwithclaude | 100 | MIT |
| silvio-l/skills | 100 | MIT |
| mthines/agent-skills | 100 | MIT |
| glebis/claude-skills | 100 | MIT |
| maxouf/sherwood-skills | 100 | MIT |
| mkurman/zorai | 100 | MIT |
| qa-aman/claude-skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version 1f1f89782d79 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100youtube-research
Pulls structured YouTube data — video and channel details, transcripts/captions, comments, playlists, and search — via the Crawlora API as clean JSON, with no yt-dlp or HTML scraping. Use when the user provides a YouTube URL or asks for a transcript, comments, channel/video… - 100youtube-transcription
Transcribe YouTube videos to text using OpenAI Whisper and yt-dlp. Use when the user wants to get a transcript from a YouTube video, generate subtitles, convert video speech to text, create SRT/VTT captions, or extract spoken content from YouTube URLs. - 100youtube-transcript-research
Research a topic from YouTube videos - search YouTube or list a channel, pull full transcripts with timestamps, and write a cited summary of what the videos claim, where they agree and disagree, with links that jump to the exact second. Use when the user asks what YouTubers say… - 100ytapi-youtube-transcript
Get the transcript, subtitles or captions of a YouTube video (plain text, Markdown, timestamped JSON, SRT or VTT, any language) through the YTAPI API. Use when the user shares a YouTube link or video ID and wants what was said: to read, summarize, quote, translate or search it.… - 100yt-transcript
Fetch transcripts from YouTube videos. Use when user asks to get, download, extract, or retrieve YouTube video transcripts, captions, or subtitles. Also activates for video content analysis, summarizing YouTube videos, or processing video content. - 100youtube-full
Use when the user needs YouTube transcripts, video search, channel browsing, playlist extraction, or content monitoring. Trigger phrases: 'get the transcript for', 'search YouTube for', 'what are the latest videos on', 'list this playlist', 'monitor this channel', or any request…