reddit/
popular-feed

The Reddit Popular Feed API collects the posts trending on Reddit's r/popular feed in any of its five sort orders, with title and body, author, score, comment count and media, up to 500 per request.

Reddit Popular Feed API

No input required
Five sort orders
Time window for top
Up to 500 posts
0.5 credits / result
Ready
README

By SocQ · Updated

Reddit Popular Feed

Reddit's popular feed, r/popular, is the stream of posts climbing across the site's communities at once, each with its title and body, author, score, comment count, publish time and attached images or video. Read in different sort orders and time windows, it shows which stories, formats and topics are breaking through platform-wide, which supports early news spotting, content format research and sampling what Reddit is talking about.

Reddit Popular Feed API Features

  • Five ways to order r/popularsort_by reads the feed as best, hot, new, rising or top, and hot is used when the field is left out.
  • Time window for the top orderpublished_within narrows top to the past hour, day, week, month or year, or to all time, with day as the default.
  • Full post records with author and mediaEach Reddit Popular Feed API row carries text with title and body, the post url, the author's username and profile link, score in likes_count, comments_count and media with pixel dimensions.

Reddit Popular Feed API Parameters

ParametersRequiredDescription
sort_byOptionalOrder of r/popular: best, hot (default), new, rising or top.
published_withinOptionalTime window used when sort_by is top: hour, day (default), week, month, year or all.
results_limitOptionalMaximum number of posts to collect, an integer from 1 to 500; defaults to 25.

How to Use the Reddit Popular Feed API

Pick a sort order and a limit for the Reddit Popular Feed API, or send an empty body, then page through the feed.

  1. POST {"sort_by": "hot", "results_limit": 25} to /v1/reddit/popular-feed.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the posts from results.items and load further pages with results.next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sort_by":"hot","results_limit":25}'

Reddit Popular Feed API Use Cases

  • Spotting stories before they peak: Poll sort_by rising or new and watch published_at, likes_count and comments_count to see which posts are gaining speed on r/popular.
  • Weekly roundup of top posts: Request sort_by top with published_within week and list the url, text and score of what broke through over the last seven days.
  • Researching which post formats reach r/popular: Group posts by media type into image, video and text-only, then compare likes_count and comments_count across the groups.

Reddit Popular Feed API Pro Tips

  • Set sort_by to top whenever you use published_within, because the Reddit Popular Feed API applies the time window only to the top order.
  • Record collected_at with each snapshot and dedupe on id, since the same post can appear in consecutive pulls of a fast-moving feed.
  • Send author.username to the Reddit User Profile API when a poster keeps showing up, to check their karma and account age.

Beyond the Reddit Popular Feed 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 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.
  • Reddit Trending Searches API — Get the searches trending on Reddit today with no input, each with its rank and a link to Reddit's results.

Explore other platforms

Combine Reddit data with public data from other supported social platforms.

Reddit Popular Feed API — FAQ

Reddit Popular Feed API is a programmatic interface for collecting the posts on Reddit's r/popular feed in the sort order and time window you choose. It returns each post's title and body, link, author, score, comment count and media.

Every field is optional: an empty request returns the 25 hottest posts on r/popular, while sort_by, published_within and results_limit adjust the order, window and count.

results_limit accepts 1 to 500 posts per request and each post costs 0.5 credits, so the default 25 posts cost 12.5 credits and 500 posts cost 250.