YouTube Transcript REST API & SDKs
The fastest developer platform for extracting clean YouTube transcripts, closed captions, and video knowledge into AI models, agents, and applications.
Integration behavior and limits
Cached transcript requests
A local cache can speed up repeated transcript requests; availability still depends on the caption provider and deployment configuration.
Native MCP Protocol
Model Context Protocol server for Claude Desktop, Cursor, and AI agents. Run it locally with npx -y tubetotranscript-mcp (free, no key), or connect to https://www.tubetotranscript.com/mcp with an API key.
Sliding Window Limits
Tiered quotas, CORS support, cryptographic API key authentication, and predictable headers.
Endpoints & Live Code Examples
# 1. Simple GET Request
curl "https://www.tubetotranscript.com/api/v1/transcript?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
-H "Authorization: Bearer YOUR_API_KEY"
# 2. POST with Language Fallback
curl -X POST "https://www.tubetotranscript.com/api/v1/transcript" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"language": "en"
}'{
"language": "en",
"language_name": "English",
"is_generated": false,
"length_seconds": 213,
"lengthText": "03:33",
"metadata": {
"videoId": "dQw4w9WgXcQ",
"title": "Never Gonna Give You Up",
"channel": "Rick Astley",
"thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
},
"transcript": [
{
"text": "We're no strangers to love",
"start": 18.5,
"duration": 3.2
},
{
"text": "You know the rules and so do I",
"start": 22.8,
"duration": 4.1
}
],
"available_languages": [
{
"code": "en",
"name": "English",
"is_generated": false
}
]
}All Endpoints
Base URL https://www.tubetotranscript.com/api/v1. Every call needs an API key. Free endpoints don't use up your request allowance; paginated endpoints count 1 request per page and return a continuation_token for the next one.
| Endpoint | What it returns | Cost |
|---|---|---|
| GET|POST /transcript | Transcript with timestamps. language accepts a priority list (de,en,asr); format=text and include_timestamp=false supported. | 1 request |
| POST /batch | Transcripts for many videos in one call. | 1 request |
| GET /info | Title, channel and every available caption language. | Free |
| GET /video/metadata | Description and links, views, likes, publish date, channel; include=details,related for tags, captions and suggested videos. | 1 request |
| GET /search | Search videos, channels, playlists or movies, with sort, upload-date, duration and feature filters. | 1 per page |
| GET /channel/resolve | @handle or channel URL to its UC… channel ID. | Free |
| GET /channel/info | Subscribers, video and view counts, join date, country, links, avatar and banner. | 1 request |
| GET /channel/videos | A channel’s videos, Shorts or live streams, sorted latest, popular or oldest. | 1 per page |
| GET /channel/search | Search a channel’s videos by title and description. | 1 per page |
| GET /channel | Search what is said across a channel’s transcripts. | 1 request |
| GET /channel/playlists | A channel’s playlists. | 1 per page |
| GET /channel/posts | Community posts with video, image and poll attachments. | 1 per page |
| GET /channel/sections | The shelves on a channel’s Home tab. | 1 request |
| GET /channel/latest | Latest ~15 uploads with dates, views and likes. | Free |
| GET /playlist/videos | A playlist’s videos, ~100 per page, with title and owner. | 1 per page |
| GET /playlist | A playlist’s videos with their transcripts. | 1 request |
Full parameters and response schemas are in the OpenAPI spec. New to the API? Start with the step-by-step JSON guide.
Standard Response Codes
| Status Code | Meaning | Description |
|---|---|---|
| 200 OK | Success | Transcript successfully retrieved and formatted. |
| 400 Bad Request | Invalid Input | Missing or malformed YouTube URL or parameter. |
| 404 Not Found | No Subtitles | Video exists but contains no creator or automatic caption tracks. |
| 429 Too Many Requests | Rate Limited | Quota exceeded for active tier. Check Retry-After header. |
New to the API? Follow the step-by-step guide to getting YouTube transcripts as JSON with cURL, Python, and Node.js examples. Weighing the official YouTube API or the Python library instead? See YouTube transcript API alternatives.
API Implementation & Rate Limits FAQ
Find answers to common questions about generating and exporting YouTube transcripts.
Choose your next step
Tools that help you use the transcript you have.
Batch Multi-Video (Bulk)
Transcribe up to 30 YouTube videos in parallel into 1 combined file.
Full Playlist Transcriber
Provider-backed playlist enumeration and transcript export.
API Documentation & SDKs
Full interactive documentation with Python, cURL, and Node.js examples.
Channel Speech Search
Provider-backed search across supported channel transcript catalogs.