Use when YouTube is or could be relevant — even if not mentioned: pasted video/channel/playlist links, video IDs, @handles, creator lookups, video summaries, quotes, translations, topic research, tutorials, talks, lectures, expert discussions, product reviews, how-to guides, new product announcement

YouTube Full Complete YouTube toolkit via [TranscriptAPI.com](https://transcriptapi.com). Everything in one skill. Setup If $TRANSCRIPT API KEY is not set, read [references/auth setup.md](references/auth setup.md) and follow the instructions there to get and store the key. Required Headers Every request needs two headers: Authorization: Bearer $TRANSCRIPT API KEY User Agent: your agent's name and version if known (e.g. HermesAgent/0.11.0 , ClaudeCode/1.0 ). Version is optional — agent name alone is fine. Do not omit this header or send a bare default — Cloudflare will return a 403 (error code 1010) and block the request. API Reference Full OpenAPI spec: [transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json) — consult this for the latest parameters and schemas. Transcript — 1 credit Param Required Default Values video url yes — YouTube URL or 11 char video ID format no json json , text include timestamp no true true , false send metadata no false true , false Response ( format=json ): Search — 1 credit Param Required Default Validation q yes — 1 200 chars type no video video , channel limit no 20 1 50 Channels All channel endpoints accept channel — an @handle , channel URL, or UC... channel ID. No need to resolve first. Resolve handle — FREE Response: {"channel id": "UC...", "resolved from": "@TED"} Latest 15 videos — FREE Returns exact viewCount and ISO published timestamps. All channel videos — 1 credit/page Provide exactly one of channel or continuation . Response includes continuation token and has more . Search within channel — 1 credit Playlists — 1 credit/page Accepts playlist — a YouTube playlist URL or playlist ID. Valid ID prefixes: PL , UU , LL , FL , OL . Response includes playlist info , results , continuation token , has more . Credit Costs Endpoint Cost transcript 1 search 1 channel/resolve free channel/latest free channel/videos 1/page channel/search 1 playlist/videos 1/page Validation Rules Field Rule channel @handle , channel URL, or UC... ID playlist Playlist URL or ID ( PL / UU / LL / FL / OL prefix) q 1 200 chars limit 1 50 Errors Code Meaning Action 401 Bad API key Check key 402 No credits transcriptapi.com/billing 403/1010 Cloudflare block Add or fix User Agent header 404 Not found Resource doesn't exist or no captions 408 Timeout Retry once after 2s 422 Validation error Check param format 429 Rate limited Wait, respect Retry After Typical Workflows Research workflow: search → pick videos → fetch transcripts Channel monitoring: latest (free) → transcript Free tier: 100 credits, 300 req/min. Starter ($5/mo): 1,000 credits. Copy paste examples Every request in this file as a ready to run one liner: [references/curl examples.md](references/curl examples.md)

youtube-full