youtube-captions-api 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Andrew Njoo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# youtube-captions-api
+
+A reliable, self-contained Node.js/TypeScript port of the popular Python [youtube-transcript-api](https://github.com/jdepoix/youtube-transcript-api) (as of December 2025).
+
+This is **mostly an AI-generated port** (created with assistance from Grok by xAI), faithfully replicating the Python library's core logic, error handling, consent handling, and reliability.
+
+Fetches **timed transcripts** (manual or auto-generated) using YouTube's internal Innertube API — no official API key required.
+
+> **Warning**: This uses undocumented endpoints. It may break if YouTube changes their internals.
+
+## Features
+
+- Instance-based API (`new YouTubeTranscriptApi()`)
+- `fetch(videoIdOrUrl, { languages })` → timed segments with start/duration
+- Language priority (prefers manual captions over auto-generated)
+- Consent cookie handling
+- Proxy support for production/cloud use
+- Full concatenated text via `.getText()`
+- Debug logging of transcript URL
+- Minimal dependencies (only `undici`)
+
+## Installation
+
+```bash
+npm install youtube-captions-api
+```
+
+## Usage
+
+```ts
+import YouTubeTranscriptApi from 'youtube-captions-api';
+
+(async () => {
+  try {
+    // Optional: use a residential proxy for cloud deployments (highly recommended)
+    // const api = new YouTubeTranscriptApi('http://user:pass@residential-ip:port');
+
+    const api = new YouTubeTranscriptApi();
+
+    const transcript = await api.fetch('dQw4w9WgXcQ', {
+      languages: ['en'], // priority list – falls back automatically
+    });
+
+    // First timed segment
+    console.log(transcript.snippets[0]);
+    // → { text: "We're no strangers to love", start: 12.5, duration: 3.2 }
+
+    // Full concatenated text
+    console.log(transcript.getText());
+
+    // Metadata
+    console.log('Language:', transcript.language_code);
+    console.log('Auto-generated:', transcript.is_generated);
+    console.log('Segments count:', transcript.snippets.length);
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : err);
+  }
+})();
+```
+
+## Express Server Example
+
+See `server.js` in the repo for a ready-to-run API endpoint:
+
+```
+GET /transcript?id=dQw4w9WgXcQ
+→ { video_id, text, language, timed_segments: [{ timestamp, seconds, text }, ...] }
+```
+
+Run:
+```bash
+npm run build
+node server.js
+```
+
+Test: `http://localhost:3000/transcript?id=dQw4w9WgXcQ`
+
+## Production Notes
+
+- Works reliably **locally** on residential IPs.
+- In cloud/server environments, YouTube frequently blocks datacenter IPs → use **rotating residential proxies** (e.g., Webshare, Bright Data, Oxylabs).
+- Simply pass the proxy URL to the constructor when deploying.
+
+## License
+
+MIT
+
+Inspired by the excellent Python original — huge thanks to [jdepoix](https://github.com/jdepoix)!

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export interface TranscriptSnippet {
+    text: string;
+    start: number;
+    duration: number;
+}
+export type FetchedTranscript = {
+    snippets: TranscriptSnippet[];
+    video_id: string;
+    language: string;
+    language_code: string;
+    is_generated: boolean;
+    getText(): string;
+    toRawData(): Array<{
+        text: string;
+        start: number;
+        duration: number;
+    }>;
+};
+export interface TranscriptOptions {
+    languages?: string[];
+    proxy?: string;
+}
+export declare class NoTranscriptFound extends Error {
+    constructor(message?: string);
+}
+export declare class TranscriptsDisabled extends Error {
+    constructor();
+}
+export declare class YouTubeTranscriptApi {
+    private dispatcher?;
+    private headers;
+    constructor(proxy?: string);
+    private static extractVideoId;
+    fetch(videoIdOrUrl: string, options?: TranscriptOptions): Promise<FetchedTranscript>;
+}
+export default YouTubeTranscriptApi;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IAEtB,OAAO,IAAI,MAAM,CAAC;IAClB,SAAS,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAAwB;CAI5C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,OAAO,CAIb;gBAEU,KAAK,CAAC,EAAE,MAAM;IAM1B,OAAO,CAAC,MAAM,CAAC,cAAc;IAcvB,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAgI/F;AAED,eAAe,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,156 @@
+// src/index.ts
+import { fetch, ProxyAgent } from "undici";
+export class NoTranscriptFound extends Error {
+    constructor(message = "No transcript found") {
+        super(message);
+        this.name = "NoTranscriptFound";
+    }
+}
+export class TranscriptsDisabled extends Error {
+    constructor() {
+        super("Transcripts are disabled for this video");
+        this.name = "TranscriptsDisabled";
+    }
+}
+export class YouTubeTranscriptApi {
+    dispatcher;
+    headers = {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+        "Accept-Language": "en-US,en;q=0.9",
+    };
+    constructor(proxy) {
+        if (proxy) {
+            this.dispatcher = new ProxyAgent(proxy);
+        }
+    }
+    static extractVideoId(idOrUrl) {
+        const patterns = [
+            /[?&]v=([^&]+)/,
+            /youtube\.com\/shorts\/([^/?]+)/,
+            /youtu\.be\/([^/?]+)/,
+            /embed\/([^/?]+)/,
+        ];
+        for (const pat of patterns) {
+            const match = pat.exec(idOrUrl);
+            if (match)
+                return match[1];
+        }
+        return idOrUrl.length === 11 ? idOrUrl : "";
+    }
+    async fetch(videoIdOrUrl, options = {}) {
+        const videoId = YouTubeTranscriptApi.extractVideoId(videoIdOrUrl);
+        if (!videoId)
+            throw new Error("Invalid YouTube video ID or URL");
+        const languages = options.languages?.length ? options.languages : ["en"];
+        // 1. Fetch watch page
+        const watchUrl = `https://www.youtube.com/watch?v=${videoId}&hl=en`;
+        const watchRes = await fetch(watchUrl, {
+            headers: this.headers,
+            dispatcher: this.dispatcher,
+        });
+        if (!watchRes.ok)
+            throw new Error(`Failed to load watch page: ${watchRes.status}`);
+        const html = await watchRes.text();
+        // Handle consent cookie
+        if (html.includes('action="https://consent.youtube.com/s"')) {
+            const consentMatch = html.match(/name="v" value="(.*?)"'/);
+            if (consentMatch) {
+                this.headers["Cookie"] = `CONSENT=YES+${consentMatch[1]}`;
+            }
+        }
+        // 2. Extract Innertube API key
+        const apiKeyMatch = html.match(/"INNERTUBE_API_KEY":"([^"]+)"/);
+        if (!apiKeyMatch)
+            throw new Error("Could not extract Innertube API key");
+        const apiKey = apiKeyMatch[1];
+        // 3. POST to Innertube /player (WEB client)
+        const playerRes = await fetch(`https://www.youtube.com/youtubei/v1/player?key=${apiKey}`, {
+            method: "POST",
+            headers: { ...this.headers, "Content-Type": "application/json" },
+            body: JSON.stringify({
+                context: {
+                    client: {
+                        clientName: "WEB",
+                        clientVersion: "2.20241222.01.00",
+                    },
+                },
+                videoId,
+            }),
+            dispatcher: this.dispatcher,
+        });
+        if (!playerRes.ok)
+            throw new Error(`Innertube request failed: ${playerRes.status}`);
+        const data = await playerRes.json();
+        // 4. Check playability
+        const playability = data.playabilityStatus;
+        if (playability?.status !== "OK") {
+            throw new Error(playability?.reason || "Video unplayable");
+        }
+        // 5. Get caption tracks
+        const captionTracks = data.captions?.playerCaptionsTracklistRenderer?.captionTracks;
+        if (!captionTracks || captionTracks.length === 0) {
+            throw new TranscriptsDisabled();
+        }
+        // 6. Select best track
+        let selectedTrack = null;
+        for (const lang of languages) {
+            selectedTrack =
+                captionTracks.find((t) => t.languageCode === lang && t.kind !== "asr") ||
+                    captionTracks.find((t) => t.languageCode === lang);
+            if (selectedTrack)
+                break;
+        }
+        if (!selectedTrack) {
+            throw new NoTranscriptFound(`No transcript found for languages: ${languages.join(", ")}`);
+        }
+        // 7. Clean baseUrl
+        let captionUrl = selectedTrack.baseUrl
+            .replace(/&fmt=srv\d*/g, "")
+            .replace(/&fmt=\w+$/, "")
+            .trim();
+        console.log(`[DEBUG] Transcript URL: ${captionUrl}`);
+        // 8. Fetch transcript XML
+        const captionRes = await fetch(captionUrl, {
+            headers: this.headers,
+            dispatcher: this.dispatcher,
+        });
+        if (!captionRes.ok) {
+            throw new Error(`Failed to fetch transcript: ${captionRes.status}`);
+        }
+        const xml = await captionRes.text();
+        if (!xml.trim() || !xml.includes("<text")) {
+            throw new NoTranscriptFound("Transcript data is empty");
+        }
+        // 9. Parse XML with regex (compatible with all TS targets)
+        const regex = /<text start="([^"]+)" dur="([^"]+)">([^<]+)<\/text>/g;
+        const snippets = [];
+        let match;
+        while ((match = regex.exec(xml)) !== null) {
+            snippets.push({
+                text: match[3].replace(/&amp;#39;/g, "'").trim(),
+                start: parseFloat(match[1]),
+                duration: parseFloat(match[2]),
+            });
+        }
+        if (snippets.length === 0) {
+            throw new NoTranscriptFound("No segments found after parsing");
+        }
+        // 10. Return transcript object
+        const transcript = {
+            snippets,
+            video_id: videoId,
+            language: selectedTrack.name?.runs?.[0]?.text || selectedTrack.languageCode,
+            language_code: selectedTrack.languageCode,
+            is_generated: selectedTrack.kind === "asr",
+            getText() {
+                return this.snippets.map((s) => s.text).join(" ");
+            },
+            toRawData() {
+                return this.snippets.map((s) => ({ text: s.text, start: s.start, duration: s.duration }));
+            },
+        };
+        return transcript;
+    }
+}
+export default YouTubeTranscriptApi;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "youtube-captions-api",
+  "version": "1.0.1",
+  "description": "Reliable YouTube transcript fetcher for Node.js — port of the popular Python youtube-transcript-api (2025 edition)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "youtube",
+    "transcript",
+    "captions",
+    "subtitles",
+    "innertube",
+    "youtube-transcript-api"
+  ],
+  "author": "Your Name <your.email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adnjoo/youtube-transcript-api-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/adnjoo/youtube-transcript-api-node/issues"
+  },
+  "homepage": "https://github.com/adnjoo/youtube-transcript-api-node#readme",
+  "dependencies": {
+    "undici": "^7.16.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}