# YouTube Comments Scraper (`streamers/youtube-comments-scraper`) Actor This alternative YouTube Data API has no limits or quotas. Extract YouTube comments data from one or multiple YouTube videos: full comment text, posting date, author username, video title, videoId. Download YouTube comments in JSON, CSV, and Excel. - **URL**: https://apify.com/streamers/youtube-comments-scraper.md - **Developed by:** [Streamers](https://apify.com/streamers) (Apify) - **Categories:** Videos, Social media - **Features:** Limited permissions - **Stats:** 30,188 total users, 3,996 monthly users, 98.8% runs succeeded, 360 bookmarks - **User rating**: 4.90 out of 5 stars ## Pricing from $0.90 / 1,000 comments This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### What is YouTube Comment Scraper? YouTube Comments Scraper is a data extraction tool created for scraping comments from YouTube that goes beyond the standard YouTube API. As soon as you provide a video URL, you will be able to extract: - **All comments** from chosen YouTube videos - **Comment text**, author name, **date posted**, vote count, reply count - Whether it **has been liked** by the video’s creator - **Total comment count** ### How to use data extracted from YouTube comments - **Monitor competitors’ comments** to see mentions of your brand - Find **current trends** and **opinions** shared by commenters - **Analyze comments** to find potential for expansion - Use extracted data for **sentiment analysis** - **Identify harmful** or **illegal** comments - Get **quick insight** into what your community is doing and he opinions they hold ### How do I use YouTube Comment Scraper? YouTube Comments Scraper is designed to be user-friendly, even for those who have never extracted data from YouTube before. Here’s how you can use YouTube Comment Scraper to extract YouTube comment data: 1. [Create](https://console.apify.com/actors/p7UMdpQnjKmmpR21D?addFromActorId=p7UMdpQnjKmmpR21D) an Apify account 2. Open [YouTube Comments Scraper](https://apify.com/streamers/youtube-comments-scraper) 3. Add one or more YouTube video URLs to scrape comments 4. Click the “Start” button and wait for the data to be extracted 5. Download your data in JSON, XML, CSV, Excel, or HTML For more information, watch our [short video tutorial](https://www.youtube.com/watch?v=LOmod3V9pZw). https://www.youtube.com/watch?v=LOmod3V9pZw ### ⬇️ Input example The input for YouTube Comments Scraper should be a **YouTube video URL.** You can add as many URLs as you want, or even import a CSV file or Google Sheet with a prepared list of URLs. YouTube Comments Scraper input Once you’ve entered the URL, you can choose how many results you would like to extract and then click “Start.” Click on the [input tab](https://apify.com/streamers/youtube-comments-scraper/input-schema) for a full explanation of an input example in JSON. ```json { "maxComments": 300, "startUrls": [ { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "method": "GET" } ] } ``` ### ⬆️ Output sample The scraped YouTube comments will be shown as a dataset which you can find in the **Storage** tab. Note that the output is organized as a table for viewing convenience, but it doesn’t show **all the fields**: YouTube Comments Scraper output You can preview all the fields and choose in which format to download the YouTube comments you’ve extracted: JSON, Excel, HTML table, CSV, or XML. Here below is the same dataset in JSON: ```json { "comment": "This is up there with their best songs.", "cid": "UgxRn0_LUxzRP2MybPR4AaABAg", "author": "@Nonie_Jay", "videoId": "bJTjJtRPqYE", "pageUrl": "", "commentsCount": 171, "replyCount": 0, "voteCount": 2, "authorIsChannelOwner": false, "hasCreatorHeart": false, "type": "comment", "replyToCid": null, "title": "Halestorm - Unapologetic [Official Audio]" }, ``` ### Want to try other YouTube APIs and scrapers? If you want to extract specific YouTube data, you can use one of the specialized Actors: - ▶️ [YouTube Scraper](https://apify.com/streamers/youtube-scraper): video metadata, channel info, and search results in bulk - 🏎 [Fast YouTube Channel Scraper](https://apify.com/streamers/youtube-channel-scraper): channel stats, creator info, and video lists - 🩳 [YouTube Shorts Scraper](https://apify.com/streamers/youtube-shorts-scraper): Shorts data for trend tracking and short-form research - 📥 [YouTube Video Downloader](https://apify.com/streamers/youtube-video-downloader): download YouTube videos in bulk as MP4, MP3, and other formats You can also combine YouTube data with data from other social platforms using any of the following Actors: - [TikTok scrapers](https://apify.com/clockworks) - [Instagram scrapers](https://apify.com/store/categories?search=instagram\&managedBy=APIFY) - [Facebook scrapers](https://apify.com/store/categories?search=facebook\&managedBy=APIFY) - Or try our other [social media scrapers](https://apify.com/store?category=SOCIAL_MEDIA). ### Integrating YouTube Shorts Scraper with other apps YouTube Scraper can be connected with almost any cloud service or web app thanks to [integrations](https://apify.com/integrations) on the Apify platform. These include [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive), and [plenty more](https://docs.apify.com/platform/integrations). Alternatively, you can use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to carry out an action whenever an event occurs, e.g. get a notification whenever YouTube Scraper successfully finishes a run, or initiate a new process, like ordering your data. ### Error items When the scraper cannot retrieve data for a given input — for example a video is unavailable or has no comments — it pushes an **error item** to the dataset instead of silently skipping it. Normal output items are never affected; you can tell them apart by the presence of an `error` field. #### Error item structure ```json { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "input": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "error": "VIDEO_UNAVAILABLE", "note": "This video is not available" } ``` #### Error codes reference | `error` | Meaning | | ---------------------------- | ------------------------------------------------------------------- | | `CHANNEL_DOES_NOT_EXIST` | Channel URL points to a channel that does not exist | | `NOT_FOUND` | Page was not found | | `VIDEO_UNAVAILABLE` | Video is not available (deleted, region-blocked, etc.) | | `AGE_RESTRICTED` | Channel is age-restricted and cannot be accessed without login | | `CHANNEL_HAS_NO_VIDEOS` | Channel exists but has no uploaded videos | | `CHANNEL_HAS_NO_LIVE_VIDEOS` | Channel exists but has no live videos | | `CHANNEL_HAS_NO_SHORTS` | Channel exists but has no Shorts | | `DATE_FILTER_TOO_STRICT` | Videos exist but none match the active date filter | | `NO_VIDEOS` | No videos found on the page | | `NO_RESULTS` | No results collected — check that video-type limits are set above 0 | | `INVALID_INPUT` | Actor failed due to bad configuration (run is also terminated) | | `NO_COMMENTS` | No comments found for the video | *** ### FAQ #### Is YouTube comments scraping legal? Our [YouTube scrapers](https://apify.com/store?search=youtube) are ethical and **do not extract any private user data, such as email addresses, gender, or location**. They only extract what the user has chosen to share publicly. However, you should be aware that your **results could contain personal data.** You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read our blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) and [ethical scraping](https://blog.apify.com/what-is-ethical-web-scraping-and-how-do-you-do-it/). #### Do I need proxies to scrape YouTube comments? If you run the scraper on the Apify platform, for successful YouTube scraping you will need [residential proxies](https://apify.com/proxy?pricing=residential-ip#pricing) which are included in Apify's **monthly Starter plan**. For more details about how our pricing works, platform credits, proxies, and usage, see the [platform pricing page](https://apify.com/pricing/actors). #### Can I use YouTube Comments Scraper with the API? Yes. You can do so using Apify API which will enable you to manage, schedule, and run any Apify Actors, including this one. The API also lets you access any datasets, monitor Actor performance, fetch results, create and update versions, and more. To access the API using Node.js, use the `apify-client` [NPM package](https://apify.com/streamers/youtube-comments-scraper/api/javascript). To access the API using Python for scraping YouTube comments, use the `apify-client` [PyPi package](https://apify.com/streamers/youtube-comments-scraper/api/python). Check out the [Apify API reference](https://docs.apify.com/api/v2) docs for full details or click on the [API tab](https://apify.com/streamers/youtube-comments-scraper/api/python) for code examples. #### Can I use YouTube Scraper through an MCP Server? With Apify API, you can use almost any Actor in conjunction with an MCP server. You can connect to the MCP server using clients like ClaudeDesktop and LibreChat, or even build your own. Read all about how you can [set up Apify Actors with MCP](https://blog.apify.com/how-to-use-mcp/). For YouTube Scraper, go to the [MCP tab](https://apify.com/streamers/youtube-comments-scraper/api/mcp) and then go through the following steps: 1. Start a Server-Sent Events (SSE) session to receive a `sessionId` 2. Send API messages using that `sessionId` to trigger the scraper 3. The message starts the Amazon ASINs Scraper with the provided input 4. The response should be: `Accepted` #### Your feedback We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for YouTube Comment Scraper or simply found a bug, please create an issue on the Actor’s [Issues tab](https://apify.com/streamers/youtube-comments-scraper/issues/open). # Changelog This Actor's version history is a separate document: https://apify.com/streamers/youtube-comments-scraper/changelog.md # Actor input Schema ## `startUrls` (type: `array`): Enter a link to a specific Youtube video YouTube video. You can also import a CSV file or Google Sheet with a list of URLs.
## `maxComments` (type: `integer`): Limit the number of comments you want to scrape per video. ## `sortCommentsBy` (type: `string`): Select Youtube sorting parameter for comments ## `oldestCommentDate` (type: `string`): Only comments published after or on this date will be scraped. Alternatively, specify how old the scraped comments should be. Putting 1 day will get you only today's comments, 2 days - yesterday's and today's, and so on. Note, that if you select this, sorting parameter will be auto-reset to newest first ## Actor input object example ```json { "startUrls": [ { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" } ], "maxComments": 100, "sortCommentsBy": "NEWEST_FIRST", "oldestCommentDate": "2026-03-01" } ``` # Actor output Schema ## `dataset` (type: `string`): Dataset containing all scraped YouTube comments # 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 = { "startUrls": [ { "url": "https://www.youtube.com/watch?v=xObhZ0Ga7EQ" } ], "maxComments": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("streamers/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 = { "startUrls": [{ "url": "https://www.youtube.com/watch?v=xObhZ0Ga7EQ" }], "maxComments": 10, } # Run the Actor and wait for it to finish run = client.actor("streamers/youtube-comments-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.youtube.com/watch?v=xObhZ0Ga7EQ" } ], "maxComments": 10 }' | apify call streamers/youtube-comments-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,streamers/youtube-comments-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/p7UMdpQnjKmmpR21D/builds/nnBjBzGtedGPgqiwy/openapi.json