Use when a YouTube channel is the focus: pasted @handles or channel URLs, requests to browse a creator's uploads, see what a channel has posted recently, search within a channel, or resolve a handle to a channel ID. Also use when the user names a creator and wants to explore their content or monitor

YouTube Channels YouTube channel tools via [TranscriptAPI.com](https://transcriptapi.com). 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. All channel endpoints accept flexible input — @handle , channel URL, or UC... channel ID. No need to resolve first. GET /api/v2/youtube/channel/resolve — FREE Convert @handle, URL, or UC... ID to canonical channel ID. Param Required Validation input yes 1 200 chars — @handle, URL, or UC... ID Response: If input is already UC[a zA Z0 9 ]{22} , returns immediately. GET /api/v2/youtube/channel/latest — FREE Latest 15 videos via RSS with exact stats. Param Required Validation channel yes @handle , channel URL, or UC... ID Response: Great for monitoring channels — free and gives exact view counts + ISO timestamps. GET /api/v2/youtube/channel/videos — 1 credit/page Paginated list of ALL channel uploads (100 per page). Param Required Validation channel conditional @handle , channel URL, or UC... ID continuation conditional non empty (next pages) Provide exactly one of channel or continuation , not both. Response: Keep calling with continuation until has more: false . GET /api/v2/youtube/channel/search — 1 credit Search within a specific channel. Param Required Validation channel yes @handle , channel URL, or UC... ID q yes 1 200 chars limit no 1 50 (default 30) Typical workflow Errors Code Meaning Action 400 Invalid param combination Both or neither channel/continuation 402 No credits transcriptapi.com/billing 403/1010 Cloudflare block Add or fix User Agent header 404 Channel not found Check handle or URL 408 Timeout Retry once 422 Invalid channel identifier Check param format Free tier: 100 credits, 300 req/min. Free endpoints (resolve, latest) require auth but don't consume credits. Copy paste examples Every request in this file as a ready to run one liner: [references/curl examples.md](references/curl examples.md)

youtube-channels