YouTube

Analyze YouTube video comments

Analyze YouTube video comments

GET/v1/youtube/videos/comments/analysis
2credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
urlstringrequiredquery

Link to the YouTube video whose comments should be listed.

min 1 chars · max 4096 chars

orderstringoptionalquery

Comment sort order to analyze. Defaults to `top` for the strongest signal.

one of: top, newest

Response fields
33

Endpoint-specific response payload.

datalookupStatus
string

Whether the video could be resolved for comment analysis.

one of: found, not_found

datacommentCount
integer

Comments analyzed from this page.

≥ 0

datatotalLikes
integer

≥ 0

datatotalReplies
integer

≥ 0

dataavgLikes
number

≥ 0

dataquestionCount
integer

≥ 0

datacreatorCommentCount
integer

≥ 0

dataverifiedCommentCount
integer

≥ 0

Highest-liked comments from this page (desc), up to 8.

datatopComments[]id
string

Stable identifier for the comment.

min 1 chars

datatopComments[]text
string

Comment text.

datatopComments[]createdAt
string

ISO-8601 timestamp when the comment was published.

datatopComments[]publishedTimeText
stringnullable

Human-readable relative publish time when available.

datatopComments[]likeCount
integer

Like count on the comment.

≥ 0

datatopComments[]replyCount
integer

Direct reply count for the comment thread.

≥ 0

datatopComments[]repliesCursor
stringnullable

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

Comment author.

datatopComments[]authorhandle
string

Public YouTube channel handle without a leading @.

min 1 chars

datatopComments[]authordisplayName
stringnullable

Display name shown on the commenter channel.

datatopComments[]authorplatformUserId
stringoptional

YouTube channel id when available.

datatopComments[]authorverified
boolean

Whether the commenter channel is verified.

datatopComments[]authorcreator
boolean

Whether the commenter is the video creator.

datatopComments[]authoravatarUrl
stringnullable

Profile image URL for the commenter when available.

datatopComments[]authorchannelUrl
stringnullable

Channel page URL when available.

Frequent content words from comment text (stopwords stripped), up to 12.

datakeywords[]word
string
datakeywords[]count
integer

≥ 0

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

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

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

Responses

Comment frequency/ranking analysis for one page.