Reddit Comments
A Reddit comment is a public reply inside a post discussion, with text, author identity, source-post and parent-comment references, community context, timestamps, and visible vote and reply counts. Reading those fields together makes returned comments useful for response analysis, reply mapping, source-linked archiving, and time-stamped comparison.
Features
- Comments from a specified discussionAccept a supported Reddit post URL or redd.it short link and return the public comment records supplied for that discussion.
- Comment content and authorshipReturn each available comment ID, public URL, text, and author identifiers as a separate normalized record.
- Post and reply referencesExpose post_id, post_url, parent_comment_id, community_name, and input_url so returned comments can be related to their source and to one another.
- Visible response snapshotKeep upvotes_count and replies_count with created_at and collected_at to distinguish publication time from observation time.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required list of public Reddit post URLs using /r/{subreddit}/comments/{post_id} paths on supported Reddit hosts or redd.it short links. |
How to Use
Submit public Reddit post URLs, follow the asynchronous task, and read normalized comment records with cursor pagination.
- Prepare one or more supported public Reddit post URLs or redd.it short links.
- Submit the links as urls to /v1/reddit/comments and store the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
- Read data.results.items, then request the returned next_cursor while has_more remains true.
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/example/comments/post_id/example_post/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Qualitative response review: Analyze comment text with available author fields to identify arguments, questions, and recurring reactions within selected discussions.
- Returned reply relationship mapping: Use comment IDs and parent_comment_id to connect replies that are present in the returned records without assuming the full thread was captured.
- Source-linked comment archiving: Preserve comment URLs, post_id, post_url, community_name, and timestamps so every saved reply retains its discussion context.
- Time-stamped response comparison: Compare upvotes_count and replies_count across returned comments while anchoring each observation to collected_at.
Pro Tips
- Resolve redd.it links and deduplicate by source post before batching so the same discussion is not submitted through multiple URL forms.
- Do not send results_limit; this endpoint rejects it and saves the comments returned for each accepted post URL.
- Use parent_comment_id only to connect records that are actually present in the result set because it does not guarantee complete thread depth.
- Allow text, author fields, parent_comment_id, community_name, timestamps, and metrics to be null when the public source omits them.
- Continue with next_cursor until has_more is false so comments from a completed task are not missed at the API result-page boundary.
Related APIs
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 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.