Transcriptapi

TranscriptAPI

Full YouTube data toolkit via TranscriptAPI.com. Transcripts, search, channels, playlists — one API key.

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.

Auth

All requests: -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

Endpoints

Channel endpoints accept channel — an @handle, channel URL, or UC... ID. No need to resolve first. Playlist endpoints accept playlist — a playlist URL or ID.

GET /api/v2/youtube/transcript — 1 credit

GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=trueAuthorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0

Accepts: https://youtube.com/watch?v=ID, https://youtu.be/ID, youtube.com/shorts/ID, or bare ID.

Response (format=json):

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

GET /api/v2/youtube/search — 1 credit

GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20Authorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0

Response (type=video):

{  "results": [    {      "type": "video",      "videoId": "dQw4w9WgXcQ",      "title": "Rick Astley - Never Gonna Give You Up",      "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",      "channelTitle": "Rick Astley",      "channelHandle": "@RickAstley",      "channelVerified": true,      "lengthText": "3:33",      "viewCountText": "1.5B views",      "publishedTimeText": "14 years ago",      "hasCaptions": true,      "thumbnails": [{ "url": "...", "width": 120, "height": 90 }]    }  ],  "result_count": 20}

Response (type=channel):

{  "results": [    {      "type": "channel",      "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",      "title": "Rick Astley",      "handle": "@RickAstley",      "subscriberCount": "4.2M subscribers",      "verified": true,      "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UC..."    }  ],  "result_count": 5}

GET /api/v2/youtube/channel/resolve — FREE (0 credits)

GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TEDAuthorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0

Response:

{ "channel_id": "UCsT0YIqwnpJCM-mx7-gSA4Q", "resolved_from": "@TED" }

If input is already a valid UC[a-zA-Z0-9_-]{22} ID, returns immediately without lookup.

GET /api/v2/youtube/channel/videos — 1 credit/page

# First page (100 videos)GET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASAAuthorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0
# Most-viewed first (channel Videos tab, ~30 videos)GET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA&sort=popularAuthorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0
# Next pages (repeat the same sort)GET https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN&sort=popularAuthorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0

Provide exactly one of channel or continuation.

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.

Every item carries members_only, true only when YouTube badges it "Members only", and those items have no viewCountText. Items from tab=streams 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.

Response:

{  "results": [{    "videoId": "abc123xyz00",    "title": "Latest Video",    "channelId": "UCsT0YIqwnpJCM-mx7-gSA4Q",    "channelTitle": "TED",    "channelHandle": "@TED",    "lengthText": "15:22",    "viewCountText": "3.2M views",    "publishedTimeText": "2 years ago",    "thumbnails": [...],    "index": "0",    "members_only": false  }],  "playlist_info": {"title": "Uploads from TED", "numVideos": "5000"},  "continuation_token": "4qmFsgKlARIYVVV1...",  "has_more": true}

GET /api/v2/youtube/channel/latest — FREE (0 credits)

GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TEDAuthorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0

Returns last 15 videos via RSS with exact view counts and ISO timestamps.

Response:

{  "channel": {    "channelId": "...",    "title": "TED",    "author": "TED",    "url": "..."  },  "results": [    {      "videoId": "abc123xyz00",      "title": "Latest Video",      "published": "2026-01-30T16:00:00Z",      "viewCount": "2287630",      "description": "Full description...",      "thumbnail": { "url": "...", "width": "480", "height": "360" }    }  ],  "result_count": 15}

GET /api/v2/youtube/channel/search — 1 credit

GET https://transcriptapi.com/api/v2/youtube/channel/search?channel=@TED&q=climate+change&limit=30Authorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0

GET /api/v2/youtube/playlist/videos — 1 credit/page

# First pageGET https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_IDAuthorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0
# Next pagesGET https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKENAuthorization: Bearer $TRANSCRIPT_API_KEYUser-Agent: YourAgent/1.0

Credit Costs

Errors

Tips

• When user shares YouTube URL with no instruction, fetch transcript and summarize key points.
• Use channel/latest (free) to check for new uploads before fetching transcripts — pass @handle directly.
• For research: search → pick videos → fetch transcripts.
• Free tier: 100 credits, 300 req/min. Starter ($5/mo): 1,000 credits, 300 req/min.

Copy-paste examples

Every request in this file as a ready-to-run one-liner: references/curl-examples.md [blocked]