YouTube Comments Scraper

Scrape comments from YouTube videos with support for pagination and different sorting options.

Use Cases

• Sentiment Analysis: Analyze user feedback and opinions
• Community Engagement: Track comment patterns and responses
• Content Moderation: Monitor comment quality and flags
• Audience Research: Understand viewer demographics and interests
• Trend Detection: Identify popular topics in discussions

Input Parameters

Field	Type	Required	Description	Example	Default
type	string	Yes	Scraper type	video_comments	-
videoIds	array	Yes	Array of YouTube video IDs	["arj7oStGLkU"]	-
sortBy	string	No	Sort order: top or newest	top	top
maxItem	number	No	Max comments per video	100	100
resumeToken	string	No	Continue from previous fetch	-	-
geo	string	No	ISO 3166-2 country code	US	US
lang	string	No	Language code	en	en

Example Input

{
  "type": "video_comments",
  "videoIds": ["arj7oStGLkU"],
  "sortBy": "top",
  "maxItem": 50,
  "geo": "US",
  "lang": "en"
}

Output Schema

Comment Object

{
  "commentId": "Ugw2mz3...",
  "text": "This is an amazing video!",
  "author": {
    "name": "John Doe",
    "channelId": "UCxxx...",
    "thumbnails": [...]
  },
  "likeCount": 1245,
  "replyCount": 23,
  "publishedTimeText": "3 weeks ago",
  "publishedAt": "2024-11-20T10:30:00Z",
  "isPinned": false,
  "isHeartedByUploader": false,
  "hasReplies": true,
  "continuation": "Eg0SC..."
}

Data Fields

Comment Information

• commentId: Unique comment identifier
• text: Comment text content
• likeCount: Number of likes
• replyCount: Number of replies
• publishedTimeText: Human-readable time (e.g., "3 weeks ago")
• publishedAt: ISO timestamp

Author Information

• author.name: Commenter's display name
• author.channelId: Commenter's channel ID
• author.thumbnails: Profile picture URLs

Status Flags

• isPinned: Whether comment is pinned by creator
• isHeartedByUploader: Whether creator hearted the comment
• hasReplies: Whether comment has replies

Pagination

• continuation: Token for fetching more comments

Sorting Options

• top (default): Most liked/popular comments first
• newest: Most recent comments first

Notes

• Free tier limited to 100 comments per run
• Pagination automatically continues until maxItem is reached
• State is saved for resuming interrupted scrapes
• Some videos may have comments disabled
• Reply threads can be fetched separately