YouTube comment replies API
Pass a repliesCursor from the video comments list and get nested replies with author, likes, and reply depth — same Social Fetch envelope as top-level comments.
GET /v1/youtube/videos/comments/replies1 credit per successful request.
About this endpoint
Top-level comment lists stop at the first layer. Sentiment jobs, moderation queues, and brand listening that care about back-and-forth need the nested replies under a specific comment. YouTube's UI shows that thread; a batch pipeline needs a cursor-driven JSON page.
`GET /v1/youtube/videos/comments/replies` takes a required `cursor` query param. Start with `repliesCursor` from an item in `GET /v1/youtube/videos/comments`. On success, read `data.replies` and `data.page`. Each reply can include `id`, `text`, `publishedAt`, `publishedTimeText`, `replyLevel`, `likes`, `replyCount`, and an `author` object (`name`, `channelId`, `channelUrl`, `avatarUrl`, `isVerified`, `isCreator`). Paginate by passing `data.page.nextCursor` as `cursor` while `hasMore` is true. The cursor is opaque — do not invent or parse it.
Pricing is on the credit badge for this operation; bill from `meta.creditsCharged` on every response. Top-level listing stays on `GET /v1/youtube/videos/comments`. Spoken text for the same video is the transcript route under the YouTube tag and the same API key.
YouTube comment replies API FAQ
How do I list replies to a YouTube comment via API?
Call GET /v1/youtube/videos/comments/replies with your Social Fetch API key (x-api-key) and a required cursor query param. Use repliesCursor from a comment returned by GET /v1/youtube/videos/comments. Read data.replies and data.page. Full parameters and examples are in the API docs.
How much does the YouTube comment replies 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.
Where does the replies cursor come from?
From the parent comments list: each comment can include repliesCursor when nested replies are available. To page further replies, pass data.page.nextCursor from a previous replies response as the cursor query param. Do not invent or parse the cursor string.
How does pagination work on YouTube comment replies?
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.
What fields are in each YouTube reply?
Items can include id, text, publishedAt, publishedTimeText, replyLevel, likes, replyCount, and author (name, channelId, channelUrl, avatarUrl, isVerified, isCreator). Exact nullability lives in the OpenAPI schema for this route.
Replies vs top-level YouTube comments?
Use GET /v1/youtube/videos/comments to list top-level comments for a video URL. Use this route to page nested replies under one comment via its repliesCursor. They are separate marketplace operations.
Do I pass a video URL to the replies endpoint?
No. This route only accepts cursor. Resolve the video with the comments list first, then pass that comment's repliesCursor here.
Other YouTube endpoints
- ChannelGET /v1/youtube/channel
- Channel videosGET /v1/youtube/channels/videos
- Channel shortsGET /v1/youtube/channels/shorts
- PlaylistGET /v1/youtube/playlists
- Community postGET /v1/youtube/community-posts
- SearchGET /v1/youtube/search
- Hashtag searchGET /v1/youtube/search/hashtags
- Trending shortsGET /v1/youtube/shorts/trending