Social Fetch
Reddit

List Reddit post comments

Get comments on a Reddit post.

GET/v1/reddit/posts/comments
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
url*stringquery

Link to the Reddit post whose comments should be listed.

min 1 chars · max 4096 chars

cursorstringoptionalquery

Opaque cursor from a previous response to fetch another page of comments or replies.

min 1 chars

trimbooleanoptionalquery

When true, requests a lighter response shape when available.

Response fields
69

Endpoint-specific response payload.

datalookupStatus
string

Whether the post was resolved for this request.

one of: found, not_found

Post details when available on this page.

datapostid
string

Stable post identifier.

min 1 chars

dataposttitle
string

Post title. May be an empty string.

dataposturl
string

Canonical public post URL when available.

min 1 chars

datapostpermalink
stringnullable

Relative permalink path when available.

datapostsubreddit
stringnullable

Subreddit name without a leading r/.

datapostsubredditNamePrefixed
stringnullable

Prefixed subreddit name when available.

datapostauthor
stringnullable

Post author username when available.

datapostscore
integernullable

Post score when available.

≥ 0

datapostupvoteRatio
numbernullable

Upvote ratio when available.

datapostcommentCount
integernullable

Reported comment count when available.

≥ 0

datapostcreatedAt
stringnullable

ISO-8601 timestamp when the post was created.

datapostcreatedUtc
integernullable

Unix timestamp in seconds when the post was created.

≥ 0

datapostover18
boolean

Whether the post is marked over-18.

datapostlocked
boolean

Whether the post is locked.

datapoststickied
boolean

Whether the post is stickied.

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 or replies is available.

Comments returned for this page.

datacomments[]id
string

Stable identifier for the comment.

min 1 chars

datacomments[]url
stringnullable

Public comment URL when available.

datacomments[]permalink
stringnullable

Relative permalink path when available.

datacomments[]parentId
stringnullable

Parent comment or post identifier when available.

datacomments[]author
stringnullable

Comment author username when available.

datacomments[]text
string

Comment text.

datacomments[]renderedHtml
stringnullable

Rendered HTML for the comment when available.

datacomments[]score
integernullable

Comment score when available.

datacomments[]upvotes
integernullable

Upvote count when available.

≥ 0

datacomments[]createdAt
stringnullable

ISO-8601 timestamp when the comment was created.

datacomments[]createdUtc
integernullable

Unix timestamp in seconds when the comment was created.

≥ 0

datacomments[]depth
integer

Nesting depth of the comment in the thread.

≥ 0

datacomments[]isSubmitter
boolean

Whether the comment author is the post author.

datacomments[]stickied
boolean

Whether the comment is stickied.

datacomments[]locked
boolean

Whether the comment is locked.

datacomments[]distinguished
stringnullable

Distinguished comment label when available.

Nested replies attached to this comment.

Nested replies for this comment.

datacomments[]repliesitems[]id
string

Stable identifier for the comment.

min 1 chars

datacomments[]repliesitems[]url
stringnullable

Public comment URL when available.

datacomments[]repliesitems[]permalink
stringnullable

Relative permalink path when available.

datacomments[]repliesitems[]parentId
stringnullable

Parent comment or post identifier when available.

datacomments[]repliesitems[]author
stringnullable

Comment author username when available.

datacomments[]repliesitems[]text
string

Comment text.

datacomments[]repliesitems[]renderedHtml
stringnullable

Rendered HTML for the comment when available.

datacomments[]repliesitems[]score
integernullable

Comment score when available.

datacomments[]repliesitems[]upvotes
integernullable

Upvote count when available.

≥ 0

datacomments[]repliesitems[]createdAt
stringnullable

ISO-8601 timestamp when the comment was created.

datacomments[]repliesitems[]createdUtc
integernullable

Unix timestamp in seconds when the comment was created.

≥ 0

datacomments[]repliesitems[]depth
integer

Nesting depth of the comment in the thread.

≥ 0

datacomments[]repliesitems[]isSubmitter
boolean

Whether the comment author is the post author.

datacomments[]repliesitems[]stickied
boolean

Whether the comment is stickied.

datacomments[]repliesitems[]locked
boolean

Whether the comment is locked.

datacomments[]repliesitems[]distinguished
stringnullable

Distinguished comment label when available.

Nested replies attached to this comment.

Further nested replies beyond the documented depth.

datacomments[]repliesitems[]repliesitems[]
nullableoptional

Pagination state for nested replies.

datacomments[]repliesitems[]repliespagenextCursor
stringnullable

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

datacomments[]repliesitems[]repliespagehasMore
boolean

Whether another page of comments or replies is available.

Pagination state for nested replies.

datacomments[]repliespagenextCursor
stringnullable

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

datacomments[]repliespagehasMore
boolean

Whether another page of comments or replies 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/reddit/posts/comments?url=https://www.reddit.com/r/gadgets/comments/1tgimff/aura_displays_debuts_new_portable_monitor_with/" \
  -H "x-api-key: YOUR_API_KEY"

Responses

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

On this page

No Headings