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 needin

YouTube Data YouTube data access via [TranscriptAPI.com](https://transcriptapi.com) — lightweight alternative to Google's YouTube Data API. 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. Video Data (transcript + metadata) — 1 credit Response: Search Data — 1 credit Video result fields: videoId , title , channelId , channelTitle , channelHandle , channelVerified , lengthText , viewCountText , publishedTimeText , hasCaptions , thumbnails Channel result fields ( type=channel ): channelId , title , handle , url , description , subscriberCount , verified , rssUrl , thumbnails Channel Data Channel endpoints accept channel — an @handle , channel URL, or UC... ID. No need to resolve first. Resolve handle to ID (free): Returns: {"channel id": "UCsT0YIqwnpJCM mx7 gSA4Q", "resolved from": "@TED"} Latest 15 videos with exact stats (free): Returns: channel info, results array with videoId , title , published (ISO), viewCount (exact number), description , thumbnail All channel videos (paginated, 1 credit/page): Returns 100 videos per page + continuation token for pagination. Search within channel (1 credit): Playlist Data — 1 credit/page Accepts playlist — a YouTube playlist URL or playlist ID. Returns: results (videos), playlist info ( title , numVideos , ownerName , viewCount ), continuation token , has more Credit Costs Endpoint Cost Data returned transcript 1 Full transcript + metadata search 1 Video/channel details channel/resolve free Channel ID mapping channel/latest free 15 videos + exact stats channel/videos 1/page 100 videos per page channel/search 1 Videos matching query playlist/videos 1/page 100 videos per page 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 408 Timeout Retry once 422 Validation error Check param format Free tier: 100 credits, 300 req/min. Copy paste examples Every request in this file as a ready to run one liner: [references/curl examples.md](references/curl examples.md)

youtube-data