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
| Parameters | Required | Description |
|---|---|---|
sort_by | Optional | Order of r/popular: best, hot (default), new, rising or top. |
published_within | Optional | Time window used when sort_by is top: hour, day (default), week, month, year or all. |
results_limit | Optional | Maximum 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.
- POST {"sort_by": "hot", "results_limit": 25} to /v1/reddit/popular-feed.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.