Skip to main content
POST
Search Reddit posts, comments, subreddits and users
  • Endpoint: reddit.search
  • Returns: data has results.
  • Cost: 2 credits. Failed calls cost nothing.
  • Paging: Yes. Send the cursor from the response to get the next page. See Paging.

Example

Authorizations

Authorization
string
header
required

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

Body

application/json
query
string
required
Required string length: 1 - 512
type
enum<string>
default:posts
Available options:
posts,
subreddits,
users
subreddit
string
sort
enum<string>
default:relevance
Available options:
relevance,
hot,
top,
newest,
mostComments
within
enum<string>
default:all
Available options:
hour,
day,
week,
month,
year,
all
includeNsfw
boolean
default:false
limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string
Required string length: 1 - 8192

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required