YouTube comments API
Pass a public YouTube video URL and get top-level comments with author, likes, and reply counts — same Social Fetch envelope as channel lookup and transcripts.
GET /v1/youtube/videos/comments1 credit Failed requests are free
About this endpoint
GET /v1/youtube/videos/comments takes a required url query param (watch links, youtu.be, Shorts). Optional order is top (highest-ranked) or newest. On a found lookup, read data.comments and data.page. Each comment can include id, text, createdAt, publishedTimeText, likeCount, replyCount, repliesCursor, and an author object with handle, display name, channel URL, and verification flags. Paginate by passing data.page.nextCursor as the cursor query param while hasMore is true. Branch on data.lookupStatus before you write rows.
Bill from meta.creditsCharged. Nested replies are a separate route: GET /v1/youtube/videos/comments/replies with the comment's repliesCursor. For spoken text on the same video, use the transcript endpoint under the same YouTube tag and API key.
YouTube comments API FAQ
How do I list YouTube video comments via API?
Call GET /v1/youtube/videos/comments with your Social Fetch API key (x-api-key) and a public video url query param. Read data.lookupStatus, then data.comments and data.page. See the API docs for parameters and examples.
How much does the YouTube comments endpoint cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
Can I sort YouTube comments by top or newest?
Yes. Pass optional order=top for highest-ranked comments or order=newest for the most recent. Omit order when you are fine with the API default for that call.
How does pagination work on YouTube video comments?
Each response includes data.page.nextCursor and data.page.hasMore. When hasMore is true, pass nextCursor as the cursor query param on the next request. The cursor is opaque.
How do I get replies to a YouTube comment?
Use GET /v1/youtube/videos/comments/replies with the repliesCursor from a comment in this list response (or page.nextCursor when paging replies). Top-level listing and reply threads are separate operations.
What fields are in each YouTube comment?
Items can include id, text, createdAt, publishedTimeText, likeCount, replyCount, repliesCursor, and author (handle, displayName, platformUserId, verified, creator, avatarUrl, channelUrl). Always branch on data.lookupStatus before treating comments as present.
What URL formats does the YouTube comments API accept?
Public YouTube video URLs: standard watch links, youtu.be short links, and Shorts URLs. Pass one url per request.