Brand and product mentions
Poll a query sorted by new and store the ids you have seen. Anything new is a fresh mention.
Reddit Search API
Search all of Reddit, or one community, by keyword. You get matching posts back as JSON, sorted and filtered the way you ask. You pay per 10 results returned, and nothing for an empty page.
$0.50 free credit · Google sign-in · No card required
Two search endpoints
| Endpoint | Returns |
|---|---|
GET /reddit/v1/r/{community}/search | Search inside one community |
GET /reddit/v1/search | Search across Reddit |
Search one community for a keyword
curl "https://api.apixstar.com/reddit/v1/r/typescript/search?q=bun&sort=new&limit=25" \ -H "Authorization: Bearer YOUR_API_KEY"
Search all of Reddit over the past week
curl "https://api.apixstar.com/reddit/v1/search?q=%22vector+database%22&sort=top&timeRange=week" \ -H "Authorization: Bearer YOUR_API_KEY"
Search parameters
| Parameter | Values | What it does |
|---|---|---|
q | Any text, required | The search query |
sort | relevance, hot, top, new, comments | Result order |
timeRange | hour, day, week, month, year, all | Only return posts from this window |
limit | 1 to 100, default 25 | Results per request |
cursor | Token from the previous page | Fetch the next page |
includeComments | true or false | Also search comments |
What teams use Reddit search for
Research on a topic
Pull the top posts for a keyword over a month or a year, then fetch each thread for the full discussion.
Grounding for AI answers
Let an agent search Reddit for real user experiences before it answers a question. See the agent setup.
Search returns posts. To read the discussion under a result, pass its id to the comments endpoint.
Search API questions
Can I search inside a single subreddit?
Yes. Call GET /reddit/v1/r/{community}/search with a q parameter. Without a community in the path, GET /reddit/v1/search searches all of Reddit.
Can I search comments as well as posts?
Yes. Add includeComments=true and the request also searches comment listings.
How do I get more than 100 results?
Each request returns up to 100 results and a cursor. Pass that cursor to the next request to get the following page. Each page is billed on the results it returns.
How fresh are the results?
Searches run against Reddit when you call the endpoint, so results reflect what Reddit search returns at that moment. Sort by new to get the most recent matches first.
Run your first Reddit search
Sign in, copy a key and send a query. A search that fails is not charged.
$0.50 free credit · Google sign-in · No card required