Chandler

Response shape, transcription jobs, batching and limits.

Using the API

What comes back from a successful fetch, and how to use the segment timings.

The response format: text, segments and timestamps

What happens when a video has no captions, and how to collect the transcript when it does not arrive immediately.

AI transcription: jobs, polling and webhooks

The batch endpoint, its limits, and how partial failures are billed.

Fetching many videos at once

The default limit, the headers on every response, and how to back off correctly.

Rate limits and 429s

Channel, playlist and search listing, and why they do not exist for other platforms.

What works on YouTube only

Feedback

Roadmap

Integrations

Add TranscriptFetch as a tool your AI assistant can call mid-conversation, with no glue code.

Connect the MCP server to Claude, ChatGPT or Cursor

Fetch transcripts inside an n8n workflow, on a schedule or a trigger.

Use the n8n node

What an error means and what to do about it.

Troubleshooting

Why a fetch can come back empty, and which of those cases we can still solve by transcribing the audio.

No transcript found: what it means and what to do

The four errors worth handling explicitly, and which of them a retry can fix.

Understanding 401, 402, 422 and 429

The four access problems that look identical from your side, and how to tell them apart.

Private, deleted, region-locked and live media

Your first request, API keys, and what the API can fetch.

Getting started

Where to find your API key, how to authenticate, and a copy-paste request that returns a transcript. Covers the free tier, what counts as a credit, and the most common first-request errors.

Getting started: your first transcript in two minutes

Where to find your key, how to send it, and what to do when one is lost or compromised.

Creating and using API keys

Supported platforms and URL formats, and the one thing that only works for YouTube.

Which links you can send

Credits, plans, top-ups and what is free.

Billing

What costs a credit, what is free, how the monthly plans and top-ups work, and why cached responses are still billed.

How credits and billing work

What each plan includes, how top-ups work, and what happens when credits run out.