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.
Combine Reddit data with public data from other supported social platforms.