youtube-comment-downloader

English | 中文

Simple script for downloading Youtube comments without using the Youtube API. The output is in line delimited JSON.

Node.js/TypeScript port of egbertbouman/youtube-comment-downloader with added proxy support.

Installation

Install this package via pnpm (recommended):

pnpm add youtube-comment-downloader

Or using npm:

npm install youtube-comment-downloader

For global CLI usage:

pnpm add -g youtube-comment-downloader
# or
npm install -g youtube-comment-downloader

Usage as command-line interface

$ youtube-comment-downloader --help
Usage: youtube-comment-downloader [options]

Download Youtube comments without using the Youtube API

Options:
  -y, --youtubeid <id>     ID of Youtube video for which to download the comments
  -u, --url <url>          Youtube URL for which to download the comments
  -o, --output <file>      Output filename (output format is line delimited JSON)
  -p, --pretty             Change the output format to indented JSON
  -l, --limit <number>     Limit the number of comments
  -a, --language <lang>    Language for Youtube generated text (e.g. en)
  --proxy <uri>            Proxy URI (e.g. http://user:pass@proxy.example.com:8080)
  -s, --sort <number>      Whether to download popular (0) or recent comments (1). Defaults to 1
  -h, --help               display help for command

Examples

Download comments using video URL:

youtube-comment-downloader --url https://www.youtube.com/watch?v=ScMzIvxBSi4 --output ScMzIvxBSi4.json

Download comments using video ID:

youtube-comment-downloader --youtubeid ScMzIvxBSi4 --output ScMzIvxBSi4.json

Download with pretty formatting:

youtube-comment-downloader --youtubeid ScMzIvxBSi4 --output ScMzIvxBSi4.json --pretty

Download only first 100 comments:

youtube-comment-downloader --youtubeid ScMzIvxBSi4 --output ScMzIvxBSi4.json --limit 100

Download popular comments instead of recent:

youtube-comment-downloader --youtubeid ScMzIvxBSi4 --output ScMzIvxBSi4.json --sort 0

Download using proxy:

youtube-comment-downloader --youtubeid ScMzIvxBSi4 --output ScMzIvxBSi4.json --proxy http://proxy.example.com:8080

Download using proxy with authentication:

youtube-comment-downloader --youtubeid ScMzIvxBSi4 --output ScMzIvxBSi4.json --proxy http://username:password@proxy.example.com:8080

For Youtube IDs starting with - (dash), use the = syntax:

youtube-comment-downloader --youtubeid=-idwithdash --output output.json

Usage as library

You can also use this package programmatically in your Node.js/TypeScript projects:

JavaScript Example

const { YoutubeCommentDownloader, SORT_BY_POPULAR } = require('youtube-comment-downloader');

async function downloadComments() {
  const downloader = new YoutubeCommentDownloader();
  
  // Download comments from URL
  const comments = downloader.getCommentsFromUrl(
    'https://www.youtube.com/watch?v=ScMzIvxBSi4',
    SORT_BY_POPULAR
  );
  
  // Print first 10 comments
  let count = 0;
  for await (const comment of comments) {
    console.log(comment);
    if (++count >= 10) break;
  }
}

downloadComments();

TypeScript Example

import { YoutubeCommentDownloader, SORT_BY_POPULAR, Comment } from 'youtube-comment-downloader';

async function downloadComments(): Promise<void> {
  const downloader = new YoutubeCommentDownloader();
  
  // Download comments from video ID
  const comments = downloader.getComments('ScMzIvxBSi4', SORT_BY_POPULAR);
  
  // Collect all comments
  const allComments: Comment[] = [];
  for await (const comment of comments) {
    allComments.push(comment);
  }
  
  console.log(`Downloaded ${allComments.length} comments`);
}

downloadComments();

Download with proxy support

import { YoutubeCommentDownloader, SORT_BY_RECENT, Comment } from 'youtube-comment-downloader';

async function downloadWithProxy(): Promise<void> {
  // Create downloader with proxy configuration
  const downloader = new YoutubeCommentDownloader({
    proxy: { uri: 'http://proxy.example.com:8080' }
  });
  
  // Download comments using proxy
  const comments = downloader.getComments('ScMzIvxBSi4', SORT_BY_RECENT);
  
  for await (const comment of comments) {
    console.log(`${comment.author}: ${comment.text}`);
  }
}

downloadWithProxy();

Download with language preference

const { YoutubeCommentDownloader, SORT_BY_RECENT } = require('youtube-comment-downloader');

async function downloadWithLanguage() {
  const downloader = new YoutubeCommentDownloader();
  
  // Download comments with English language preference
  const comments = downloader.getComments(
    'ScMzIvxBSi4',
    SORT_BY_RECENT,
    'en'  // Language code
  );
  
  for await (const comment of comments) {
    console.log(`${comment.author}: ${comment.text}`);
  }
}

API Reference