# Youtube Comment Scraper (`scrapeai/youtube-comment-scraper`) Actor Extract YouTube comments from one or more videos without API limits. Get full comment text, date, author, video title, and video ID. Download results in JSON, CSV, or Excel. - **URL**: https://apify.com/scrapeai/youtube-comment-scraper.md - **Developed by:** [ScrapeAI](https://apify.com/scrapeai) (community) - **Categories:** Videos, Social media, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing $5.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 ๐Ÿง  YouTube Comment Scraper This Apify actor automatically scrapes comments from YouTube videos. It extracts structured comment data such as author, text, timestamps, likes, and more โ€” perfect for social media analysis, sentiment research, and community engagement studies. โœ… Use Cases ๐Ÿ“Š Analyze audience sentiment and feedback ๐Ÿ’ฌ Monitor community discussions and trends ๐Ÿท๏ธ Perform content analysis and engagement studies ๐Ÿงญ Conduct competitive analysis on video performance ๐Ÿ“ฅ Input Configuration You can customize the actor using the following input fields: ```json { "videoUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"], "maxComments": 100 } ```` ๐Ÿงพ Fields Explained Field Type Description videoUrls array List of YouTube video URLs to scrape comments from maxComments number Maximum number of comments to extract from each video ๐Ÿ“ค Output The actor returns a dataset containing an array of video objects with their comments. Each record includes video details and an array of extracted comments. ๐Ÿงฉ Sample Output ```json [ { "videoId": "dQw4w9WgXcQ", "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)", "channelName": "Rick Astley", "channelUrl": "https://www.youtube.com/@RickAstley", "publishedDate": "2009-10-25", "views": 1234567890, "likes": 15000000, "commentCount": 100, "duration": "3:33", "description": "The official video for "Never Gonna Give You Up" by Rick Astley.", "comments": [ { "commentId": "Ugx1aBcD2efGhiJkl", "author": "John Doe", "authorChannelUrl": "https://www.youtube.com/@JohnDoe", "commentText": "Still a classic! โค๏ธ", "publishedTime": "1 day ago", "likeCount": 420, "replyCount": 2 }, { "commentId": "Ugx2bCdE3fGhIjKlM", "author": "MusicLover123", "authorChannelUrl": "https://www.youtube.com/@MusicLover123", "commentText": "I came here again in 2025. Still legendary!", "publishedTime": "3 hours ago", "likeCount": 128, "replyCount": 0 } ] } ] ``` ๐Ÿ”’ Proxy Configuration This actor uses Apify Proxy automatically to: Avoid IP-based rate limiting or bans Ensure stable scraping at scale Default proxy settings use: ```json { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } ``` ๐Ÿš€ How to Use Open the actor in Apify Console Click "Try actor" or create a new task Enter your YouTube video URLs and max comments Run the actor Download your comment data in JSON, CSV, or Excel format โš™๏ธ Advanced Input Example ```json { "videoUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"], "maxComments": 100, "headless": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }, "maxConcurrency": 5, "minDelayBetweenRequestsMs": 1000, "maxRequestRetries": 3, "requestHandlerTimeoutSecs": 60 } ``` ๐Ÿ› ๏ธ Tech Stack ๐Ÿงฉ Apify SDK โ€” for actor and data handling ๐Ÿ•ท๏ธ Crawlee โ€” for robust crawling and scraping ๐ŸŒ Puppeteer โ€” for browser automation and rendering dynamic content โš™๏ธ Node.js โ€” fast, scalable backend environment # Actor input Schema ## `videoUrls` (type: `array`): List of YouTube video URLs to scrape comments from ## `maxComments` (type: `integer`): Maximum number of comments to extract from each video ## `headless` (type: `boolean`): Run browser in headless mode (no visible UI). Set to false for debugging. ## `proxyConfiguration` (type: `object`): Optionally, use Apify Proxy or custom HTTP proxy to avoid IP address-based blocking. ## `maxConcurrency` (type: `integer`): Maximum number of concurrent requests ## `minDelayBetweenRequestsMs` (type: `integer`): Minimum delay between requests in milliseconds ## `maxRequestRetries` (type: `integer`): Maximum number of retries for failed requests ## `requestHandlerTimeoutSecs` (type: `integer`): Timeout for request handler in seconds ## Actor input object example ```json { "videoUrls": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ], "maxComments": 100, "headless": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxConcurrency": 5, "minDelayBetweenRequestsMs": 1000, "maxRequestRetries": 3, "requestHandlerTimeoutSecs": 60 } ``` # 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" ], "maxComments": 100, "headless": true }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeai/youtube-comment-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"], "maxComments": 100, "headless": True, } # Run the Actor and wait for it to finish run = client.actor("scrapeai/youtube-comment-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" ], "maxComments": 100, "headless": true }' | apify call scrapeai/youtube-comment-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeai/youtube-comment-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Youtube Comment Scraper", "description": "Extract YouTube comments from one or more videos without API limits. Get full comment text, date, author, video title, and video ID. Download results in JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "SGyd7kAsP7co2LGLg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeai~youtube-comment-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeai-youtube-comment-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/scrapeai~youtube-comment-scraper/runs": { "post": { "operationId": "runs-sync-scrapeai-youtube-comment-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/scrapeai~youtube-comment-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeai-youtube-comment-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", "proxyConfiguration" ], "properties": { "videoUrls": { "title": "Video URLs", "type": "array", "description": "List of YouTube video URLs to scrape comments from", "items": { "type": "string" }, "default": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ] }, "maxComments": { "title": "Max Comments", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of comments to extract from each video", "default": 100 }, "headless": { "title": "Headless Mode", "type": "boolean", "description": "Run browser in headless mode (no visible UI). Set to false for debugging.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optionally, use Apify Proxy or custom HTTP proxy to avoid IP address-based blocking.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "type": "integer", "description": "Maximum number of concurrent requests", "default": 5 }, "minDelayBetweenRequestsMs": { "title": "Min Delay Between Requests (ms)", "minimum": 0, "type": "integer", "description": "Minimum delay between requests in milliseconds", "default": 1000 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 0, "type": "integer", "description": "Maximum number of retries for failed requests", "default": 3 }, "requestHandlerTimeoutSecs": { "title": "Request Handler Timeout (secs)", "minimum": 1, "type": "integer", "description": "Timeout for request handler in seconds", "default": 60 } } }, "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 } } } } } } } } } } ```