Youtube Full

zeropointrepo/youtube-skills/clawhub/youtube-full

by zeropointrepo4f7994b94e7dNo license1K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 days ago

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 announcements, first looks, or anything where video content is fresher or richer than text search. Covers transcripts, video/channel search, channel browsing, playlists, and within-channel search. Not for uploads, account management, or written-source-only research.

Instructions onlyResearch & Analysis

AI-generated overview

Fetches YouTube transcripts, video metadata, search results, channel feeds and playlists through the TranscriptAPI service.

What it does: This skill documents how to call the TranscriptAPI.com HTTP endpoints for YouTube data: video transcripts with optional timestamps and metadata, video metadata, keyword search across videos, channels, playlists and movies, channel resolution, latest uploads, channel feeds, within-channel search, channel profiles, playlists, community posts and curated sections. It supplies request parameters, validation rules, credit costs, error codes and example curl commands, and produces retrieved transcript text and JSON metadata for the agent to use. It is instruction-only and ships no scripts.
When to use it: Use it when a task involves YouTube content or could benefit from it, such as pasted video, channel or playlist links, video IDs or @handles, video summaries, quotes, translations, topic research, tutorials, talks, lectures, expert discussions, product reviews or how-to guides. It is not intended for uploads, account management, or research based only on written sources.
Requirements: Internet access to transcriptapi.com and a TRANSCRIPT_API_KEY environment variable (a free account provides 100 credits); requests also need an Authorization bearer header and a descriptive User-Agent header. No additional runtimes or dependencies, and no scripts are included.

YouTube Full

Complete YouTube toolkit via TranscriptAPI.com. Everything in one skill.

Setup

If $TRANSCRIPT_API_KEY is not set, read references/auth-setup.md [blocked] 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.

Transcript — 1 credit

bash

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Response (format=json):

json

{  "video_id": "dQw4w9WgXcQ",  "language": "en",  "transcript": [{ "text": "...", "start": 18.0, "duration": 3.5 }],  "metadata": { "title": "...", "author_name": "...", "author_url": "..." }}

{  "video_id": "dQw4w9WgXcQ",  "language": "en",  "transcript": [{ "text": "...", "start": 18.0, "duration": 3.5 }],  "metadata": { "title": "...", "author_name": "...", "author_url": "..." }}

Video Info & Metadata

bash

# Free — languages available for the transcript endpointcurl -s "https://transcriptapi.com/api/v2/youtube/info?video_url=VIDEO_URL" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# 1 credit — rich metadata (views, likes, description, duration, tags)curl -s "https://transcriptapi.com/api/v2/youtube/video/metadata\?video_url=VIDEO_URL&include=details,related" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

# Free — languages available for the transcript endpointcurl -s "https://transcriptapi.com/api/v2/youtube/info?video_url=VIDEO_URL" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# 1 credit — rich metadata (views, likes, description, duration, tags)curl -s "https://transcriptapi.com/api/v2/youtube/video/metadata\?video_url=VIDEO_URL&include=details,related" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

include on video/metadata accepts details and/or related. Naming: /video/metadata was previously /video/info — the old path still works but is deprecated.

Search — 1 credit/page

bash

# Videoscurl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Channels, playlists, or moviescurl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

# Videoscurl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Channels, playlists, or moviescurl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Param	Required	Default	Validation
`q`	yes	—	1-200 chars
`type`	no	`video`	`video`, `channel`, `playlist`, `movie`
`sort`	no	`relevance`	`relevance`, `views` (first page only)
`upload_date`	no	—	`hour`, `today`, `week`, `month`, `year` (videos, first page)
`duration`	no	—	`short`, `medium`, `long` (videos, first page)
`features`	no	—	e.g. `hd,subtitles,cc` (first page)
`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

bash

curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Response: {"channel_id": "UC...", "resolved_from": "@TED"}

Latest 15 videos — FREE

bash

curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Returns exact viewCount and ISO published timestamps.

Channel feed (videos/shorts/streams) — 1 credit/page

bash

# First page (100 items, tab defaults to "videos")curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&tab=videos" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Most-viewed first (channel Videos tab, ~30 items)curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&sort=popular" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Next pages (repeat the same tab AND sort)curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN&sort=popular" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

# First page (100 items, tab defaults to "videos")curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&tab=videos" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Most-viewed first (channel Videos tab, ~30 items)curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&sort=popular" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Next pages (repeat the same tab AND sort)curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN&sort=popular" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Provide exactly one of channel or continuation. tab is videos (default), shorts, or streams. Response includes continuation_token and has_more.

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.

Search within channel — 1 credit

bash

curl -s "https://transcriptapi.com/api/v2/youtube/channel/search\?channel=@TED&q=QUERY&limit=30" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/channel/search\?channel=@TED&q=QUERY&limit=30" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Channel profile — 1 credit

bash

curl -s "https://transcriptapi.com/api/v2/youtube/channel/info?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/channel/info?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Returns title, handle, verified flag, subscriber/video counts, description, tags, thumbnails, banners, and availableTabs.

Channel playlists — 1 credit/page

bash

curl -s "https://transcriptapi.com/api/v2/youtube/channel/playlists?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/channel/playlists?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Returns each playlist's playlistId, title, url, videoCountText — feed a playlistId into the Playlists endpoint below.

Channel community posts — 1 credit/page

bash

curl -s "https://transcriptapi.com/api/v2/youtube/channel/posts?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/channel/posts?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Channel curated sections — 1 credit

bash

curl -s "https://transcriptapi.com/api/v2/youtube/channel/sections?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

curl -s "https://transcriptapi.com/api/v2/youtube/channel/sections?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

tab is featured (default, Home page), podcasts, or releases.

Playlists — 1 credit/page

Accepts playlist — a YouTube playlist URL or playlist ID.

bash

# First pagecurl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Next pagescurl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

# First pagecurl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
# Next pagescurl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Valid ID prefixes: PL, UU, LL, FL, OL. Response includes playlist_info, results, continuation_token, has_more.

Credit Costs

Endpoint	Cost
transcript	1
info	free
video/metadata	1
search	1/page
channel/resolve	free
channel/info	1
channel/latest	free
channel/videos	1/page
channel/search	1
channel/playlists	1/page
channel/posts	1/page
channel/sections	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
`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)
`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

bash

# 1. Searchcurl -s "https://transcriptapi.com/api/v2/youtube/search\?q=machine+learning+explained&limit=5" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"# 2. Transcriptcurl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

# 1. Searchcurl -s "https://transcriptapi.com/api/v2/youtube/search\?q=machine+learning+explained&limit=5" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"# 2. Transcriptcurl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Channel monitoring: latest (free) → transcript

bash

# 1. Latest uploads (free — pass @handle directly)curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"# 2. Transcript of latestcurl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

# 1. Latest uploads (free — pass @handle directly)curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"# 2. Transcript of latestcurl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Free tier: 100 credits, 300 req/min. Starter ($5/mo): 1,000 credits.

Source and attribution

Source:zeropointrepo/youtube-skillsinclawhub/youtube-fullat commit4f7994b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

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`

Youtube Full

YouTube Full

Setup

Required Headers

API Reference

Transcript — 1 credit

Video Info & Metadata

Search — 1 credit/page

Channels

Resolve handle — FREE

Latest 15 videos — FREE

Channel feed (videos/shorts/streams) — 1 credit/page

Search within channel — 1 credit

Channel profile — 1 credit

Channel playlists — 1 credit/page

Channel community posts — 1 credit/page

Channel curated sections — 1 credit

Playlists — 1 credit/page

Credit Costs

Validation Rules

Errors

Typical Workflows

Source and attribution

More from zeropointrepo/youtube-skills

Yt

Youtube Search

Youtube Playlist

Youtube Data

Youtube Channels

Youtube Api

More in Research & Analysis

Equity Research

Sector Overview

Idea Generation

Competitive Analysis

Notion Research Documentation

Notion Meeting Intelligence