Social Fetch
YouTube

List YouTube video comments

Get comments on a YouTube video.

GET/v1/youtube/videos/comments
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
url*stringquery

Link to the YouTube video whose comments should be listed.

min 1 chars · max 4096 chars

cursorstringoptionalquery

Opaque cursor from a previous response to fetch the next page.

min 1 chars

orderstringoptionalquery

Comment sort order. `top` returns highest-ranked comments; `newest` returns the most recent comments.

one of: top, newest

Response fields
25

Endpoint-specific response payload.

datalookupStatus
string

Whether the video was resolved for this request.

one of: found, not_found

Top-level comments for the resolved video.

datacomments[]id
string

Stable identifier for the comment.

min 1 chars

datacomments[]text
string

Comment text.

datacomments[]createdAt
string

ISO-8601 timestamp when the comment was published.

datacomments[]publishedTimeText
stringnullable

Human-readable relative publish time when available.

datacomments[]likeCount
integer

Like count on the comment.

≥ 0

datacomments[]replyCount
integer

Direct reply count for the comment thread.

≥ 0

datacomments[]repliesCursor
stringnullable

Use as `cursor` on comment replies. Null when unavailable.

Comment author.

datacomments[]authorhandle
string

Public YouTube channel handle without a leading @.

min 1 chars

datacomments[]authordisplayName
stringnullable

Display name shown on the commenter channel.

datacomments[]authorplatformUserId
stringoptional

YouTube channel id when available.

datacomments[]authorverified
boolean

Whether the commenter channel is verified.

datacomments[]authorcreator
boolean

Whether the commenter is the video creator.

datacomments[]authoravatarUrl
stringnullable

Profile image URL for the commenter when available.

datacomments[]authorchannelUrl
stringnullable

Channel page URL when available.

Pagination information for this response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist.

datapagehasMore
boolean

Whether another page of comments is available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/youtube/videos/comments?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Comment listing result. Check `data.lookupStatus` for `found` or `not_found`.

On this page

No Headings