Reddit Posts API

Reddit Posts

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

How to Use

Submit the exact public posts you need, follow the asynchronous task, and read the normalized records with cursor pagination.

1. Prepare one or more public Reddit post URLs using a supported comments path or redd.it short link.
2. Submit the links as urls to /v1/reddit/posts and store the returned task_id.
3. Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
4. 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 true

Best 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