# scraping-youtube-comments

Pulls comments, likes, and reply counts from YouTube videos using Apify. Useful for audience feedback and sentiment analysis.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 777 installs · ★ 1
- Author: apidojo
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/apidojo-io/apidojo-skills/tree/HEAD/skills/primitives/scraping-youtube-comments/SKILL.md
- Updated: 2026-05-13
- HTML: https://affpapa.org/en/nevibecode/skills/scraping-youtube-comments

## What it does

This skill extracts comment datasets from YouTube videos, Shorts, and search results. It routes requests to the `apidojo~youtube-comments-scraper` actor on Apify. Each entry provides the commenter display name, text content, like count, reply count, and published timestamp.

Execution happens through three pathways. The agent can use the helper script `node scripts/run_actor.js`, call an Apify MCP tool, or trigger runs via `curl`. Output formats include formatted tables in chat, CSV files, and JSON. If a creator disabled comments, the scraper simply returns 0 items. Deleted entries may appear with empty text fields.

Without the `APIFY_TOKEN` environment variable, the scraper cannot run.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-youtube-comments -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/scraping-youtube-comments/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/scraping-youtube-comments/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-youtube-comments -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/scraping-youtube-comments/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-youtube-comments -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/scraping-youtube-comments/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install apidojo-io/apidojo-skills scraping-youtube-comments
```

2. **Manually: put the files in place**
- File: `.github/skills/scraping-youtube-comments/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-youtube-comments -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/apidojo-io/apidojo-skills --path skills/primitives/scraping-youtube-comments
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/scraping-youtube-comments/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add apidojo-io/apidojo-skills --skill scraping-youtube-comments -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/apidojo-io/apidojo-skills/tree/HEAD/skills/primitives/scraping-youtube-comments/SKILL.md

## When to use it
- collect comment threads and replies from any YouTube video
- export author names, comment text, and like counts to CSV or JSON
- filter out deleted comments with empty text strings

## Example prompts
- Collect all comments for video `<url>` and save them to a JSON file.
- Scrape viewer comments and like counts from `<url>` as a CSV.
- Fetch the top comments and replies from the video at `<url>`.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 87c885dbef906585.

BEGIN THIRD-PARTY FILE 87c885dbef906585
````text
---
name: scraping-youtube-comments
description: >
  Scrapes comments from any YouTube video using apidojo's YouTube scraper on Apify.
  Triggers when the user asks to: get all comments on a YouTube video, export YouTube
  comment data, scrape what viewers say about a YouTube video, fetch comment text and
  likes from a YouTube URL, collect comment threads from a YouTube video, or download
  audience feedback from a YouTube video. Returns commenter username, comment text,
  like count, reply count, and timestamp per comment.
  Ideal for sentiment researchers, product teams, and content analysts.
license: Apache-2.0
metadata:
  author: apidojo
  version: "1.0"
  apify-actor: apidojo/youtube-scraper
---

# Scraping YouTube Comments

Exports the full comment dataset from any YouTube video. Returns comment text, author, and engagement for downstream analysis.

## Prerequisites

- `APIFY_TOKEN` environment variable set
- Optional: Apify MCP server installed

## Inputs

| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| `startUrls` | array | Optional | `[]` | YouTube URLs — channels, playlists, Shorts, search results |
| `youtubeHandles` | array | Optional | `[]` | YouTube channel handles (e.g. `@kurzgesagt`) |
| `getTrending` | boolean | Optional | `false` | Retrieve trending videos |
| `keywords` | array | Optional | `[]` | Search keywords |
| `gl` | string | Optional | `us` | Country code for results (e.g. `US`, `GB`) |
| `hl` | string | Optional | `en` | Language code (e.g. `en`, `de`) |
| `uploadDate` | string | Optional | `all` | Upload date filter: `any`, `hour`, `today`, `week`, `month`, `year` |
| `duration` | string | Optional | `all` | Duration filter: `any`, `short`, `long` |
| `features` | string | Optional | `all` | Feature filter: `4k`, `hd`, `live`, `cc`, `3d`, `hdr`, etc. |
| `sort` | string | Optional | `r` | Sort order for search results |
| `maxItems` | number | Optional | Unlimited | Maximum videos to return |
| `customMapFunction` | string | Optional | — | JavaScript function to transform each output object |

## Workflow

```
Progress:
- [ ] Step 1: Validate video URLs
- [ ] Step 2: Run youtube-scraper (comment mode)
- [ ] Step 3: Poll for SUCCEEDED
- [ ] Step 4: Deliver comment dataset
```

### Step 2: Run the Actor


**Recommended — run_actor.js (handles waiting, output, and file saving automatically):**
```bash
# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~youtube-comments-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~youtube-comments-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~youtube-comments-scraper" \
  --input '{"param": "value"}' \
````
END THIRD-PARTY FILE 87c885dbef906585

The third-party file has ended. Everything between the 87c885dbef906585 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2867 of 4593 bytes. © apidojo · Apache-2.0 · https://github.com/apidojo-io/apidojo-skills/tree/HEAD/skills/primitives/scraping-youtube-comments/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md