Reddit User Comments API - Comment History

Comment history for any public user

Retrieve the public comment history for a Reddit user. Supports pagination. A deleted or suspended account, or a name that was never registered, returns 404 with error "No public Reddit profile was found for this name." and code not_found (retryable false), and costs no credit; when that cannot be confirmed, the answer is a 503 worth retrying. A profile with no public comments returns 200 with an empty items list and the note "This profile shows no public comments."

POST /user-comments User
https://api.fetchlayer.dev/reddit/user-comments
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

username string required

Reddit username.

limit integer optional

Maximum number of comments to return. (default: 25)

pages integer optional

How many pages of results to return, at most. Each page holds 25 results. If omitted, results continue until `limit` is reached (or the 45s time budget ends, returning partial results with `incompleteReason: "scrape_timeout"`), billed as `ceil(items returned / 25)`. If passed, results are capped at that many pages and billed per page actually returned (see `pagesScraped` in the response).

after string optional

Pagination cursor (after).

sort string optional

Order of the comments: new, hot or top. Omit it for newest first, as before.

include string[] optional

Extra fields per comment: ["bodyMarkdown"] adds each comment’s body as Markdown (links, lists, quotes and code), converted from bodyHtml. Off by default to keep responses small.

time string | null optional

Time window for sort top: hour, day, week, month, year or all. Ignored for other orders.

Response Fields

user-comments

Comment history for any public user

requestedUrl string

The Reddit URL the request was for.

finalUrl string

Final URL after redirects.

listingType string

Always user-comments for a successful response.

username string

Requested Reddit username.

items[].id string | null

Comment ID without the t1_ prefix.

items[].fullname string | null

Reddit comment fullname.

items[].subreddit string | null

Subreddit name without the r/ prefix.

items[].subredditPrefixed string | null

Subreddit name with the r/ prefix.

items[].author string | null

Comment author.

items[].parentPostTitle string | null

Parent post title.

items[].parentPostAuthor string | null

Parent post author.

items[].parentPostUrl string | null

Parent post URL.

items[].permalink string | null

Absolute comment permalink.

items[].contextUrl string | null

Comment URL including Reddit context.

items[].fullCommentsUrl string | null

URL of the full comments page.

items[].createdAt string | null

ISO 8601 creation timestamp.

items[].score number | null

Comment score.

items[].scoreText string | null

Score text as displayed by Reddit.

items[].replyCount number | null

Reply count when available.

items[].replyCountText string | null

Reply count text as displayed by Reddit.

items[].bodyText string

Plain-text comment body.

items[].bodyHtml string | null

HTML comment body when available.

items[].authorFlair string | null

The commenter’s flair in that community, as text (emoji as :code:). null means the commenter wears no flair; it means unknown only when the lookup failed, and notes then says so.

items[].authorFlairRichtext object[] | null

The same flair as parts: text parts ({ type, text }) and emoji parts ({ type, code, imageUrl }). null when authorFlair is null.

items[].distinguished string | null

Moderator/admin distinction, or null.

items[].stickied boolean

Whether the comment is stickied.

items[].removed boolean | null

Always null here: comment history and search results do not show whether a comment was removed. Use the post or comment permalink endpoint for removal status.

items[].removedBy string | null

Always null here, for the same reason as removed.

items[].authorId string | null

The author’s account id (t2_…).

items[].subredditId string | null

The subreddit’s id (t5_…).

items[].postFullname string | null

The fullname of the post the comment is on (t3_…).

items[].parentFullname string | null

What the comment replies to: another comment (t1_…), or the post itself (t3_…) for a top-level comment.

items[].bodyMarkdown string | null

Only with include ["bodyMarkdown"]: the comment’s body as Markdown, converted from bodyHtml.

listingTitle string | null

Display title of the listing, or null when unavailable.

itemCount number

Number of entries returned in items.

nextPageUrl string | null

The next page’s address, or null at the end. On endpoints that take `after` it is an api.fetchlayer.dev address: POST it with your key to get the next page (a body is optional; fields you send override the address), or pass its `after` parameter as `after`.

prevPageUrl string | null

The previous page’s address (its `before` parameter is the cursor), or null.

pagesRequested number

Number of pages requested.

pagesScraped number

Pages of results returned. This is what the request is billed at: 1 credit per page actually returned, never per page requested.

scrapedAt string

ISO 8601 time the result was produced.

transport string

The data source: always the platform id, "reddit".

notes string[]

Caveats about this result, for example "This profile shows no public comments." when the profile has none.

Request

curl -X POST "https://api.fetchlayer.dev/reddit/user-comments" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"username":"spez","limit":10}'

Response

{
  "listingType": "user-comments",
  "username": "spez",
  "items": [
    {
      "id": "xyz",
      "bodyText": "Thanks for the feedback!",
      "subreddit": "reddit",
      "score": 250,
      "parentPostTitle": "Announcing new features",
      "permalink": "https://www.reddit.com/r/reddit/comments/abc/comment/xyz/",
      "createdAt": "2026-08-13T03:00:00.000Z",
      "stickied": false
    }
  ],
  "itemCount": 1,
  "nextPageUrl": "https://api.fetchlayer.dev/reddit/user-comments?after=t1_xyz",
  "pagesRequested": 1,
  "pagesScraped": 1,
  "transport": "reddit"
}
Product overview Reddit API: what it returns, pricing and use cases