List YouTube video comments
Get comments on a YouTube video.
Operation
/v1/youtube/videos/commentsHeaders
API key (`sfk_...`)
Parameters
Link to the YouTube video whose comments should be listed.
min 1 chars · max 4096 chars
Opaque cursor from a previous response to fetch the next page.
min 1 chars
Comment sort order. `top` returns highest-ranked comments; `newest` returns the most recent comments.
one of: top, newest
Response fields
Endpoint-specific response payload.
Whether the video was resolved for this request.
one of: found, not_found
Top-level comments for the resolved video.
Stable identifier for the comment.
min 1 chars
Comment text.
ISO-8601 timestamp when the comment was published.
Human-readable relative publish time when available.
Like count on the comment.
≥ 0
Direct reply count for the comment thread.
≥ 0
Use as `cursor` on comment replies. Null when unavailable.
Comment author.
Public YouTube channel handle without a leading @.
min 1 chars
Display name shown on the commenter channel.
YouTube channel id when available.
Whether the commenter channel is verified.
Whether the commenter is the video creator.
Profile image URL for the commenter when available.
Channel page URL when available.
Pagination information for this response.
Cursor to pass in the next request when more pages exist.
Whether another page of comments is available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Comment listing result. Check `data.lookupStatus` for `found` or `not_found`.
Error codes