Gets the spoken content of YouTube videos as text, plus YouTube search and channel/playlist listings, through the GetYouTubeTranscript REST API. The agent can then summarize, quote, search or analyze what was actually said, without the user pasting a transcript in.
How it differs from nearby skills: youtube-full and apify-youtube-transcript-scraper cover the same core job through other providers. This one returns the caption track in any language the video offers (with a separate call that lists those languages and whether each is manual or auto-generated), reports the caption type so the agent knows how far to trust names and terms, and adds channel Shorts, live streams, community posts, in-channel search, related videos and banner endpoints. It uses plain curl calls with no bundled scripts, so it runs from a laptop, a server or CI.
Disclosure: the API is a paid product made by the skill author (TubeAgentKit). Links carry no affiliate parameters.
youtube-full or apify-youtube-transcript-scraper instead if the user already has an account with that provider. Use a downloader such as yt-dlp if the user wants the video or audio file itself.GETYOUTUBETRANSCRIPT_API_KEY. If the user has none, point them to curl and network access to https://getyoutubetranscript.com.GET /credits cost nothing. New accounts get 100 free credits; paid plans start at $5/month for 1,000 credits (see GETYOUTUBETRANSCRIPT_API_KEY is set. Check it with the free balance call before spending credits:curl -s "https://getyoutubetranscript.com/api/v1/credits" \
-H "Authorization: Bearer $GETYOUTUBETRANSCRIPT_API_KEY"
A 200 returns plan_credits_left, topup_credits_left, total_credits_left, plan and rate_limit_per_minute. A 401 means the key is missing or invalid: ask the user for a valid key, never guess one.
watch?v=, youtu.be/, /shorts/); pass it through unchanged.Base URL https://getyoutubetranscript.com/api/v1. Send the key as Authorization: Bearer <key> (or x-api-key: <key>).
Transcript (1 credit):
curl -s "https://getyoutubetranscript.com/api/v1/transcript?v=jNQXAC9IVRw×tamps=true" \
-H "Authorization: Bearer $GETYOUTUBETRANSCRIPT_API_KEY"
language is optional (for example language=de). Leave it off to get the video's default track; do not force English.timestamps=true adds segments (start, duration, text per caption line). Add it when the user wants to quote or cite moments; it roughly doubles the response at the same credit cost.transcript (plain text), language_code (track actually returned), requested_language, caption_type (manual, auto or null), title, author_name, word_count, cached and fetched_at.Caption languages (1 credit): GET /transcript/languages?v=<video> returns languages (each language_code, name, caption_type) and default_language_code. An empty list means captions are turned off.
Search (1 credit per page): GET /search?q=<query>&type=video&limit=20 (type=channel for channels; optional country, language). Results are in data.video_results or data.channel_results; pass data.continuation_token back as page_token for the next page.
Channels (1 credit per call or page), all taking channel=@handle, a channel ID or a channel URL:
GET /resolve?handle=@handle: channel ID for a handle.GET /channel/latest: channel metadata plus the 15 newest uploads.GET /channel/videos: full uploads list; tab=shorts or tab=streams, sort=popular or sort=oldest.GET /channel/playlists, GET /channel/posts, GET /channel/search?q=<query>, GET /channel/banner.Playlist (1 credit per page): GET /playlist?list=<playlist ID or URL>.
Related videos (1 credit): GET /video/related?v=<video>.
Pagination: when data.continuation_token is non-null, call the same endpoint with continuation=<token> (verbatim, never decoded or built by hand). null means no more pages. Each page costs 1 credit.
Many transcripts (1 credit per video that returns a transcript; submitting is free):
curl -s -X POST "https://getyoutubetranscript.com/api/v1/batch" \
-H "Authorization: Bearer $GETYOUTUBETRANSCRIPT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"videos": ["jNQXAC9IVRw", "https://youtu.be/dQw4w9WgXcQ"], "timestamps": false}'
Up to 100 videos per batch. Poll GET /batch?id=<batch_id>&offset=0&limit=20 every few seconds until data.status is completed, then read data.items and page with next_offset.
success is true. If language_code differs from what the user asked for, say the video lacks that language; do not present the result as a translation.caption_type is auto, warn that names and technical terms may be misheard before quoting them.segments, as https://www.youtube.com/watch?v=<id>&t=<floor(start)>s; never estimate times from the plain transcript.message field; it is written for end users.User request: Summarize this talk and quote where they define "embedding": https://www.youtube.com/watch?v=jNQXAC9IVRw
Inputs: video URL; GETYOUTUBETRANSCRIPT_API_KEY set
Calls: GET /transcript?v=<url>×tamps=true (1 credit)
Expected result (illustrative): a short summary, plus the quoted line with a link that opens the video at that second.
User request: Get the German transcript of jNQXAC9IVRw if there is one.
Calls: GET /transcript/languages?v=jNQXAC9IVRw (1 credit), then GET /transcript?v=jNQXAC9IVRw&language=de (1 credit)
Expected result (illustrative): the German caption text, labelled as the creator's manual track or YouTube's auto captions.
TRANSCRIPT_DISABLED or an empty language list.VIDEO_UNAVAILABLE.PAYMENT_REQUIRED until the user tops up.rate_limit_per_minute in /credits); a 429 means back off, not retry in a loop.Errors are JSON with a stable code:
| Status | Code | Meaning |
|---|---|---|
| 400 | BAD_REQUEST, MISSING_URL, INVALID_URL | Missing or malformed parameter |
| 401 | MISSING_API_KEY, INVALID_API_KEY | No key, or invalid/revoked key |
| 402 | PAYMENT_REQUIRED | Out of credits; do not retry |
| 404 | VIDEO_UNAVAILABLE, TRANSCRIPT_NOT_FOUND, TRANSCRIPT_DISABLED, LANGUAGE_NOT_AVAILABLE | No such video, or no matching transcript |
| 429 | RATE_LIMITED | Too many requests for the key's plan |
| 503 | UPSTREAM_UNAVAILABLE, UPSTREAM_TIMEOUT | Transient; retry once after a short delay |
youtube-full, apify-youtube-transcript-scraper, ingest-youtube.