Reddit Search API

Search Reddit posts by query. Like all Browsable execution endpoints, this route returns the standard run envelope with task metadata, run status, and a result payload when the run completes.

POST /v1/reddit/search

Canonical execution route: /v1/tasks/reddit-search/runs. For the live task contract, inspect GET /v1/tasks/reddit-search.

Parameters

Parameter	Type	Required	Description
query	string	Yes	Search query string.
subreddit	string	No	Optional subreddit scope. Accepts `AskReddit` or `r/AskReddit`.
timeframe	string	No	Optional timeframe: hour, day, week, month, year, or all.
sort	string	No	Optional sort. Global search supports relevance, new, top, and comment_count. Subreddit search also supports hot and comments.
limit	number	No	Maximum number of posts to return.
after	string	No	Cursor returned by the previous response.
before	string	No	Cursor returned by the previous response.

Response

Result Fields

id - Reddit post ID.

title - Post title.

author - Username of the post author.

subreddit - Subreddit name.

score - Post score.

upvoteRatio - Upvote ratio from 0 to 1.

numComments - Comment count.

created - Unix timestamp.

url - Full Reddit URL.

selftext - Post body for text posts.

thumbnail - Thumbnail URL when present.

isVideo - Whether the post is a video.

Code Examples

curl -X POST "https://api.browsable.app/v1/reddit/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence","_run":{"async":false}}'

Try it Out

API Playground

Error Codes

400 Bad Request

The JSON body does not match the task input schema.

401 Unauthorized

Missing or invalid API key.

403 Forbidden

Your account cannot execute the task, usually because of access or credits.

500 Internal Server Error

Reddit search failed upstream.