Skip to main content
POST
Reddit Popular Feed API

Reddit Popular Feed

Read r/popular the way Reddit shows it: the posts rising across all communities right now, with title and body, post link, author, score, comment count and media. Switch sort_by to top and pick a window from an hour to all time to see what broke through over a day or a week. Media teams use it to spot stories early, marketers to catch formats that are working, and researchers to sample what the platform is talking about.
All fields are optional. sort_by picks how r/popular is ordered: best, hot (default), new, top or rising; published_within sets the window for top, from hour to all. results_limit defaults to 25 and accepts integers from 1 to 500. Each post costs 0.5 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

All fields are optional. sort_by picks how r/popular is ordered and published_within sets the window for top. results_limit defaults to 25 and accepts integers from 1 to 500.

callback_url
string<uri>
published_within
enum<string>
default:day

Time window used when sort_by is top: hour, day (default), week, month, year or all.

Available options:
all,
day,
hour,
month,
week,
year
Minimum string length: 1
results_limit
integer
default:25
Required range: 1 <= x <= 500
sort_by
enum<string>
default:hot

Order of the feed: best, hot (default), new, top or rising.

Available options:
best,
hot,
new,
rising,
top
Minimum string length: 1

Response

Task accepted

code
integer
data
object