TubeToTranscript Logo
TubeToTranscript
Developer API v1 & MCP Protocol

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.

Interactive API Reference

Endpoints & Live Code Examples

Request Implementation (CURL)
# 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"
  }'
JSON Response Schema (HTTP 200 OK)
{
  "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.

EndpointWhat it returnsCost
GET|POST /transcriptTranscript with timestamps. language accepts a priority list (de,en,asr); format=text and include_timestamp=false supported.1 request
POST /batchTranscripts for many videos in one call.1 request
GET /infoTitle, channel and every available caption language.Free
GET /video/metadataDescription and links, views, likes, publish date, channel; include=details,related for tags, captions and suggested videos.1 request
GET /searchSearch 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/infoSubscribers, video and view counts, join date, country, links, avatar and banner.1 request
GET /channel/videosA channel’s videos, Shorts or live streams, sorted latest, popular or oldest.1 per page
GET /channel/searchSearch a channel’s videos by title and description.1 per page
GET /channelSearch what is said across a channel’s transcripts.1 request
GET /channel/playlistsA channel’s playlists.1 per page
GET /channel/postsCommunity posts with video, image and poll attachments.1 per page
GET /channel/sectionsThe shelves on a channel’s Home tab.1 request
GET /channel/latestLatest ~15 uploads with dates, views and likes.Free
GET /playlist/videosA playlist’s videos, ~100 per page, with title and owner.1 per page
GET /playlistA 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 CodeMeaningDescription
200 OKSuccessTranscript successfully retrieved and formatted.
400 Bad RequestInvalid InputMissing or malformed YouTube URL or parameter.
404 Not FoundNo SubtitlesVideo exists but contains no creator or automatic caption tracks.
429 Too Many RequestsRate LimitedQuota 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.

Create a free account and open your Dashboard (/dashboard) to get a personal API key, see your usage and try endpoints live. A new key includes 10 free trial requests; paid plans with larger monthly quotas are on the Pricing page. Requests to /api/v1 need a key.