Skip to main content
GET
Subreddit Search
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

subreddit
string
required

Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)

Example:

"Fitness"

query
string

Search query to find matching content

Example:

"push ups"

filter
enum<string>

Type of content to search for (default: posts). Response will only include the matching key

Available options:
posts,
comments,
media
Example:

"posts"

sort
enum<string>

Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new

Available options:
relevance,
hot,
top,
new,
comments
Example:

"relevance"

timeframe
enum<string>

Timeframe to filter results

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

"all"

cursor
string

Cursor for pagination. Get 'cursor' from previous response

Response

Successful response with search results

Key Response Fields:

  • data.posts[n].id: Reddit fullname of the post (e.g. t3_1o09lhe)
  • data.posts[n].title: Title text of the post
  • data.posts[n].url: Full URL to the Reddit post
  • data.posts[n].votes: Net upvote count
  • data.posts[n].num_comments: Number of comments on the post
  • data.posts[n].created_at_iso: ISO 8601 creation timestamp
  • data.posts[n].subreddit.name: Name of the subreddit the post belongs to
  • data.cursor: Base64 pagination cursor — pass as cursor param to retrieve the next page