YouTube Comments Scraper

Collect public YouTube comments with commenter, engagement, video, and channel context from one or more video URLs.

Overview

Turn public YouTube conversations into a structured dataset without manually opening each video and copying comments one by one. For every available top-level comment, the result keeps the comment text together with its public author handle, engagement signals, and the video and channel context needed to interpret it.

This combination is useful when a research, marketing, support, or content team needs more than an isolated quote. It lets analysts connect what viewers said with the video they reacted to, distinguish creator participation from audience participation, and retain visible engagement snapshots for later comparison.

Data notes

The data comes from publicly accessible YouTube video pages and their visible comment sections. Each record represents one top-level comment. Comment ID identifies the comment, while Video ID and Video URL identify the video that received it. Reply Count reports the number of replies shown for that comment, but reply messages are not separate records in this dataset.

Comment Time preserves YouTube's displayed text and may be relative, such as “10 years ago,” rather than a normalized timestamp. Comment Like Count, Video Like Count, Video View Count, Video Comment Count, and Channel Subscribers are text snapshots observed at collection time and can change later. Channel-owner Comment, Creator Heart, and Comments Disabled are also supplied as source text rather than converted booleans. Private, removed, restricted, or comment-disabled videos may not provide comment records.

What the results look like

Each record represents one public top-level YouTube comment and its video context.

Comment ID	Comment text	Comment time	Comment like count	Video title	Channel name
UgiH2bCFcyVmAHgCoAEC	Want to try it out :)	10 years ago	1	What is web scraping - Octoparse, your first web scraper!	Octoparse
UgxExampleComment002	This walkthrough answered my setup question.	2 years ago	3	What is web scraping - Octoparse, your first web scraper!	Octoparse

Other available fields include Commenter Handle, Commenter Avatar URL, Reply Count, Creator Heart, Video ID, Video URL, Video Description, Video View Count, Video Like Count, Video Comment Count, Video Thumbnail URL, Channel Handle, Channel URL, Channel Avatar URL, and Channel Subscribers.

Use cases

For audience feedback analysis, group Comment Text by Video Title to identify recurring questions, objections, praise, and requests around each video.
For engagement review, compare Comment Like Count and Reply Count to find comments that generated the strongest visible reaction from other viewers.
For creator-community analysis, use Channel-owner Comment and Creator Heart to distinguish direct creator participation from ordinary audience discussion.
For channel research, combine Channel Name, Channel Subscribers, Video View Count, and Video Like Count to retain the public context surrounding each collected comment.

Scope & Boundaries

Each run accepts 1 to 10,000 public YouTube video URLs; an optional limit can request 20 to 5,000 comments per video, while unavailable, private, restricted, or comment-disabled videos may return no comment records.

Good for
Use it when you need public comment text and engagement details for one or more YouTube videos.
Use it to study audience questions, reactions, recurring topics, or creator interaction around public videos.

Do not use for
Do not use it for private, removed, age-restricted, region-restricted, or otherwise inaccessible videos.
Do not use it when you need reply-thread records rather than top-level comment records.

Failure Handling

Failure and retry behavior declared by the author. We recommend including it in your system prompt when integrating.

1If a run fails, retry the same small URL set once; if it fails again, split a large batch into smaller groups.
2If no records are returned, confirm that the video is public, still available, and has comments enabled before retrying.

Input

Parameters required to call this app, generated from the input.schema in manifest.json.

Field	Business name	Type	Required	Default	Enum / Constraints	Example	Description
video_urls	YouTube video URLs	array<string>	Yes	—	up to 10000 items	["https://www.youtube.com/watch?v=xBBAD407zzU"]	Public YouTube video page URLs whose comments you want to collect. Provide between 1 and 10,000 URLs per run.
comment_limit	Comments per video	integer	No	—	20–5000	—	Maximum number of comments to request for each video, from 20 to 5,000. When omitted, the collector decides the limit; set it explicitly when predictable depth is important.

Output

Field structure of a single record, generated from the output.schema in manifest.json.

Field	Business name	Type	Example	Description
account_avatar_url	Channel avatar URL	string	https://yt3.ggpht.com/F2Tcm5xLoN764EY8s9e35Pn3FA--I-hVTIySlAJ8EQKp6--Je1KHMUbfVBGYJfrj45hgMM7mBnY=s48-c-k-c0x00ffffff-no-rj	Image address for the channel avatar observed with the video.
account_fans_count	Channel subscribers	string	12.5K	Subscriber-count text displayed for the video channel at collection time.
account_home_url	Channel URL	string	https://www.youtube.com/@Octoparsewebscraping	YouTube channel page address associated with the video.
account_id	Channel handle	string	@Octoparsewebscraping	Channel identifier or handle associated with the video.
account_name	Channel name	string	Octoparse	Display name of the channel that published the video.
author_is_channel_owner	Channel-owner comment	string	false	Source text indicating whether the comment author is the video's channel owner.
comment_count	Video comment count	string	22	Comment-count text displayed for the video at collection time.
comment_id	Comment ID	string	UgiH2bCFcyVmAHgCoAEC	Identifier supplied for the YouTube comment.
comment_text	Comment text	string	Want to try it out :)	Text written in the YouTube comment.
comment_time	Comment time	string	10 years ago	Comment publication time as displayed by YouTube, which may be relative text.
comment_type	Comment type	string	comment	Source label describing the kind of comment record.
comment_user_avatar_url	Commenter avatar URL	string	https://yt3.ggpht.com/ytc/AIdro_kgZ5qNQYtjliDe_8XSTjzgtZ-pVBvmRF57LzBS9U7xgg=s88-c-k-c0x00ffffff-no-rj	Image address for the comment author's public avatar.
comment_user_id	Commenter handle	string	@nanachoi9361	Public YouTube handle or identifier displayed for the comment author.
comments_turned_off	Comments disabled	string	false	Source text indicating whether comments are turned off for the video.
content_id	Video ID	string	xBBAD407zzU	YouTube identifier for the video that received the comment.
content_text	Video description	string	Subscribe and Visit Us https://www.octoparse.com ✨What is a web crawler? ✨How does a web crawler work? ✨What are the differences between it and a web scraper?	Description text displayed for the video; the prefill is an excerpt from the retained source record.
content_title	Video title	string	What is web scraping - Octoparse, your first web scraper!	Title displayed for the YouTube video.
content_url	Video URL	string	https://www.youtube.com/watch?v=xBBAD407zzU	YouTube page address for the video that received the comment.
content_like_count	Video like count	string	44	Like-count text displayed for the video at collection time.
cover_image_url	Video thumbnail URL	string	https://i.ytimg.com/vi/xBBAD407zzU/hqdefault.jpg	Image address for the video's thumbnail.
has_creator_heart	Creator heart	string	false	Source text indicating whether the channel owner gave the comment a creator heart.
keyword	Submitted video URL	string	https://www.youtube.com/watch?v=xBBAD407zzU	Input video address associated with the collected record.
like_count	Comment like count	string	1	Like-count text displayed for the comment at collection time.
play_count	Video view count	string	103538	View-count text displayed for the video at collection time.
reply_count	Reply count	string	0	Number of replies shown for the comment, supplied as text.

Record Schema

Output is returned record by record. detail.output.idFieldHint

output.schema

{
  "type": "object",
  "properties": {
    "account_avatar_url": {
      "type": "string",
      "title": "Channel avatar URL",
      "description": "Image address for the channel avatar observed with the video.",
      "prefill": "https://yt3.ggpht.com/F2Tcm5xLoN764EY8s9e35Pn3FA--I-hVTIySlAJ8EQKp6--Je1KHMUbfVBGYJfrj45hgMM7mBnY=s48-c-k-c0x00ffffff-no-rj"
    },
    "account_fans_count": {
      "type": "string",
      "title": "Channel subscribers",
      "description": "Subscriber-count text displayed for the video channel at collection time.",
      "prefill": "12.5K"
    },
    "account_home_url": {
      "type": "string",
      "title": "Channel URL",
      "description": "YouTube channel page address associated with the video.",
      "prefill": "https://www.youtube.com/@Octoparsewebscraping"
    },
    "account_id": {
      "type": "string",
      "title": "Channel handle",
      "description": "Channel identifier or handle associated with the video.",
      "prefill": "@Octoparsewebscraping"
    },
    "account_name": {
      "type": "string",
      "title": "Channel name",
      "description": "Display name of the channel that published the video.",
      "prefill": "Octoparse"
    },
    "author_is_channel_owner": {
      "type": "string",
      "title": "Channel-owner comment",
      "description": "Source text indicating whether the comment author is the video's channel owner.",
      "prefill": "false"
    },
    "comment_count": {
      "type": "string",
      "title": "Video comment count",
      "description": "Comment-count text displayed for the video at collection time.",
      "prefill": "22"
    },
    "comment_id": {
      "type": "string",
      "title": "Comment ID",
      "description": "Identifier supplied for the YouTube comment.",
      "prefill": "UgiH2bCFcyVmAHgCoAEC"
    },
    "comment_text": {
      "type": "string",
      "title": "Comment text",
      "description": "Text written in the YouTube comment.",
      "prefill": "Want to try it out :)"
    },
    "comment_time": {
      "type": "string",
      "title": "Comment time",
      "description": "Comment publication time as displayed by YouTube, which may be relative text.",
      "prefill": "10 years ago"
    },
    "comment_type": {
      "type": "string",
      "title": "Comment type",
      "description": "Source label describing the kind of comment record.",
      "prefill": "comment"
    },
    "comment_user_avatar_url": {
      "type": "string",
      "title": "Commenter avatar URL",
      "description": "Image address for the comment author's public avatar.",
      "prefill": "https://yt3.ggpht.com/ytc/AIdro_kgZ5qNQYtjliDe_8XSTjzgtZ-pVBvmRF57LzBS9U7xgg=s88-c-k-c0x00ffffff-no-rj"
    },
    "comment_user_id": {
      "type": "string",
      "title": "Commenter handle",
      "description": "Public YouTube handle or identifier displayed for the comment author.",
      "prefill": "@nanachoi9361"
    },
    "comments_turned_off": {
      "type": "string",
      "title": "Comments disabled",
      "description": "Source text indicating whether comments are turned off for the video.",
      "prefill": "false"
    },
    "content_id": {
      "type": "string",
      "title": "Video ID",
      "description": "YouTube identifier for the video that received the comment.",
      "prefill": "xBBAD407zzU"
    },
    "content_text": {
      "type": "string",
      "title": "Video description",
      "description": "Description text displayed for the video; the prefill is an excerpt from the retained source record.",
      "prefill": "Subscribe and Visit Us https://www.octoparse.com\n✨What is a web crawler?\n✨How does a web crawler work?\n✨What are the differences between it and a web scraper?"
    },
    "content_title": {
      "type": "string",
      "title": "Video title",
      "description": "Title displayed for the YouTube video.",
      "prefill": "What is web scraping - Octoparse, your first web scraper!"
    },
    "content_url": {
      "type": "string",
      "title": "Video URL",
      "description": "YouTube page address for the video that received the comment.",
      "prefill": "https://www.youtube.com/watch?v=xBBAD407zzU"
    },
    "content_like_count": {
      "type": "string",
      "title": "Video like count",
      "description": "Like-count text displayed for the video at collection time.",
      "prefill": "44"
    },
    "cover_image_url": {
      "type": "string",
      "title": "Video thumbnail URL",
      "description": "Image address for the video's thumbnail.",
      "prefill": "https://i.ytimg.com/vi/xBBAD407zzU/hqdefault.jpg"
    },
    "has_creator_heart": {
      "type": "string",
      "title": "Creator heart",
      "description": "Source text indicating whether the channel owner gave the comment a creator heart.",
      "prefill": "false"
    },
    "keyword": {
      "type": "string",
      "title": "Submitted video URL",
      "description": "Input video address associated with the collected record.",
      "prefill": "https://www.youtube.com/watch?v=xBBAD407zzU"
    },
    "like_count": {
      "type": "string",
      "title": "Comment like count",
      "description": "Like-count text displayed for the comment at collection time.",
      "prefill": "1"
    },
    "play_count": {
      "type": "string",
      "title": "Video view count",
      "description": "View-count text displayed for the video at collection time.",
      "prefill": "103538"
    },
    "reply_count": {
      "type": "string",
      "title": "Reply count",
      "description": "Number of replies shown for the comment, supplied as text.",
      "prefill": "0"
    }
  },
  "required": [
    "comment_id"
  ],
  "additionalProperties": false
}

Integration

This app can be integrated via MCP, API, SDK, or file export — all channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API Key (long-lived, created in the Open Platform console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way.

With the MCP (Model Context Protocol), you can call this app directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API Key. Works in any client, CI, or headless environment.

mcpServers config

{
  "mcpServers": {
    "YiJacobJohnRaku__youtube-comments-scraper": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=YiJacobJohnRaku/youtube-comments-scraper",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

View my API Keys →

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client — it will complete the setup its own way. (The prompt asks the AI to request your API Key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

returned comment record

Charged by the number of records successfully returned. Failed tasks are not charged.

$0.0006/ record

Multiple billing events accumulate independently — see each item for details. Failed tasks are not charged.

View balance

Try It Now

Fill in the parameters and run — results come from a real call.

Example

Parameters are validated against input.schema before submission

YouTube video URLsvideo_urls*Public YouTube video page URLs whose comments you want to collect. Provide between 1 and 10,000 URLs per run.

Comments per videocomment_limit (optional)Maximum number of comments to request for each video, from 20 to 5,000. When omitted, the collector decides the limit; set it explicitly when predictable depth is important.

Please fill in the required parameters first

$0.0006 / record