youtube-transcript-node/dist/index.js

This is a Node.js API which allows you to get the transcripts/subtitles for a given YouTube video. It also works for automatically generated subtitles and supports translating subtitles.

import axios from 'axios';
import axiosRetry from 'axios-retry';
import { TranscriptListFetcher } from './transcriptFetcher.js';
export * from './errors/index.js';
export { FetchedTranscript, FetchedTranscriptSnippet, Transcript, TranscriptList } from './transcript.js';
export * from './types.js';
export class YouTubeTranscriptApi {
    _httpClient;
    _fetcher;
    constructor(proxyConfig = null, httpClient = null) {
        this._httpClient = httpClient || axios.create({
            headers: {
                'Accept-Language': 'en-US'
            }
        });
        if (proxyConfig) {
            if (proxyConfig.proxy) {
                this._httpClient.defaults.proxy = proxyConfig.proxy;
            }
            if (proxyConfig.preventKeepingConnectionsAlive) {
                this._httpClient.defaults.headers['Connection'] = 'close';
            }
            if (proxyConfig.retriesWhenBlocked && proxyConfig.retriesWhenBlocked > 0) {
                axiosRetry(this._httpClient, {
                    retries: proxyConfig.retriesWhenBlocked,
                    retryCondition: (error) => error.response?.status === 429
                });
            }
        }
        this._fetcher = new TranscriptListFetcher(this._httpClient, proxyConfig);
    }
    async fetch(videoId, languages = ['en'], preserveFormatting = false) {
        const transcriptList = await this.list(videoId);
        const transcript = transcriptList.findTranscript(languages);
        return transcript.fetch(preserveFormatting);
    }
    async list(videoId) {
        return this._fetcher.fetch(videoId);
    }
}