{"id":"9d9518ae-fd4e-446b-831f-57d2257f43c7","shortId":"LfEnZp","kind":"skill","title":"youtube-data","tagline":"Use when structured YouTube data is needed: pasted video/channel/playlist links, transcripts for analysis, video metadata, channel upload history, search results, or playlist contents — without Google API quotas or OAuth. Triggers on YouTube URLs, creator names, topic research, o","description":"# YouTube Data\n\nYouTube data access via [TranscriptAPI.com](https://transcriptapi.com) — lightweight alternative to Google's YouTube Data API.\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## API Reference\n\nFull OpenAPI spec: [transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json) — consult this for the latest parameters and schemas.\n\n## Video Data (transcript + metadata) — 1 credit\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/transcript\\\n?video_url=VIDEO_URL&format=json&include_timestamp=true&send_metadata=true\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n**Response:**\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  ],\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## Search Data — 1 credit\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n**Video result fields:** `videoId`, `title`, `channelId`, `channelTitle`, `channelHandle`, `channelVerified`, `lengthText`, `viewCountText`, `publishedTimeText`, `hasCaptions`, `thumbnails`\n\n**Channel result fields** (`type=channel`): `channelId`, `title`, `handle`, `url`, `description`, `subscriberCount`, `verified`, `rssUrl`, `thumbnails`\n\n## Channel Data\n\nChannel endpoints accept `channel` — an `@handle`, channel URL, or `UC...` ID. No need to resolve first.\n\n**Resolve handle to ID (free):**\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nReturns: `{\"channel_id\": \"UCsT0YIqwnpJCM-mx7-gSA4Q\", \"resolved_from\": \"@TED\"}`\n\n**Latest 15 videos with exact stats (free):**\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nReturns: `channel` info, `results` array with `videoId`, `title`, `published` (ISO), `viewCount` (exact number), `description`, `thumbnail`\n\n**All channel videos (paginated, 1 credit/page):**\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nReturns 100 videos per page + `continuation_token` for pagination.\n\n**Search within channel (1 credit):**\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/search\\\n?channel=@TED&q=QUERY&limit=30\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n## Playlist Data — 1 credit/page\n\nAccepts `playlist` — a YouTube playlist URL or playlist ID.\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nReturns: `results` (videos), `playlist_info` (`title`, `numVideos`, `ownerName`, `viewCount`), `continuation_token`, `has_more`\n\n## Credit Costs\n\n| Endpoint        | Cost     | Data returned              |\n| --------------- | -------- | -------------------------- |\n| transcript      | 1        | Full transcript + metadata |\n| search          | 1        | Video/channel details      |\n| channel/resolve | **free** | Channel ID mapping         |\n| channel/latest  | **free** | 15 videos + exact stats    |\n| channel/videos  | 1/page   | 100 videos per page        |\n| channel/search  | 1        | Videos matching query      |\n| playlist/videos | 1/page   | 100 videos per page        |\n\n## Errors\n\n| Code     | Meaning          | Action                                         |\n| -------- | ---------------- | ---------------------------------------------- |\n| 401      | Bad API key      | Check key                                      |\n| 402      | No credits       | transcriptapi.com/billing                      |\n| 403/1010 | Cloudflare block | Add or fix User-Agent header                   |\n| 404      | Not found        | Resource doesn't exist                         |\n| 408      | Timeout          | Retry once                                     |\n| 422      | Validation error | Check param format                             |\n\nFree tier: 100 credits, 300 req/min.","tags":["youtube","data","skills","zeropointrepo","agent-skills","clawdbot","hermes-agent","openclaw","youtube-search","youtube-transcript"],"capabilities":["skill","source-zeropointrepo","skill-youtube-data","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/youtube-data","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 (5,091 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.933Z","embedding":null,"createdAt":"2026-04-18T22:11:54.493Z","updatedAt":"2026-05-02T12:54:56.933Z","lastSeenAt":"2026-05-02T12:54:56.933Z","tsv":"'/@rickastley':223 '/api/v2/youtube/channel/latest?channel=@ted':340 '/api/v2/youtube/channel/resolve?input=@ted':306 '/api/v2/youtube/channel/search':409 '/api/v2/youtube/channel/videos?channel=@nasa':378 '/api/v2/youtube/playlist/videos?playlist=pl_id':445 '/api/v2/youtube/search?q=query&type=video&limit=20':238 '/api/v2/youtube/transcript':163 '/billing':528 '/openapi.json](https://transcriptapi.com/openapi.json)':143 '/vi/dqw4w9wgxcq/maxresdefault.jpg':228 '1':156,231,371,402,429,477,482,503 '1/page':497,508 '100':391,498,509,558 '1010':131 '15':329,492 '18.0':203 '3.5':205 '30':415 '300':560 '401':517 '402':523 '403':128 '403/1010':529 '404':539 '408':546 '422':550 'accept':282,431 'access':46 'action':516 'add':532 'agent':94,96,109,185,248,316,350,388,425,455,537 'alon':111 'altern':51 'analysi':16 'api':29,57,61,90,136,180,243,311,345,383,420,450,519 'array':356 'astley':209,218 'author':87,177,215,219,240,308,342,380,417,447 'bad':518 'bare':122 'bash':158,233,301,335,373,404,440 'bearer':88,178,241,309,343,381,418,448 'block':133,531 'channel':19,264,268,278,280,283,286,319,353,368,401,410,487 'channel/latest':490 'channel/resolve':485 'channel/search':502 'channel/videos':496 'channelhandl':257 'channelid':255,269 'channeltitl':256 'channelverifi':258 'check':521,553 'claudecode/1.0':105 'cloudflar':124,530 'code':130,514 'consult':144 'content':26 'continu':395,466 'cost':471,473 'creator':37 'credit':157,232,403,470,525,559 'credit/page':372,430 'curl':159,234,302,336,374,405,441 'data':3,8,43,45,56,153,230,279,428,474 'default':123 'descript':273,365 'detail':484 'doesn':543 'dqw4w9wgxcq':191 'durat':204 'e.g':103 'en':193 'endpoint':281,472 'error':129,513,552 'everi':82 'exact':332,363,494 'exist':545 'field':252,266 'fine':113 'first':295 'fix':534 'follow':70 'format':168,555 'found':541 'free':300,334,486,491,556 'full':138,478 'get':75 'give':212 'gonna':211 'googl':28,53 'gsa4q':324 'h':176,182,239,245,307,313,341,347,379,385,416,422,446,452 'handl':271,285,297 'hascapt':262 'header':81,86,118,538 'hermesagent/0.11.0':104 'histori':21 'i.ytimg.com':227 'i.ytimg.com/vi/dqw4w9wgxcq/maxresdefault.jpg':226 'id':190,290,299,320,439,488 'includ':170 'info':354,461 'instruct':72 'iso':361 'json':169,188 'key':62,79,91,181,244,312,346,384,421,451,520,522 'known':102 'languag':192 'latest':148,328 'lengthtext':259 'lightweight':50 'limit':414 'link':13 'love':201 'map':489 'match':505 'mean':515 'metadata':18,155,174,206,480 'mx7':323 'name':38,98,110,216 'need':10,84,292 'never':210 'number':364 'numvideo':463 'o':41 'oauth':32 'omit':116 'openapi':139 'option':108 'ownernam':464 'page':394,501,512 'pagin':370,398 'param':554 'paramet':149 'past':11 'per':393,500,511 'playlist':25,427,432,435,438,460 'playlist/videos':507 'publish':360 'publishedtimetext':261 'q':412 'queri':413,506 'quota':30 're':197 'read':66 'refer':137 'references/auth-setup.md':67,68 'req/min':561 'request':83,135 'requir':80 'research':40 'resolv':294,296,325 'resourc':542 'respons':187 'result':23,251,265,355,458 'retri':548 'return':126,318,352,390,457,475 'rick':208,217 'rssurl':276 'schema':151 'search':22,229,399,481 'send':120,173 'set':65 'setup':58 'skill' 'skill-youtube-data' 'source-zeropointrepo' 'spec':140 'start':202 'stat':333,495 'store':77 'stranger':199 'structur':6 'subscribercount':274 'ted':327,411 'text':195 'thumbnail':224,263,277,366 'tier':557 'timeout':547 'timestamp':171 'titl':207,254,270,359,462 'token':396,467 'topic':39 'topic-agent-skills' 'topic-clawdbot' 'topic-hermes-agent' 'topic-openclaw' 'topic-youtube-search' 'topic-youtube-transcript' 'transcript':14,60,89,154,179,194,242,310,344,382,419,449,476,479 'transcriptapi.com':48,49,142,162,237,305,339,377,408,444,527 'transcriptapi.com/api/v2/youtube/channel/latest?channel=@ted':338 'transcriptapi.com/api/v2/youtube/channel/resolve?input=@ted':304 'transcriptapi.com/api/v2/youtube/channel/search':407 'transcriptapi.com/api/v2/youtube/channel/videos?channel=@nasa':376 'transcriptapi.com/api/v2/youtube/playlist/videos?playlist=pl_id':443 'transcriptapi.com/api/v2/youtube/search?q=query&type=video&limit=20':236 'transcriptapi.com/api/v2/youtube/transcript':161 'transcriptapi.com/billing':526 'transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json)':141 'trigger':33 'true':172,175 'two':85 'type':267 'uc':289 'ucst0yiqwnpjcm':322 'ucst0yiqwnpjcm-mx7-gsa4q':321 'upload':20 'url':36,165,167,220,225,272,287,436 'use':4 'user':93,184,247,315,349,387,424,454,536 'user-ag':92,183,246,314,348,386,423,453,535 'valid':551 'verifi':275 'version':100,106 'via':47 'video':17,152,164,166,189,250,330,369,392,459,493,499,504,510 'video/channel':483 'video/channel/playlist':12 'videoid':253,358 'viewcount':362,465 'viewcounttext':260 'within':400 'without':27 'www.youtube.com':222 'www.youtube.com/@rickastley':221 'youragent/1.0':186,249,317,351,389,426,456 'youtub':2,7,35,42,44,55,434 'youtube-data':1","prices":[{"id":"d0d435e7-ab5d-4f71-a66b-96367a20deea","listingId":"9d9518ae-fd4e-446b-831f-57d2257f43c7","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:54.493Z"}],"sources":[{"listingId":"9d9518ae-fd4e-446b-831f-57d2257f43c7","source":"github","sourceId":"ZeroPointRepo/youtube-skills/youtube-data","sourceUrl":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/youtube-data","isPrimary":false,"firstSeenAt":"2026-04-18T22:11:54.493Z","lastSeenAt":"2026-05-02T12:54:56.933Z"}],"details":{"listingId":"9d9518ae-fd4e-446b-831f-57d2257f43c7","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ZeroPointRepo","slug":"youtube-data","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":"8888a1dece92e50f8d81d2650b6047bdb062acf2","skill_md_path":"skills/youtube-data/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/youtube-data"},"layout":"multi","source":"github","category":"youtube-skills","frontmatter":{"name":"youtube-data","description":"Use when structured YouTube data is needed: pasted video/channel/playlist links, transcripts for analysis, video metadata, channel upload history, search results, or playlist contents — without Google API quotas or OAuth. Triggers on YouTube URLs, creator names, topic research, or any request needing YouTube content, even if not mentioned explicitly. Not for uploads, account management, or written-source-only research.","compatibility":"Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed."},"skills_sh_url":"https://skills.sh/ZeroPointRepo/youtube-skills/youtube-data"},"updatedAt":"2026-05-02T12:54:56.933Z"}}