YouTube Transcript API

Simple REST · JSON in, JSON out · Your Pro license key is your API key

Fetch a transcript

POST https://transcriptflow-backend.onrender.com/v1/transcript

curl -X POST https://transcriptflow-backend.onrender.com/v1/transcript \
  -H "Authorization: Bearer YOUR_LICENSE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://youtu.be/dQw4w9WgXcQ"}'

Response (abridged):

{
  "video_id": "dQw4w9WgXcQ",
  "video_title": "Rick Astley - Never Gonna Give You Up…",
  "language": "en",
  "word_count": 486,
  "transcript": "[00:00] We're no strangers to love…",
  "segments": [{"start": 0.0, "duration": 4.2, "text": "We're no strangers to love"}, …],
  "srt": "1\n00:00:00,000 --> …",
  "vtt": "WEBVTT…",
  "quota": {"day_used": 1, "day_limit": 200, "month_used": 1, "month_limit": 1000}
}

• Translation: add "target_language": "es" (any language the video supports).
• Quota: each call consumes 1 video from your Pro quota (200/day, 1,000/month) — also returned in X-Quota-Day / X-Quota-Month headers.
• Rate limit: 60 requests/minute.

List a playlist or channel

POST https://transcriptflow-backend.onrender.com/v1/playlist — free to call (no quota cost).

curl -X POST https://transcriptflow-backend.onrender.com/v1/playlist \
  -H "Authorization: Bearer YOUR_LICENSE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"playlist_url": "https://www.youtube.com/playlist?list=PL…"}'
# or: -d '{"channel_url": "https://www.youtube.com/@veritasium"}'

Returns the playlist/channel title and up to 100 videos (video_id, title, duration_seconds). Feed the IDs into /v1/transcript.

Errors