Comments from YouTube videos for sentiment, FAQ mining and research: text, likes, reply count, publication time, pinned and owner flags, top or newest first, up to 200 videos per run. Deliberately without commenter names, handles or channel ids. Pay only for delivered comments.
$0.35 per 1,000 ยท Comment listed
One comment (or reply) delivered to the dataset. Videos that fail or have no comments are never charged.
| Field | Name | What it does |
|---|---|---|
videos | Videos | Video URLs or 11-character video ids, one per row. Each video is one input; a video without comments comes back as a free error record. |
maxCommentsPerVideo | Max comments per video | Cost ceiling: at most this many top-level comments per video, in YouTube's order. One delivered comment is one charged event. |
sort | Order | Top comments (YouTube's ranking) or newest first. |
includeReplies | Include replies | Also fetch the replies under each comment (each reply is a charged comment too, with `parentCommentId` set). Off by default: top-level comments only. |
maxRepliesPerComment | Max replies per comment | Only used when replies are on. |
language | Language | Interface language for relative dates such as '2 weeks ago' (hl). |
| Field | Type |
|---|---|
videoId | string, null |
commentId | string, null |
parentCommentId | string, null |
rank | integer, null |
text | string, null |
likeCount | integer, null |
replyCount | integer, null |
publishedText | string, null |
isOwner | boolean, null |
isPinned | boolean, null |
hasCreatorHeart | boolean, null |
isReply | boolean, null |
commentUrl | string, null |
status | string, null |
input | string, null |
errorCode | string, null |
error | string, null |