Reddit Posts
A Reddit post is a community submission whose public page can expose a title, body, author, flair, media, posting time, and visible voting and comment signals. Linking those fields to the subreddit and capture time makes an individual post usable for source review, content analysis, and time-stamped comparison.
Features
- Direct post resolutionResolve an accepted Reddit discussion URL or redd.it short link into a normalized record for that public post while rejecting subreddit home pages and unrelated paths.
- Post content and attributionReturn the post ID, public URL, title, body text, and available author identifiers so each item can be traced to its source.
- Subreddit and classification contextExpose flair plus the community name, URL, and visible member count under extra when the source provides them.
- Media, engagement, and capture timeKeep media references, created_at, collected_at, upvotes_count, comments_count, and upvote_ratio together in a time-stamped snapshot.
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 the exact public posts you need, follow the asynchronous task, and read the normalized records with cursor pagination.
- Prepare one or more public Reddit post URLs using a supported comments path or redd.it short link.
- Submit the links as urls to /v1/reddit/posts 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/posts" \
-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
- Source-backed post review: Retain post IDs, URLs, titles, body text, and author fields so reviewers can revisit the exact public submissions included in an analysis.
- Cross-community topic comparison: Group titles and body text by community_name and tag to examine how a defined topic is framed across selected subreddits.
- Time-stamped engagement tracking: Store upvotes_count, comments_count, and upvote_ratio with collected_at to compare repeated snapshots without treating the values as permanent.
Pro Tips
- Resolve redd.it links and deduplicate by post identifier before batching because a short link and a full discussion URL can point to the same post.
- Use this endpoint when you already know the post URLs; it does not accept subreddit home pages, search queries, sort controls, or results_limit.
- Allow author, media, tag, community details, timestamps, and metrics to be null when the public source does not expose them.
- Store collected_at beside the visible engagement metrics so later snapshots can be compared without overwriting their observation times.
Related APIs
Use these APIs when you need a different type of public Reddit data.
- 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.