Social Fetch
Instagram

List Instagram post or reel comments

Lists top-level comments for a public Instagram post or reel URL with optional cursor-based pagination.

Operation

GET/v1/instagram/posts/comments
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Link to the Instagram post or reel whose comments should be listed.

min 1 chars · max 4096 chars

cursorstring(query)

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

min 1 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the post or reel was resolved for this request.

one of: found, not_found

datacomments
arrayrequired

Top-level comments for the resolved media.

datacomments[]id
stringrequired

Stable identifier for the comment.

min 1 chars

datacomments[]text
stringrequired

Comment text.

datacomments[]createdAt
stringrequired

ISO-8601 timestamp when the comment was created.

datacomments[]likeCount
integerrequired

Like count on the comment.

≥ 0

datacomments[]replyCount
integerrequirednullable

Direct reply count for the comment thread when available; null when not reported.

≥ 0

datacomments[]author
objectrequired

Comment author.

datacomments[]authorhandle
stringrequired

Instagram username without a leading @.

min 1 chars

datacomments[]authorplatformUserId
string

Numeric user id for the commenter when available.

datacomments[]authorverified
booleanrequired

Whether the commenter account is verified.

datacomments[]authoravatarUrl
stringrequirednullable

Profile image URL for the commenter when available.

datapage
objectrequired

Pagination information for this response.

datapagenextCursor
stringrequirednullable

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

datapagehasMore
booleanrequired

Whether another page of comments is available.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

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

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page