Agent skill

YouTube Data via TranscriptAPI

by ZeroPointRepo in ZeroPointRepo/youtube-skills

Fetches YouTube transcripts, video metadata, channel info, search results and playlists through the TranscriptAPI.com service, with no Google API quota or OAuth setup.

MITAuto-check passedKnowledge Management

Install YouTube Data via TranscriptAPI

skills CLI
$ npx skills add ZeroPointRepo/youtube-skills --skill youtube-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZeroPointRepo/youtube-skills youtube-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZeroPointRepo/youtube-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/youtube-api .claude/skills/youtube-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-api
GitHub stars
1k
Used in
1 other repo
Token cost
~2.3k tokens
SKILL.md length
549 words
Files
3 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Fetches YouTube transcripts, video metadata, channel info, search results and playlists through the TranscriptAPI.com service, with no Google API quota or OAuth setup.

  • Getting the transcript of a YouTube video from a pasted link
  • SKILL.md covers Setup, Required Headers, API Reference and Endpoint Reference, plus 5 more sections
  • Reaches transcriptapi.com; needs TRANSCRIPT_API_KEY
  • Browsing a creator's latest uploads or playlists by @handle

What it does

Requests go to TranscriptAPI.com under `https://transcriptapi.com/api/v2/youtube/` and need an API key in `TRANSCRIPT_API_KEY`; if it is not set, the agent follows `references/auth-setup.md` to obtain and store one. Every call carries a bearer Authorization header and a User-Agent naming the agent, and leaving the User-Agent out gets the request blocked by Cloudflare with a 403.

The endpoint table covers video info, metadata and transcripts, search, and channel lookups for info, latest uploads, videos, playlists, posts and sections, plus playlist contents. A few lookups such as basic video info, channel resolution and latest uploads are free, while the others cost one unit per call or per page. Search accepts video, playlist and movie types with filters, channel videos can be limited to videos, shorts or streams, and the older `/video/info` path is deprecated in favor of `/video/metadata`. It is not for uploads, account management or research that needs only written sources. Reference files hold auth setup and curl examples.

When your agent uses it

  • Getting the transcript of a YouTube video from a pasted link
  • Browsing a creator's latest uploads or playlists by @handle
  • Searching YouTube for videos on a topic you are researching
  • Summarizing a video without setting up Google API credentials

Example prompts

  • “Get the transcript of this YouTube video and summarize the main points.”
  • “List the latest uploads from the @3blue1brown channel.”
  • “Search YouTube for recent talks on retrieval-augmented generation.”
  • “Fetch the metadata for this video and tell me when it was published.”

Requirements

  • A TranscriptAPI.com API key in TRANSCRIPT_API_KEY
  • Internet access to transcriptapi.com
  • Compatibility (from SKILL.md): Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.

What it can do on your machine

Read from SKILL.md and the folder at commit 4f7994b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are http).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • transcriptapi.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TRANSCRIPT_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.

    From compatibility in the SKILL.md frontmatter.

Context cost

YouTube Data via TranscriptAPI loads about 2.3k tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 549 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZeroPointRepo/youtube-skills at commit 4f7994b, republished under its MIT licence (© ZeroPointRepo). 549 words, ~2,294 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-api/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
youtube-api
description
Use when YouTube data is needed without Google API quotas or OAuth setup: transcripts, video metadata, channel info, search results, playlists. Triggers on pasted YouTube links, creator names, @handles, topic research, video summaries, channel browsing, or any request where YouTube content would help — 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.
version
1.6.2
user-invocable
true

YouTube API

YouTube data access via TranscriptAPI.com — no Google API quota needed.

Setup

If $TRANSCRIPT_API_KEY is not set, read 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 — consult this for the latest parameters and schemas.

Endpoint Reference

All endpoints: https://transcriptapi.com/api/v2/youtube/...

Channel endpoints accept channel — an @handle, channel URL, or UC... ID. Playlist endpoints accept playlist — a playlist URL or ID.

EndpointMethodCost
/info?video_url=IDGETfree
/video/metadata?video_url=IDGET1
/transcript?video_url=IDGET1
/search?q=QUERY&type=videoGET1
/channel/resolve?input=@handleGETfree
/channel/info?channel=@handleGET1
/channel/latest?channel=@handleGETfree
/channel/videos?channel=@handleGET1/page
/channel/search?channel=@handle&q=QGET1
/channel/playlists?channel=@handleGET1/page
/channel/posts?channel=@handleGET1/page
/channel/sections?channel=@handleGET1
/playlist/videos?playlist=PL_IDGET1/page

search also takes type=playlist or type=movie, plus first-page-only filters sort (relevance/views), upload_date, duration, and features. channel/videos takes tab=videos (default), shorts, or streams, plus an optional sort (latest/popular/oldest).

Naming: /video/metadata was previously /video/info. The old path still works but is deprecated — use /video/metadata.

Quick Examples

Search videos:

http
GET https://transcriptapi.com/api/v2/youtube/search?q=python+tutorial&type=video&limit=10
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Get transcript:

http
GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=dQw4w9WgXcQ&format=text&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Check video info & transcript languages (free, before spending a credit):

http
GET https://transcriptapi.com/api/v2/youtube/info?video_url=dQw4w9WgXcQ
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Get rich video metadata (views, likes, description, tags):

http
GET https://transcriptapi.com/api/v2/youtube/video/metadata?video_url=dQw4w9WgXcQ&include=details
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Get a channel's profile (subscriber count, tags, tabs):

http
GET https://transcriptapi.com/api/v2/youtube/channel/info?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Also available with the same channel parameter: /channel/playlists (a channel's playlists), /channel/posts (community tab), and /channel/sections (its curated Home-page shelves).

Resolve channel handle (free):

http
GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Latest videos (free):

http
GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Browse channel uploads (paginated):

http
GET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# Most-viewed first (channel Videos tab, ~30 per page)
GET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&sort=popular
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

# Use continuation token from response for next pages, repeating the same tab and sort

Sorting. Add sort=latest, popular, or oldest to channel/videos to get a channel's videos in the order you want, for example its most-popular uploads first. A sorted page returns about 30 videos (an unsorted page returns about 100), and every page costs the same 1 credit.

When paging, send the same sort on each request.

Item fields. Every item carries members_only, true only when YouTube badges it "Members only", and those items have no viewCountText. tab=streams items carry lengthText and publishedTimeText (for example Streamed 2 years ago); tab=shorts returns null for both, because YouTube's Shorts grid publishes neither. On the channel-tab feeds (tab=videos with sort, tab=shorts, tab=streams) channelId, channelTitle, channelHandle and index are null.

Browse playlist (paginated):

http
GET https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
Show full SKILL.md (165 more words)Show less

Parameter Validation

FieldRule
channel@handle, channel URL, or UC... ID
playlistPlaylist URL or ID (PL/UU/LL/FL/OL prefix)
q (search)1-200 chars
type (search)video (default), channel, playlist, movie
tab (channel/videos)videos (default), shorts, streams
sort (channel/videos)latest, popular, oldest (omit for the uploads feed)
tab (channel/sections)featured (default), podcasts, releases
include (video/metadata)details, related (comma-separated)
limit1-50
continuationnon-empty string

Why Not Google's API?

Google YouTube Data APITranscriptAPI
Quota10,000 units/day (100 searches)Credit-based, no daily cap
SetupOAuth + API key + projectSingle API key
TranscriptsNot availableCore feature
Pricing$0.0015/unit overage$5/1000 credits

Errors

CodeMeaningAction
401Bad API keyCheck key
402No creditstranscriptapi.com/billing
403/1010Cloudflare blockAdd or fix User-Agent header
404Not foundResource doesn't exist
408Timeout/retryableRetry once after 2s
422Validation errorCheck param format
429Rate limitedWait, respect Retry-After

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

© ZeroPointRepo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/youtube-api of ZeroPointRepo/youtube-skills.

  • SKILL.md
  • references/auth-setup.md
  • references/curl-examples.md

Open the folder on GitHubat commit 4f7994b

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ZeroPointRepo/youtube-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

YouTube Data via TranscriptAPI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

YouTube Data via TranscriptAPI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
YouTube Data via TranscriptAPI this skillZeroPointRepo/youtube-skills1k1 repos~2.3kAutomated safety check: PassMIT
Youtube Transcriptbadlogic/pi-skills2.6k1 repos~179Automated safety check: PassMIT
Video Lenskar2phi/video-lens113—~8.2kAutomated safety check: NotesMIT
Youtube Transcript Extractor API Skillbrowser-act/skills6.1k1 repos~1.2kAutomated safety check: PassMIT
YouTube Transcript ReformatterPrismer-AI/PrismerCloud1.6k2 repos~905Automated safety check: PassMIT
Video SummaryLeoYeAI/openclaw-master-skills2.2k—~4.2kAutomated safety check: PassMIT

Similar skills

  • Youtube Transcript

    badlogic/pi-skills

    Fetch transcripts from YouTube videos for summarization and analysis.

    2.6k GitHub starsUsed in 1 repo~179 tokens
    Knowledge ManagementAuto-check passed
  • Video Lens

    kar2phi/video-lens

    Fetch a YouTube transcript and generate an executive summary, key points, and timestamped topic list as a polished HTML report.

    113 GitHub stars~8.2k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check: notes
  • This skill helps users automatically extract YouTube video transcripts and metadata via the BrowserAct API.

    6.1k GitHub starsUsed in 1 repo~1.2k tokens
    Knowledge ManagementAuto-check passed
  • YouTube Transcript Reformatter

    Prismer-AI/PrismerCloud

    Fetches a YouTube transcript with a helper script and reshapes it into chapters, summaries, X threads, blog posts or timestamped quotes.

    1.6k GitHub starsUsed in 2 repos~905 tokens
    Knowledge ManagementAuto-check passed
  • Video Summary

    LeoYeAI/openclaw-master-skills

    Video summarization for Bilibili, Xiaohongshu, Douyin, and YouTube.

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Multi-Source to NotebookLM Processor

    joeseesun/qiaomu-anything-to-notebooklm

    Collects content from WeChat articles, web pages, YouTube, podcasts, documents and more, uploads it to NotebookLM and generates podcasts, slides or mind maps.

    6.2k GitHub stars~3.6k tokensUpdated 4 days ago
    Knowledge ManagementAuto-check passed

More from ZeroPointRepo/youtube-skills

All 12 skills in this repo
  • YouTube Captions Fetcher

    ZeroPointRepo/youtube-skills

    Fetches timestamped captions or plain-text transcripts for any YouTube video through the TranscriptAPI service, for reading, quoting, translating or accessibility.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • YouTube Subtitle Fetcher

    ZeroPointRepo/youtube-skills

    Fetches timestamped subtitles for any YouTube video through TranscriptAPI, as clean text for reading and translation or timed JSON.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • YouTube Transcript Fetcher

    ZeroPointRepo/youtube-skills

    Fetches the transcript of a YouTube video through TranscriptAPI.com so the agent can summarize, quote, translate or fact-check what was said.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • YouTube TranscriptAPI

    ZeroPointRepo/youtube-skills

    Pulls YouTube transcripts, searches videos and channels and browses playlists through the TranscriptAPI service with a single API key.

    1k GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • YouTube Video Transcript

    ZeroPointRepo/youtube-skills

    Fetches YouTube transcripts through TranscriptAPI.com so an agent can summarize, quote or translate a video from a link or ID.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • YouTube Channel Tools

    ZeroPointRepo/youtube-skills

    Browses YouTube channels through TranscriptAPI: resolves handles to channel IDs, lists recent uploads and pages through a channel's videos.

    1k GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed

Works with

Questions about YouTube Data via TranscriptAPI

What does YouTube Data via TranscriptAPI do?

Fetches YouTube transcripts, video metadata, channel info, search results and playlists through the TranscriptAPI.com service, with no Google API quota or OAuth setup. md` to obtain and store one. Every call carries a bearer Authorization header and a User-Agent naming the agent, and leaving the User-Agent out gets the request blocked by Cloudflare with a 403.

When should I use YouTube Data via TranscriptAPI?

YouTube Data via TranscriptAPI fits situations like: getting the transcript of a YouTube video from a pasted link; browsing a creator's latest uploads or playlists by @handle; searching YouTube for videos on a topic you are researching; summarizing a video without setting up Google API credentials.

How do I install YouTube Data via TranscriptAPI in Claude Code?

Run `npx skills add ZeroPointRepo/youtube-skills --skill youtube-api -a claude-code`. Or copy the skill folder (skills/youtube-api in ZeroPointRepo/youtube-skills) into .claude/skills/youtube-api in your project. Claude Code loads it when a task matches its description.

How do I install YouTube Data via TranscriptAPI in Codex?

Run `npx skills add ZeroPointRepo/youtube-skills --skill youtube-api -a codex`. Or copy the skill folder (skills/youtube-api in ZeroPointRepo/youtube-skills) into .agents/skills/youtube-api in your project. Codex loads it when a task matches its description.

Can I use YouTube Data via TranscriptAPI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZeroPointRepo/youtube-skills --skill youtube-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-api, .gemini/skills/youtube-api, .github/skills/youtube-api and .opencode/skills/youtube-api in your project.

What does YouTube Data via TranscriptAPI need to run?

Going by SKILL.md and its folder, YouTube Data via TranscriptAPI needs credentials named TRANSCRIPT_API_KEY. Our summary lists: A TranscriptAPI.com API key in TRANSCRIPT_API_KEY; Internet access to transcriptapi.com. Compatibility (from SKILL.md): Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed..

Does YouTube Data via TranscriptAPI access the network?

SKILL.md names 1 domain. In commands or code: transcriptapi.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is YouTube Data via TranscriptAPI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does YouTube Data via TranscriptAPI use?

YouTube Data via TranscriptAPI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does YouTube Data via TranscriptAPI use?

About 2.3k tokens (SKILL.md is roughly 9.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to YouTube Data via TranscriptAPI?

Skills that share tags, products or a category with YouTube Data via TranscriptAPI: Youtube Transcript (badlogic/pi-skills, 2.6k stars), Video Lens (kar2phi/video-lens, 113 stars), Youtube Transcript Extractor API Skill (browser-act/skills, 6.1k stars) and YouTube Transcript Reformatter (Prismer-AI/PrismerCloud, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains YouTube Data via TranscriptAPI?

ZeroPointRepo (a GitHub organization) maintains it in ZeroPointRepo/youtube-skills, which has 1,036 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 6, 2026.

Source: ZeroPointRepo/youtube-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.