Y/T_TRANSCRIPT logo
Extract →
// DOCS

Y/T_TRANSCRIPT API reference.

Quickstart, endpoints, and error codes for integrating transcript fetching into your product.

// QUICKSTART

Fetch a transcript in one call.

Any HTTP client works. All you need is a video ID.

curl -X POST https://api.yt-transcript.dev/v1/transcript \
  -H "Authorization: Bearer $YT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"videoId":"dQw4w9WgXcQ","lang":"en"}'
// ENDPOINTS

Endpoints

POST
/v1/transcript
Fetch transcript for one video.
POST
/v1/batch
Submit up to 1,000 videos as a batch job.
GET
/v1/batch/:id
Poll batch status and get download URLs.
POST
/v1/translate
Translate an existing transcript.
POST
/v1/summarize
AI summary, bullets, or Q&A.
// ERRORS

Errors

404 · no_captions
The video has no caption tracks.
403 · private_video
Video is private or age-restricted.
429 · rate_limited
Slow down. Retry with backoff.
500 · upstream_error
YouTube returned an unexpected response.