Path Parameters The YouTube video id (e.g. dQw4w9WgXcQ).
Query Parameters Comment sort order. Value Description topTop comments (default) newestNewest first
Continuation token from a previous response to fetch the next page of comments.
Response The video the comments belong to.
Array of top-level comments. Relative publish time, e.g. 2 weeks ago (nullable).
Unix publish timestamp (nullable).
Author display name (nullable).
Author channel id (nullable).
Author channel URL (nullable).
Author avatar URL (nullable).
Whether the author is verified (nullable).
Whether the author is an official artist (nullable).
Whether the author is the video’s uploader (nullable).
Author badges (e.g. member badges).
Number of likes (nullable).
Number of replies (nullable).
Whether the creator hearted the comment (nullable).
Whether the comment is pinned (nullable).
Whether the comment is a reply (nullable).
Parent comment id, if a reply (nullable).
Token to fetch this comment’s replies (nullable).
Super Thanks purchase amount, if any (nullable).
The video id the comment belongs to (nullable).
Total comment count on the video (nullable).
Sort options with title and token (e.g. top, newest).
Token to fetch the next page (nullable when no more pages).
Example Response { "video_id" : "dQw4w9WgXcQ" , "comments" : [ { "comment_id" : "UgxKREWxIgDrw8w2e_Z4AaABAg" , "text" : "Who's still listening in 2026?" , "published_time_text" : "3 days ago" , "author" : "@musiclover" , "author_channel_id" : "UCabc123" , "author_is_verified" : false , "like_count" : 1820 , "reply_count" : 42 , "is_pinned" : false , "is_reply" : false , "replies_continuation" : "Eg0SC2RRdzR3OVdnWGNR..." } ], "comment_count" : 2400000 , "sorting_tokens" : [ { "title" : "Top comments" , "token" : "..." }, { "title" : "Newest first" , "token" : "..." } ], "continuation" : "Eg0SC2RRdzR3OVdnWGNRGAYyJg..." }
Replies To fetch replies to a specific comment, call:
curl "https://scrapebadger.com/v1/youtube/videos/dQw4w9WgXcQ/comments/UgxKREWxIgDrw8w2e_Z4AaABAg/replies" \ -H "X-API-Key: YOUR_API_KEY"
This returns a RepliesResponse with comment_id, a replies array (same Comment shape), and a continuation token. You can also pass the replies_continuation value from a comment directly as the continuation query parameter.
Each comments page and each replies page costs 5 credits . Failed requests are not charged.
