Skip to main content
GET
Get subreddit posts

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as a Bearer token. Example: Authorization: Bearer <your-api-key>

Path Parameters

subreddit
string
required

Subreddit name (with or without r/ prefix)

Example:

"programming"

Query Parameters

count
integer
default:25

Number of posts to fetch (maximum: 100)

Required range: 1 <= x <= 100
Example:

25

cursor
string

Pagination cursor

Example:

"0"

order
enum<string>
default:hot

Sort order: hot (default), new, top, rising, or controversial

Available options:
hot,
new,
top,
rising,
controversial
Example:

"hot"

time
enum<string>

Time window for top or controversial ordering: hour, day, week, month, year, or all (default)

Available options:
hour,
day,
week,
month,
year,
all
Example:

"week"

Response

Returns the subreddit posts

data
object
required