Prepare your environment
Use Node.js 22 or later. The script uses built-in fetch and file APIs, so no packages are required. You need an API key, available credits and the ID of a video with an existing caption track.
# Replace YOUR_API_KEY near the top of the code below.
export YOUTUBE_VIDEO_ID='dQw4w9WgXcQ'The video ID is the v value in a YouTube watch URL. For this endpoint, pass the ID through video_id.
Fetch and save the captions
Save the code as transcript.mjs. It requests an English automatic track, writes plain text to one file and keeps the complete transcript object in another.
import { writeFile } from "node:fs/promises";
const apiKey = "YOUR_API_KEY";
const videoId = process.env.YOUTUBE_VIDEO_ID;
if (!videoId) {
throw new Error("Set YOUTUBE_VIDEO_ID first.");
}
const baseUrl = "https://data.flashdata.dev";
const response = await fetch(baseUrl + "/v1/queries/realtime", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": apiKey,
},
body: JSON.stringify({
source: "youtube_transcript",
video_id: videoId,
params: { language: "en", auto: true },
}),
signal: AbortSignal.timeout(60000),
});
const payload = await response.json();
if (!response.ok || payload.error) {
throw new Error(payload.message ?? payload.detail ?? "Transcript request failed");
}
const transcript = payload.results?.[0];
if (!Array.isArray(transcript?.segments) || transcript.segments.length === 0) {
throw new Error("No caption segments were returned for this video and language.");
}
const text = transcript.segments.map(segment => segment.text).join("\n");
await writeFile("transcript.txt", text, "utf8");
await writeFile("transcript.json", JSON.stringify(transcript, null, 2), "utf8");
console.log("Saved transcript.txt and transcript.json (with segment timestamps).");
node transcript.mjstranscript.txt is convenient for reading or further text processing. transcript.json keeps language information and segment timestamps.
Keep the timestamps
Caption segments have start, end and text fields. When building a search index, keep the video ID, language and timestamps with every chunk so a match can point back to the video.
{
"source": "youtube_transcript",
"status": "done",
"results": [
{
"videoId": "dQw4w9WgXcQ",
"languageCode": "en",
"languageName": null,
"isAutoGenerated": true,
"segments": [
{
"start": 0.32,
"end": 14.58,
"text": "[Music]"
},
{
"start": 18.8,
"end": 25.96,
"text": "We're no strangers to"
},
{
"start": 21.8,
"end": 29.119,
"text": "love. You know the rules and so do"
},
{
"start": 25.96,
"end": 30.279,
"text": "I. I feel commitments from what I'm"
},
{
"start": 29.119,
"end": 34.36,
"text": "thinking"
},
{
"start": 30.279,
"end": 39.559,
"text": "of. You wouldn't get this from any other"
},
{
"start": 34.36,
"end": 43.12,
"text": "guy. I just want to tell you how I'm"
},
{
"start": 39.559,
"end": 45.84,
"text": "feeling. Got to make you understand."
},
{
"start": 43.12,
"end": 49.2,
"text": "Never going to give you up. I'm going to"
},
{
"start": 45.84,
"end": 53.32000000000001,
"text": "let you down. I'm going to run around"
},
{
"start": 49.2,
"end": 56.399,
"text": "and desert you. I'm going to make"
},
{
"start": 53.32,
"end": 59.879,
"text": "you say goodbye."
},
{
"start": 56.399,
"end": 64.04,
"text": "Tell a lie and hurt"
},
{
"start": 59.879,
"end": 67.2,
"text": "you. We've known each other for so"
},
{
"start": 64.04,
"end": 70.56,
"text": "long. Your heart's been aching, but"
},
{
"start": 67.2,
"end": 72.60000000000001,
"text": "you're too shy to say we don't know"
},
{
"start": 70.56,
"end": 77.799,
"text": "what's been going"
},
{
"start": 72.6,
"end": 81.479,
"text": "on. We know the game and we're going to"
},
{
"start": 77.799,
"end": 84.56,
"text": "play. If you ask me how I'm"
},
{
"start": 81.479,
"end": 88.32,
"text": "feeling, don't tell me your truth. to"
},
{
"start": 84.56,
"end": 88.32000000000001,
"text": "see. I will give"
},
{
"start": 89.88,
"end": 94.72,
"text": "you"
},
{
"start": 91.72,
"end": 94.72,
"text": "around"
},
{
"start": 95,
"end": 99.04,
"text": "you. I will say"
},
{
"start": 99.56,
"end": 106.759,
"text": "goodbye and hurt you. I will give"
},
{
"start": 103.99,
"end": 108.6,
"text": "[Music]"
},
{
"start": 106.759,
"end": 115.92,
"text": "you"
},
{
"start": 108.6,
"end": 115.92,
"text": "around you. I will leave you. I will say"
},
{
"start": 116.439,
"end": 121.079,
"text": "goodbye and hurt you."
},
{
"start": 128.319,
"end": 132.56,
"text": "Never going to give. Never going to"
},
{
"start": 129.759,
"end": 134,
"text": "give."
},
{
"start": 132.56,
"end": 136.8,
"text": "Never going to give. Never going to"
},
{
"start": 134,
"end": 141.04,
"text": "give."
},
{
"start": 136.8,
"end": 143.68,
"text": "We've known each other for so long."
},
{
"start": 141.04,
"end": 147.51999999999998,
"text": "Your heart's been aching, but you're too"
},
{
"start": 143.68,
"end": 148.52,
"text": "shy to say it. We both know what's been"
},
{
"start": 147.52,
"end": 152.239,
"text": "going"
},
{
"start": 148.52,
"end": 157.8,
"text": "on. We know the game and we're going to"
},
{
"start": 152.239,
"end": 161.36,
"text": "play it. I just want to tell you how I'm"
},
{
"start": 157.8,
"end": 163.92000000000002,
"text": "feeling. Got to make you understand."
},
{
"start": 161.36,
"end": 166.8,
"text": "Never going to give you up. Never going"
},
{
"start": 163.92,
"end": 171.28,
"text": "to let you down. Never going to run"
},
{
"start": 166.8,
"end": 171.28,
"text": "around and desert you. Heat."
},
{
"start": 172.33,
"end": 182.76,
"text": "[Music]"
},
{
"start": 178.76,
"end": 182.76,
"text": "Heat. Heat. Heat."
},
{
"start": 183.39,
"end": 195.2,
"text": "[Music]"
},
{
"start": 191.04,
"end": 197.76,
"text": "Never going to tell a lie and hurt you."
},
{
"start": 195.2,
"end": 200.64,
"text": "Never going to give you up. Never going"
},
{
"start": 197.76,
"end": 204.239,
"text": "to let you down. Never going to run"
},
{
"start": 200.64,
"end": 206.83999999999995,
"text": "around and desert you. Never going to"
},
{
"start": 204.239,
"end": 211.879,
"text": "make you cry. Never going to say"
},
{
"start": 206.84,
"end": 211.879,
"text": "goodbye. Never going to say goodbye."
}
],
"fullText": "[Music] We're no strangers to love. You know the rules and so do I. I feel commitments from what I'm thinking of. You wouldn't get this from any other guy. I just want to tell you how I'm feeling. Got to make you understand. Never going to give you up. I'm going to let you down. I'm going to run around and desert you. I'm going to make you say goodbye. Tell a lie and hurt you. We've known each other for so long. Your heart's been aching, but you're too shy to say we don't know what's been going on. We know the game and we're going to play. If you ask me how I'm feeling, don't tell me your truth. to see. I will give you around you. I will say goodbye and hurt you. I will give [Music] you around you. I will leave you. I will say goodbye and hurt you. Never going to give. Never going to give. Never going to give. Never going to give. We've known each other for so long. Your heart's been aching, but you're too shy to say it. We both know what's been going on. We know the game and we're going to play it. I just want to tell you how I'm feeling. Got to make you understand. Never going to give you up. Never going to let you down. Never going to run around and desert you. Heat. [Music] Heat. Heat. Heat. [Music] Never going to tell a lie and hurt you. Never going to give you up. Never going to let you down. Never going to run around and desert you. Never going to make you cry. Never going to say goodbye. Never going to say goodbye."
}
],
"usage": {
"credits": 0.01
},
"created_at": "2026-09-16T07:45:44.040Z"
}A video link can include &t=SECONDSs to open near a segment’s start. Timestamps are useful for citations and navigation even if you combine several segments into one document.
Handle missing captions
Caption availability depends on the video, language and track type. An unavailable track can produce an error or no usable segments; the script checks both cases and stops with a message.
These endpoints retrieve existing captions. They do not generate new speech-to-text output. For a creator-provided track, check the Captions API and its options. Avoid repeatedly submitting the same request when the requested track does not exist.