# YouTube Comments Scraper (`happy_b/youtube-comments-scraper`) Actor
Scrape YouTube comments with replies, timestamps, likes, hearts, pins, and verified badges.
- **URL**: https://apify.com/happy\_b/youtube-comments-scraper.md
- **Developed by:** [Happy B](https://apify.com/happy_b) (community)
- **Categories:** Social media, Videos
- **Stats:** 3 total users, 2 monthly users, 95.2% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
### What is YouTube Comments Extractor?
YouTube Comments Extractor scrapes comments from any public YouTube video with **complete, structured data** — ISO 8601 timestamps, exact like counts, creator hearts, pinned status, verified badges, and full reply threads with parent-child relationships.
Every comment comes with **precise, machine-readable fields** ready for analysis pipelines, databases, and spreadsheets.
#### Data points extracted per comment
| Field | Description | Example |
|-------|-------------|---------|
| `commentId` | Unique YouTube comment ID | `Ugzge340dBgB75hWBm54AaABAg` |
| `content` | Plain text comment body | `This song never gets old!` |
| `contentHtml` | HTML-formatted comment with links/formatting | `This song never gets old!` |
| `publishedAt` | ISO 8601 timestamp | `2025-04-22T19:05:08Z` |
| `likeCount` | Exact numeric like count | `209980` |
| `replyCount` | Number of replies to this comment | `960` |
| `isHearted` | Creator hearted this comment | `true` |
| `isPinned` | Comment is pinned by creator | `true` |
| `authorDisplayName` | Comment author's display name | `@YouTube` |
| `authorIsVerified` | Author has YouTube verification badge | `true` |
| `authorIsCreator` | Author is the video's channel owner | `false` |
| `parentCommentId` | Parent comment ID (for replies) | `Ugzge340dBgB75hWBm54AaABAg` |
| `replyLevel` | 0 = top-level comment, 1 = reply | `1` |
Plus: `updatedAt`, `isEdited`, `authorChannelId`, `authorChannelUrl`, `authorAvatarUrl`, `authorIsArtist`, `videoId`, `videoTitle`, `videoUrl`, `videoCommentCount`, `scrapeTimestamp`.
**24 fields per comment. Every field populated.**
### Why use this scraper?
#### Our Actor vs Top 3 YouTube Comment Actors
| Field | Us | Streamers | API Ninja | Deeper |
|-------|:--:|:---------:|:---------:|:------:|
| `publishedAt` ISO 8601 exact | ✅ | ❌ | ❌ | ❌ |
| `updatedAt` ISO 8601 | ✅ | ❌ | ❌ | ❌ |
| `isEdited` | ✅ | ❌ | ✅ | ❌ |
| `isPinned` | ✅ | ❌ | ✅ | ❌ |
| `isHearted` | ✅ | ✅ | ❌ | ❌ |
| `likeCount` exact integer | ✅ | ✅ | ❌ | ❌ |
| `replyLevel` (0/1) | ✅ | ❌ | ❌ | ❌ |
| Reply threading | ✅ | ✅ | ✅ | ❌ |
| `contentHtml` | ✅ | ❌ | ❌ | ❌ |
| `authorChannelId` | ✅ | ❌ | ✅ | ❌ |
| `authorChannelUrl` | ✅ | ❌ | ✅ | ❌ |
| `authorAvatarUrl` | ✅ | ❌ | ✅ | ❌ |
| `authorIsVerified` | ✅ | ❌ | ❌ | ❌ |
| `authorIsArtist` | ✅ | ❌ | ❌ | ❌ |
| `authorIsCreator` | ✅ | ✅ | ❌ | ❌ |
| `videoTitle` | ✅ | ✅ | ❌ | ❌ |
| `videoCommentCount` | ✅ | ✅ | ❌ | ❌ |
**Reply threading** — each reply has `parentCommentId` pointing to the comment it's replying to. You can rebuild the thread:
````
@YouTube: "can confirm: he never gave us up" ← parentCommentId: ""
└─ @Cheese: "Bro is 15 years late" ← parentCommentId: "Ugzge340d..."
└─ @SleepyBear: "Only took 15 years" ← parentCommentId: "Ugzge340d..."
@ochkalov: "1987: normal song, 2026: national anthem"
└─ @armin: "so true" ← parentCommentId: "UgxIOV-s..."
````
- **Incremental delivery** — Results appear in your dataset within seconds. Export anytime, don't wait for the run to finish.
- **From $0.50 per 1,000 items** — Volume discounts down to $0.25 on Business plan.
### Use cases
- **Brand monitoring** — Track what people say about your brand in competitor video comments. Filter by `authorIsCreator` to find official channel responses.
- **Sentiment analysis** — Feed complete comment text with ISO timestamps into your NLP pipeline. Replies give you conversation context that top-level-only scrapers miss.
- **Research & academia** — Extract large comment corpora with exact dates and engagement metrics for reproducible studies.
- **Content strategy** — Identify what resonates by sorting through high-engagement comments (`likeCount`, `isHearted`, `isPinned`).
- **Community management** — Find creator-hearted comments, pinned comments, and verified user interactions across multiple videos.
- **ML training data** — Structured JSON with 24 fields per comment, ready for classification, fine-tuning, or embedding pipelines.
### How much does it cost?
Each comment or reply counts as one item.
| Plan | Price per 1,000 items |
|------|----------------------|
| Free | $0.50 |
| Starter | $0.45 |
| Scale | $0.40 |
| Business | $0.25 |
| Scenario | Items | Cost |
|----------|-------|------|
| 1 video, 500 comments, no replies | 500 | $0.25 |
| 1 video, 100 comments, ~30 have replies (avg 5 each) | ~250 | $0.12 |
| 10 videos, 500 comments each, no replies | 5,000 | $2.50 |
| 1 video, 5,000 comments (Newest First) | 5,000 | $2.50 |
**Replies are opt-in.** With `includeReplies` off (default), you only pay for top-level comments. When enabled, each reply is a separate item. You control the maximum replies per comment with `maxRepliesPerComment`.
Apify also charges a small compute cost (CU) for the actor's runtime — typically under $0.01 for most runs.
### Input
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `videoUrls` | string[] | *required* | YouTube video URLs or bare video IDs. Supports youtube.com/watch, youtu.be, /shorts/, /embed/, /live/ formats. |
| `maxCommentsPerVideo` | integer | 500 | Maximum top-level comments to fetch per video (1-10,000). |
| `sortBy` | string | `relevance` | `relevance` (Top Comments) or `time` (Newest First). Top Comments is capped at ~1,200 by YouTube. Use Newest First for full extraction. |
| `includeReplies` | boolean | `false` | Fetch replies for each comment. Each reply counts as a billable item. |
| `maxRepliesPerComment` | integer | 50 | Maximum replies per comment (1-200). Only used when Include Replies is on. |
### Output example
Each item in the dataset is a single comment or reply:
```json
{
"commentId": "Ugzge340dBgB75hWBm54AaABAg",
"content": "Check out my channel https://youtube.com/@example",
"contentHtml": "Check out my channel https://youtube.com/@example",
"publishedAt": "2025-04-22T19:05:08Z",
"updatedAt": "2025-04-22T19:05:08Z",
"isEdited": false,
"likeCount": 209980,
"replyCount": 960,
"replyLevel": 0,
"isPinned": true,
"isHearted": true,
"authorDisplayName": "@YouTube",
"authorChannelId": "UCBR8-60-B28hp2BmDPdntcQ",
"authorChannelUrl": "https://www.youtube.com/channel/UCBR8-60-B28hp2BmDPdntcQ",
"authorAvatarUrl": "https://yt3.ggpht.com/...",
"authorIsVerified": true,
"authorIsCreator": false,
"authorIsArtist": false,
"videoId": "dQw4w9WgXcQ",
"videoTitle": "Rick Astley - Never Gonna Give You Up",
"videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"videoCommentCount": 3200000,
"scrapeTimestamp": "2026-04-01T12:00:00Z",
"parentCommentId": ""
}
````
A reply to this comment looks identical, except:
```json
{
"commentId": "Ugzge340dBgB75hWBm54AaABAg.AHE8_QAWJx9AHEjU2AWVXk",
"content": "Bro is 15 years late",
"replyLevel": 1,
"replyCount": 0,
"parentCommentId": "Ugzge340dBgB75hWBm54AaABAg",
"isPinned": false,
"likeCount": 1810,
"publishedAt": "2025-05-15T08:22:41Z"
}
```
Replies appear in the dataset directly after their parent comment, making thread reconstruction straightforward.
Download your results as **JSON**, **CSV**, **Excel**, **XML**, or **HTML** from the dataset tab, or access them via the [Apify API](https://docs.apify.com/api/v2#/reference/datasets).
### Good to know
**YouTube caps "Top Comments" at ~1,200 results.** This is a YouTube limitation on relevance-sorted comments for popular videos. If you need more than 1,200 comments, use `sortBy: "time"` (Newest First), which has no cap.
**Reply costs scale with discussion depth.** A video where most comments have 0-2 replies adds minimal cost. A viral video where top comments have 500+ replies each will produce many more billable items. Use `maxRepliesPerComment` to cap costs.
### Integrations
Connect this actor to your workflow with [Apify integrations](https://docs.apify.com/platform/integrations):
- **Make (Integromat)** — trigger workflows when new data is available
- **Zapier** — push comments to Google Sheets, Slack, or databases
- **GitHub** — store results in repositories
- **Google Drive** — export directly to spreadsheets
- **Webhooks** — notify your API when the run completes
- **Apify API** — programmatic access for custom pipelines
### Legal and personal data
This actor extracts publicly available data from YouTube. You should ensure your use of the extracted data complies with YouTube's [Terms of Service](https://www.youtube.com/t/terms), applicable data protection laws (GDPR, CCPA), and your jurisdiction's regulations regarding web scraping and data processing.
Comments are public content posted by users on a public platform. Author information (display names, channel URLs) is publicly visible on YouTube.
### Support
Found a bug or have a feature request? Open an issue on the [Issues tab](https://apify.com/happy_b/youtube-comments-scraper/issues/open) or contact us through Apify messaging.
# Actor input Schema
## `videoUrls` (type: `array`):
YouTube video URLs or video IDs to scrape comments from
## `maxCommentsPerVideo` (type: `integer`):
Maximum number of comments to fetch per video
## `sortBy` (type: `string`):
Comment sort order
## `includeReplies` (type: `boolean`):
Fetch replies to comments. Each reply counts as a separate item for billing.
## `maxRepliesPerComment` (type: `integer`):
Maximum number of replies per comment (only used when Include Replies is on)
## Actor input object example
```json
{
"videoUrls": [
"https://www.youtube.com/watch?v=dQw4w9WgXcQ"
],
"maxCommentsPerVideo": 500,
"sortBy": "relevance",
"includeReplies": false,
"maxRepliesPerComment": 50
}
```
# Actor output Schema
## `comments` (type: `string`):
No description
## `metadata` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"videoUrls": [
"https://www.youtube.com/watch?v=dQw4w9WgXcQ"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("happy_b/youtube-comments-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "videoUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"] }
# Run the Actor and wait for it to finish
run = client.actor("happy_b/youtube-comments-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"videoUrls": [
"https://www.youtube.com/watch?v=dQw4w9WgXcQ"
]
}' |
apify call happy_b/youtube-comments-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=happy_b/youtube-comments-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "YouTube Comments Scraper",
"description": "Scrape YouTube comments with replies, timestamps, likes, hearts, pins, and verified badges.",
"version": "0.3",
"x-build-id": "n9NIm6TvvHjmc6HP4"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/happy_b~youtube-comments-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-happy_b-youtube-comments-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/happy_b~youtube-comments-scraper/runs": {
"post": {
"operationId": "runs-sync-happy_b-youtube-comments-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/happy_b~youtube-comments-scraper/run-sync": {
"post": {
"operationId": "run-sync-happy_b-youtube-comments-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"videoUrls"
],
"properties": {
"videoUrls": {
"title": "Video URLs",
"type": "array",
"description": "YouTube video URLs or video IDs to scrape comments from",
"items": {
"type": "string"
}
},
"maxCommentsPerVideo": {
"title": "Max Comments Per Video",
"minimum": 1,
"type": "integer",
"description": "Maximum number of comments to fetch per video",
"default": 500
},
"sortBy": {
"title": "Sort By",
"enum": [
"relevance",
"time"
],
"type": "string",
"description": "Comment sort order",
"default": "relevance"
},
"includeReplies": {
"title": "Include Replies",
"type": "boolean",
"description": "Fetch replies to comments. Each reply counts as a separate item for billing.",
"default": false
},
"maxRepliesPerComment": {
"title": "Max Replies Per Comment",
"minimum": 1,
"type": "integer",
"description": "Maximum number of replies per comment (only used when Include Replies is on)",
"default": 50
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```