Skip to main content
GET
Search posts

Authorizations

Authorization
string
header
required

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

Query Parameters

q
string
required

Search query

Minimum string length: 1
Example:

"askreddit"

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:relevance

Sort order: relevance (default), hot, top, new, or comments

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

"relevance"

time
enum<string>

Optional time window for search results: hour, day, week, month, year, or all

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

"week"

Response

Returns search results

data
object
required