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
| Parameters | Required | Description |
|---|---|---|
username | Required | One Reddit username, with or without the u/ prefix, made of 3 to 20 letters, digits, hyphens or underscores. |
sort_by | Optional | Order of the comments: new (default), top or hot. |
results_limit | Optional | Maximum 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.
- POST {"username": "spez", "sort_by": "top", "results_limit": 100} to /v1/reddit/user-comments.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.