Call the endpoint
One POST with a URL or a bare video id, from any language. Typed SDKs for Python and Node if you want them, plain REST if you do not.
Read the API referenceEndpoint
POST /api/v2/transcripts/video
50 free credits · no card
Clean text with timestamped segments, for any public video, whole channel, playlist or keyword search: over REST, an MCP server, or the Python and JavaScript SDKs.
No card required. Failed fetches are free.
Independently monitored
YouTube, TikTok, Instagram
Send a URL or a bare video id. Below are two different videos: the first has a caption track, the second has none and was transcribed from audio. Same request, same fields, same parser. Only source tells them apart.
curl -X POST https://transcriptfetch.com/api/v2/transcripts/video \
-H "Authorization: Bearer $TRANSCRIPTFETCH_KEY" \
-d '{"video": "<any supported url or id>"}'{
"ok": true,
"data": {
"kind": "transcript",
"title": "Example video",
"duration": 212,
"language": "en",
"source": "captions",
"segments": [
{ "start": 0, "duration": 3.5,
"text": "We're no strangers to love" },
… 411 more
]
},
"usage": { "credits_spent": 1, "balance": 49 }
}200 · 1 credit
{
"ok": true,
"data": {
"kind": "transcript",
"title": "Example video",
"duration": 184,
"language": "en",
"source": "audio",
"segments": [
{ "start": 0, "duration": 3.5,
"text": "So the first thing to understand here" },
… 411 more
]
},
"usage": { "credits_spent": 4, "balance": 45 }
}200 · 4 credits · transcribed
Nothing in your code branches on which path ran. A caption fetch is a flat single credit; transcription is billed by audio duration, which is the only other difference and it shows up in usage rather than in the shape. Every field, with types
Paste any YouTube link and run it against the live API. No account, no key, no card: you get the same JSON your code would.
6 free transcripts a month, no account needed.
Resolve a channel, playlist or search into a list, then transcribe what you want. Every row's url is accepted by the transcript and batch endpoints as-is. Costs are stamped on each tile.
One video URL or id. Captions, or AI transcription when there are none.
1 credit
Up to 50 ids per call, 500 on Mega and Scale. Per-item outcomes.
1 credit per delivered
Latest uploads, newest first, cursor-paged.
1 credit per page
Every video in a YouTube playlist, cursor-paged.
1 credit per page
Keyword search, results ready to transcribe.
1 credit per page
State of an audio transcription started by a 202.
Free
Validate the key and read remaining credits.
Free
Public liveness probe for uptime monitoring.
Free
The same fetch, the same credit, whichever way you reach it. Write code, let an assistant call it, or run it from a workflow tool without writing any.
One POST with a URL or a bare video id, from any language. Typed SDKs for Python and Node if you want them, plain REST if you do not.
Read the API referenceEndpoint
POST /api/v2/transcripts/video
Add the MCP server once and Claude, ChatGPT or Cursor pulls a transcript mid-conversation. OAuth on first use, nothing to deploy, no key to paste.
Set up MCPServer URL
https://transcriptfetch.com/mcp
The official n8n node, or an authenticated HTTP step in Make and Zapier. Fetch on a schedule, on a webhook, or whenever a row lands in a sheet.
See the n8n nodeCommunity node
n8n-nodes-transcriptfetch
curl -X POST https://transcriptfetch.com/api/v2/transcripts/video \
-H "Authorization: Bearer $TRANSCRIPTFETCH_KEY" \
-H "Content-Type: application/json" \
-d '{"video": "dQw4w9WgXcQ"}'import os, requests
r = requests.post(
"https://transcriptfetch.com/api/v2/transcripts/video",
headers={"Authorization": f"Bearer {os.environ['TRANSCRIPTFETCH_KEY']}"},
json={"video": "dQw4w9WgXcQ"},
)
data = r.json()["data"]
for seg in data["segments"]:
print(seg["start"], seg["text"])Or pip install transcriptfetch-sdk for typed models and async.
const res = await fetch(
"https://transcriptfetch.com/api/v2/transcripts/video",
{
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TRANSCRIPTFETCH_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ video: "dQw4w9WgXcQ" }),
},
);
const { data } = await res.json();
for (const seg of data.segments) {
console.log(seg.start, seg.text);
}Or npm i transcriptfetch for typed models and promises.
<?php
$ch = curl_init("https://transcriptfetch.com/api/v2/transcripts/video");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("TRANSCRIPTFETCH_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode(["video" => "dQw4w9WgXcQ"]),
]);
$data = json_decode(curl_exec($ch), true)["data"];
foreach ($data["segments"] as $seg) {
echo $seg["start"], " ", $seg["text"], PHP_EOL;
}{
"ok": true,
"request_id": "req_…",
"data": {
"kind": "transcript",
"video_id": "dQw4w9WgXcQ",
"platform": "youtube",
"title": "Example video",
"channel": "Example Channel",
"duration": 212,
"language": "en",
"source": "captions",
"segments": [
{ "start": 0, "duration": 3.5,
"text": "We're no strangers to love" },
{ "start": 3.5, "duration": 4.1,
"text": "You know the rules and so do I" }
]
},
"usage": { "credits_spent": 1, "balance": 49 }
}What did they say about chunking?
get_transcript(video="…")
02:29Fixing how documents were chunked moved the numbers more than a bigger model did.
Ground an assistant in what was actually said. Segments carry start times, so an answer can cite the second rather than paraphrase a video it never watched.
segments
chunked, cited, retrievable
Turn a video corpus into text your index can reach. Chunk on timestamps and every retrieved passage keeps a link back to the moment.
mentions · 12 weeks
Track a channel, a course, or a topic across more hours of video than anyone can sit through, then query the text.
One credit per delivered caption transcript. Failed or empty results are free. Unused credits roll over up to twice your monthly allowance.
How much will my volume cost?
transcripts / month
| Plan | Price | Credits / month | Per 1,000 | |
|---|---|---|---|---|
| Free | $0/mo | 50 | Free | Get started |
| Basic | $5/mo | 1,000 | $5.00 | Start with Basic |
| ProPopular | $15/mo | 10,000 | $1.50 | Go Pro |
| Mega | $45/mo | 50,000 | $0.90 | Go Mega |
| Scale | $229/mo | 300,000 | $0.76 | Scale up |
Top-ups are billed at your plan's per-1,000 rate and never expire. AI transcription is billed by audio duration rather than per transcript. Full pricing
Compared by approach rather than by vendor, because the real choice is whether you want to own the infrastructure.
| Capability | TranscriptFetch | An open-source library | Your own scraper |
|---|---|---|---|
| Language support | REST, any language | Python only | Any language |
| Setup | Get a key, make a request | pip install | Rent proxies, write parsers, maintain |
| No captions on the video | AI transcription, same endpoint | Raises an error | Build a whole second pipeline |
| Blocks and rotation | Handled for you | Your IP, blocked at scale | Yours to solve, forever |
| Channels, playlists, search | Built in, paginated | Not included | More parsers |
| Batch | Up to 50 per call | Manual loops | Your queue |
| Cost of a failure | Nothing | Your time | Your time and your proxies |
| When YouTube changes | We fix it | Wait for a release | You fix it, tonight |
One approach people expect to see here and will not: the YouTube Data API. It does not return caption text for videos you do not own: captions.download requires the owner's OAuth credentials, so for third-party videos it is not an option at any quota.
The audio is transcribed automatically on the same call: no second endpoint and no change to your code. Media under 20 minutes usually returns inline; longer media returns a 202 with a job you can poll or receive by callback. Transcription is billed by audio duration, one credit per started minute, and only on delivery.
Whatever caption track the video carries, with the language stamped on the response. When several tracks exist you can ask for one; when none exists and the audio is transcribed, the language is detected automatically.
Per-plan request rates, returned on every response as standard rate-limit headers so a client can back off without guessing. Batch is the cheaper path for volume: one call carries up to 50 videos on the free tier, Basic and Pro, and up to 500 on Mega and Scale.
Yes. POST /transcripts/batch takes up to 50 ids per call, 500 on Mega and Scale, and returns a per-item outcome rather than failing the whole request. You are charged one credit per successfully delivered caption transcript; failures cost nothing.
50 credits a month, no card. Every endpoint is included, not a reduced subset, so you can build the real integration before deciding to pay for it.
No. A credit is a delivered result. A caption transcript is one credit, a channel, playlist or search page is one credit, and polling a job, checking your balance and the health probe are free. Failed and empty results are never charged.
Python and JavaScript, both thin wrappers over the same REST endpoints with typed models. There is also an official n8n community node, and an MCP server if you would rather let an assistant make the call.
We fix it. Extraction runs through several methods behind one endpoint, so a change that breaks one path usually falls through to another before anyone notices, and the response shape your code parses does not move either way.
50 free transcripts a month. No card required. Failed fetches are never billed.