{"id":"364b0f4f-007d-4e26-bf2a-45b900d3d360","shortId":"sdhMy5","kind":"skill","title":"transcript","tagline":"Use when the spoken content of a YouTube video is needed — even if not explicitly requested: pasted video links or IDs, requests to summarize, quote, transcribe, translate, fact-check, or extract anything from a video. Also use for research or learning when a video is the source.","description":"# Transcript\n\nFetch video transcripts via [TranscriptAPI.com](https://transcriptapi.com).\n\n## Setup\n\nIf `$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.\n\n## Required Headers\n\nEvery request needs two headers:\n\n- **Authorization:** `Bearer $TRANSCRIPT_API_KEY`\n- **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.\n\n## GET /api/v2/youtube/transcript\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/transcript\\\n?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n| Param               | Required | Default | Values                          |\n| ------------------- | -------- | ------- | ------------------------------- |\n| `video_url`         | yes      | —       | YouTube URL or 11-char video ID |\n| `format`            | no       | `json`  | `json`, `text`                  |\n| `include_timestamp` | no       | `true`  | `true`, `false`                 |\n| `send_metadata`     | no       | `false` | `true`, `false`                 |\n\nAccepts: full URLs (`youtube.com/watch?v=ID`), short URLs (`youtu.be/ID`), shorts (`youtube.com/shorts/ID`), or bare video IDs.\n\n**Default:** Always use `format=text&include_timestamp=true&send_metadata=true` unless user specifies otherwise.\n\n**Response** (`format=json`):\n\n```json\n{\n  \"video_id\": \"dQw4w9WgXcQ\",\n  \"language\": \"en\",\n  \"transcript\": [\n    { \"text\": \"We're no strangers to love\", \"start\": 18.0, \"duration\": 3.5 },\n    { \"text\": \"You know the rules and so do I\", \"start\": 21.5, \"duration\": 2.8 }\n  ],\n  \"metadata\": {\n    \"title\": \"Rick Astley - Never Gonna Give You Up\",\n    \"author_name\": \"Rick Astley\",\n    \"author_url\": \"https://www.youtube.com/@RickAstley\",\n    \"thumbnail_url\": \"https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg\"\n  }\n}\n```\n\n**Response** (`format=text`):\n\n```json\n{\n  \"video_id\": \"dQw4w9WgXcQ\",\n  \"language\": \"en\",\n  \"transcript\": \"[00:00:18] We're no strangers to love\\n[00:00:21] You know the rules...\",\n  \"metadata\": {...}\n}\n```\n\n## Errors\n\n| Code     | Meaning          | Action                                         |\n| -------- | ---------------- | ---------------------------------------------- |\n| 401      | Bad API key      | Check key or re-setup                          |\n| 402      | No credits       | Top up at transcriptapi.com/billing            |\n| 403/1010 | Cloudflare block | Add or fix User-Agent header                   |\n| 404      | No transcript    | Video may not have captions enabled            |\n| 408      | Timeout          | Retry once after 2s                            |\n| 429      | Rate limited     | Wait and retry                                 |\n\n## Tips\n\n- For long videos, summarize key points first, offer full transcript on request.\n- Use `format=json` when you need precise timestamps for quoting specific moments.\n- Use `include_timestamp=false` for clean text suitable for translation or analysis.\n- 1 credit per successful request. Errors don't cost credits.\n- Free tier: 100 credits, 300 req/min.","tags":["transcript","youtube","skills","zeropointrepo","agent-skills","clawdbot","hermes-agent","openclaw","youtube-search","youtube-transcript"],"capabilities":["skill","source-zeropointrepo","skill-transcript","topic-agent-skills","topic-clawdbot","topic-hermes-agent","topic-openclaw","topic-youtube-search","topic-youtube-transcript"],"categories":["youtube-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/ZeroPointRepo/youtube-skills/transcript","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add ZeroPointRepo/youtube-skills","source_repo":"https://github.com/ZeroPointRepo/youtube-skills","install_from":"skills.sh"}},"qualityScore":"0.511","qualityRationale":"deterministic score 0.51 from registry signals: · indexed on github topic:agent-skills · 123 github stars · SKILL.md body (3,370 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T12:54:56.557Z","embedding":null,"createdAt":"2026-04-18T22:11:50.621Z","updatedAt":"2026-05-02T12:54:56.557Z","lastSeenAt":"2026-05-02T12:54:56.557Z","tsv":"'/@rickastley':282 '/api/v2/youtube/transcript':136,142 '/billing':338 '/id':207 '/shorts/id':211 '/vi/dqw4w9wgxcq/maxresdefault.jpg':287 '/watch?v=id':202 '00':298,299,308,309 '1':407 '100':419 '1010':130 '11':176 '18':300 '18.0':249 '2.8':264 '21':310 '21.5':262 '2s':363 '3.5':251 '300':421 '401':320 '402':330 '403':127 '403/1010':339 '404':349 '408':358 '429':364 'accept':197 'action':319 'add':342 'agent':93,95,108,164,347 'alon':110 'also':38 'alway':217 'analysi':406 'anyth':34 'api':60,89,159,322 'astley':268,277 'author':86,156,274,278 'bad':321 'bare':121,213 'bash':137 'bearer':87,157 'block':132,341 'caption':356 'char':177 'check':31,324 'claudecode/1.0':104 'clean':400 'cloudflar':123,340 'code':129,317 'content':6 'cost':415 'credit':332,408,416,420 'curl':138 'default':122,168,216 'dqw4w9wgxcq':237,294 'durat':250,263 'e.g':102 'en':239,296 'enabl':357 'error':128,316,412 'even':13 'everi':81 'explicit':16 'extract':33 'fact':30 'fact-check':29 'fals':190,194,196,398 'fetch':51 'fine':112 'first':377 'fix':344 'follow':69 'format':147,180,219,232,289,384 'free':417 'full':198,379 'get':74,135 'give':271 'gonna':270 'h':155,161 'header':80,85,117,348 'hermesagent/0.11.0':103 'i.ytimg.com':286 'i.ytimg.com/vi/dqw4w9wgxcq/maxresdefault.jpg':285 'id':22,179,215,236,293 'includ':149,185,221,396 'instruct':71 'json':182,183,233,234,291,385 'key':61,78,90,160,323,325,375 'know':254,312 'known':101 'languag':238,295 'learn':43 'limit':366 'link':20 'long':372 'love':247,306 'may':353 'mean':318 'metadata':153,192,225,265,315 'moment':394 'n':307 'name':97,109,275 'need':12,83,388 'never':269 'offer':378 'omit':115 'option':107 'otherwis':230 'param':166 'past':18 'per':409 'point':376 'precis':389 'quot':26,392 'rate':365 're':243,302,328 're-setup':327 'read':65 'references/auth-setup.md':66,67 'req/min':422 'request':17,23,82,134,382,411 'requir':79,167 'research':41 'respons':231,288 'retri':360,369 'return':125 'rick':267,276 'rule':256,314 'send':119,152,191,224 'set':64 'setup':57,329 'short':203,208 'skill' 'skill-transcript' 'sourc':49 'source-zeropointrepo' 'specif':393 'specifi':229 'spoken':5 'start':248,261 'store':76 'stranger':245,304 'success':410 'suitabl':402 'summar':25,374 'text':148,184,220,241,252,290,401 'thumbnail':283 'tier':418 'timeout':359 'timestamp':150,186,222,390,397 'tip':370 'titl':266 'top':333 'topic-agent-skills' 'topic-clawdbot' 'topic-hermes-agent' 'topic-openclaw' 'topic-youtube-search' 'topic-youtube-transcript' 'transcrib':27 'transcript':1,50,53,59,88,158,240,297,351,380 'transcriptapi.com':55,56,141,337 'transcriptapi.com/api/v2/youtube/transcript':140 'transcriptapi.com/billing':336 'translat':28,404 'true':151,154,188,189,195,223,226 'two':84 'unless':227 'url':144,146,171,174,199,204,279,284 'use':2,39,218,383,395 'user':92,163,228,346 'user-ag':91,162,345 'valu':169 'version':99,105 'via':54 'video':10,19,37,46,52,143,145,170,178,214,235,292,352,373 'wait':367 'www.youtube.com':281 'www.youtube.com/@rickastley':280 'yes':172 'youragent/1.0':165 'youtu.be':206 'youtu.be/id':205 'youtub':9,173 'youtube.com':201,210 'youtube.com/shorts/id':209 'youtube.com/watch?v=id':200","prices":[{"id":"1ec79161-421c-48df-880f-f7163c157da0","listingId":"364b0f4f-007d-4e26-bf2a-45b900d3d360","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"ZeroPointRepo","category":"youtube-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:11:50.621Z"}],"sources":[{"listingId":"364b0f4f-007d-4e26-bf2a-45b900d3d360","source":"github","sourceId":"ZeroPointRepo/youtube-skills/transcript","sourceUrl":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/transcript","isPrimary":false,"firstSeenAt":"2026-04-18T22:11:50.621Z","lastSeenAt":"2026-05-02T12:54:56.557Z"}],"details":{"listingId":"364b0f4f-007d-4e26-bf2a-45b900d3d360","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ZeroPointRepo","slug":"transcript","github":{"repo":"ZeroPointRepo/youtube-skills","stars":123,"topics":["agent-skills","clawdbot","hermes-agent","openclaw","youtube-search","youtube-transcript"],"license":"mit","html_url":"https://github.com/ZeroPointRepo/youtube-skills","pushed_at":"2026-04-29T18:46:05Z","description":"YouTube Transcript API skills for AI agents. Get transcripts, search videos, browse channels. Works with OpenClaw, Hermes-Agent, Claude Code, Cursor, Windsurf.","skill_md_sha":"e292d3025e2cd0c7ea28dec5033d3fe888e64ff0","skill_md_path":"skills/transcript/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/transcript"},"layout":"multi","source":"github","category":"youtube-skills","frontmatter":{"name":"transcript","description":"Use when the spoken content of a YouTube video is needed — even if not explicitly requested: pasted video links or IDs, requests to summarize, quote, transcribe, translate, fact-check, or extract anything from a video. Also use for research or learning when a video is the source. Not for uploads or account management.","compatibility":"Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed."},"skills_sh_url":"https://skills.sh/ZeroPointRepo/youtube-skills/transcript"},"updatedAt":"2026-05-02T12:54:56.557Z"}}