reddit/
user-comments

With the Reddit User Comments API, collect up to 1000 comments a Reddit user has left from one username, sorted by new, top or hot, with a 300-character excerpt, score, time, comment link and post ID.

Reddit User Comments API

Username input
Comment excerpts
Link to full comment
Parent post ID
0.3 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Reddit User Comments

A Reddit user's comment history is the trail of replies an account leaves in other people's threads, each with an excerpt of what was said, its score, the time it was written, a link to the comment and the post it belongs to. Comments often show what someone knows and cares about more plainly than their own posts, which helps qualify experts and prospects, follow how an account talks about a product and study the voice of a community through its most active members.

Reddit User Comments API Features

  • Comment history from a single usernameusername takes one account, sort_by orders its comments by new, top or hot, and results_limit collects from 1 to 1000 comments, 100 by default.
  • Direct link to each commenturl opens the comment inside its thread, so a reader can jump from any row straight to the full reply and the discussion around it.
  • Post reference on every replypost_id identifies the post the comment was left on, which groups replies by thread and connects them to post-level data.
  • Score for each commentmetrics.likes_count holds the comment's score, a quick measure of how other readers received the reply.

Reddit User Comments API Parameters

ParametersRequiredDescription
usernameRequiredOne Reddit username, with or without the u/ prefix, made of 3 to 20 letters, digits, hyphens or underscores.
sort_byOptionalOrder of the comments: new (default), top or hot.
results_limitOptionalMaximum number of comments to collect, an integer from 1 to 1000; defaults to 100.

How to Use the Reddit User Comments API

Submit one username to the Reddit User Comments API with a sort order and a limit, then read the comments page by page.

  1. POST {"username": "spez", "sort_by": "top", "results_limit": 100} to /v1/reddit/user-comments.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the comments from results.items; when has_more is true, pass results.next_cursor to fetch the next page.
curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"spez","sort_by":"top","results_limit":100}'

Reddit User Comments API Use Cases

  • Qualifying experts and prospects: Read the text excerpts and likes_count of a candidate's comments to judge whether they answer questions knowledgeably and are well received.
  • Tracking how an account talks about a product: Search a user's comments for your brand or product names in text, open url for the full reply and use published_at to follow one account's opinions over time.
  • Sampling a community's voice through active members: Collect comments from several regular members of a subreddit and compare their wording and scores to learn how that audience talks.

Reddit User Comments API Pro Tips

  • Turn post_id into a https://redd.it/{post_id} short link and send it to the Reddit Posts API when you need the thread's title, community and score.
  • Use sort_by top with a small results_limit in the Reddit User Comments API to pull an account's highest-scoring replies without collecting its whole history.
  • Store comments by id and skip ids you already hold when re-running the same username, so repeated checks never create duplicate rows.

Beyond the Reddit User Comments API, use these APIs when you need a different type of public Reddit data.

  • Reddit Posts API — Collect public post text, authors, community context, media, timestamps, and visible engagement from supported Reddit URLs.
  • Reddit Comments API — Collect public comment text, authors, post and parent-comment references, community context, timestamps, and visible engagement from supported post URLs.
  • Reddit Subreddit Posts API — Discover public posts from subreddit URLs with new, top, or hot sorting, a per-subreddit result limit, and normalized community and engagement context.
  • Reddit Search API — Search public Reddit posts by text query and publication window, returning normalized content, authors, community context, timestamps, media, and visible engagement.
  • Reddit User Profile API — Look up Reddit accounts by username, returning total, post and comment karma, activity counts, account age and profile flags.
  • Reddit User Posts API — Collect a Reddit user's post history from one username, sorted by new, top or hot, with title and body, score, comments and media.

Explore other platforms

Combine Reddit data with public data from other supported social platforms.

Reddit User Comments API — FAQ

Reddit User Comments API is a programmatic interface for collecting the comments a Reddit account has left in other threads, using its username. It returns an excerpt of each comment with its score, time, comment link and the identifier of the post it was left on.

Submit the username to the Reddit User Comments API with the sort_by you need and a results_limit of up to 1000, then follow next_cursor while has_more is true.

text holds the first 300 characters of each comment, and url opens the complete comment on Reddit when you need the rest.

The Reddit User Comments API charges 0.3 credits for each comment returned, so the default 100 comments cost 30 credits and 1000 comments cost 300.