Skip to content
Gridlode
LiveSocial media and video0.05 credits / comment

YouTube Comments API

Public comments on one YouTube video, in YouTube's Top or Newest order, exactly as a signed-out visitor can load them: text, like count, published date, edited flag, reply count, pinned and creator-hearted flags, with optional replies. Commenter names are pseudonymized ("Commenter 1") unless you ask for them, and @mentions of those commenters are replaced the same way. Billed per comment returned, 1 credit per 20; videos with comments turned off, blocks and failures are free.

GEThttps://api.gridlode.com/v1/youtube/comments
Get an API keyReference docs

Parameters

NameTypeDescription
video_idrequiredstringYouTube video ID (11 characters) or any youtube.com / youtu.be video, Shorts or live URL.
sortstringYouTube's comment order: Top or Newest first.
Default: "top"
One of: top, newest
limitintegerMaximum comments to return, replies included. Billed per comment returned (1 credit per 20).
Default: 100
include_repliesbooleanAlso load the replies under each comment (they count towards limit).
Default: false
max_replies_per_commentintegerWith include_replies: at most this many replies per comment.
Default: 10
include_reviewer_namesbooleanReturn commenter display names (@handles), channel IDs and avatars. Off by default: authors are 'Commenter 1', 'Commenter 2', ... (stable within one response) and @mentions of them in comment text are replaced the same way.
Default: false
hlstringInterface language (affects '2 days ago' texts).
Default: "en"
glstringTwo-letter country code to view the video from.
Default: "us"
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    curl "https://api.gridlode.com/v1/youtube/comments?video_id=aircAruvnKk&limit=20" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    0.05 credits per comment
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 6 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: Outscraper YouTube comments $3 → $2 per 1k; SearchAPI YouTube comments $4.00 → $1.00 per 1k pages.

    Questions

    Part of these solutions
    How much does the YouTube Comments API cost?

    0.05 credits per comment. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Social media and video

    Related APIs in this category

    All 13 in Social media and video · 7 live
    Live

    YouTube Video Details

    Public metadata of one YouTube video from its watch page, as a signed-out visitor sees it

    1 credit / requestDocs
    Live

    TikTok Profile

    A public TikTok creator or brand profile exactly as a signed-out visitor sees it

    2 credits / requestTry freeDocs
    Soon

    Meta Ad Library

    Search Meta's public Ad Library (Facebook, Instagram, Messenger, Audience Network) by keyword or advertiser Page id for any country

    2 credits / pageDocs
    Soon

    Facebook Page

    A public Facebook Page (brand, business or organisation) as a logged-out visitor sees it

    2 credits / requestDocs