Préparer l’environnement
Utilisez Node.js 22 ou une version ultérieure. Le script utilise fetch et les API de fichiers intégrées ; aucun paquet n’est nécessaire. Il vous faut une clé API, des crédits disponibles et l’ID d’une vidéo possédant une piste de sous-titres.
# Replace YOUR_API_KEY near the top of the code below.
export YOUTUBE_VIDEO_ID='dQw4w9WgXcQ'L’ID vidéo est la valeur du paramètre v dans l’URL YouTube de la vidéo. Pour cet endpoint, transmettez l’ID via video_id.
Récupérer et enregistrer les sous-titres
Enregistrez le code dans transcript.mjs. Il demande une piste automatique en anglais, écrit le texte brut dans un fichier et conserve l’objet de transcription complet dans un autre.
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 permet de lire le texte ou de le traiter ensuite. transcript.json conserve les informations de langue et les horodatages des segments.
Conserver les horodatages
Les segments de sous-titres possèdent les champs start, end et text. Pour construire un index de recherche, conservez l’ID vidéo, la langue et les horodatages avec chaque fragment afin de pouvoir retrouver le passage correspondant dans la vidéo.
{
"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"
}Un lien vidéo peut inclure &t=SECONDSs pour ouvrir la vidéo près du début d’un segment. Les horodatages restent utiles pour les citations et la navigation, même si vous regroupez plusieurs segments dans un document.
Gérer les sous-titres absents
La disponibilité des sous-titres dépend de la vidéo, de la langue et du type de piste. Une piste indisponible peut produire une erreur ou ne renvoyer aucun segment exploitable ; le script vérifie les deux cas et s’arrête avec un message.
Ces endpoints récupèrent les sous-titres existants ; ils ne transcrivent pas l’audio. Pour une piste fournie par le créateur, consultez l’API Captions et ses options. Évitez de soumettre à répétition la même requête lorsque la piste demandée n’existe pas.