Social Fetch
Facebook

List Facebook post or reel comments

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

Operation

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

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstring(query)

Link to the Facebook 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

feedbackIdstring(query)

Optional Facebook feedback identifier for the target post; when available it can improve lookup performance.

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 post or reel.

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[]replyCount
integerrequired

Direct reply count for the comment thread.

≥ 0

datacomments[]reactionCount
integerrequired

Total reaction count on the comment.

≥ 0

datacomments[]author
objectrequired

Comment author.

datacomments[]authorname
stringrequired

Display name of the commenter.

min 1 chars

datacomments[]authorplatformUserId
string

Platform-specific commenter id when available.

datacomments[]authorshortName
stringrequirednullable

Short display name 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