The Reddit posts your agent needs.
Reddit Search returns posts, subreddits or users for a query, with controls for subreddit, sort and time. Each post comes with its score, comment count and date.
terminal
Reddit Search APIfor AI agents
One API call to search Reddit. Get posts, subreddits and users as JSON.
What people use it for.
Answer from real posts
Search for a product comparison and give the posts to an agent. The score field shows how many readers agreed.
Track mentions
Set query to a product name and sort to newest. Run the call on a schedule to get each new post.
Build a dataset
Set subreddit, sort to top and time to pastYear. Then call reddit.post with each postUrl to get the comment thread.
More Reddit endpoints.
- PostRead a post and its comment thread, with a cursor for the rest of the comments
- SubredditGet a subreddit's info and a page of its posts
- UserGet a user's profile and a page of their posts and comments
- Posts by domainGet Reddit posts that link to a website
- Other discussionsSee where else on Reddit one link was shared, like Reddit's Other discussions
- CommunitiesList Reddit's popular or newest communities
- All Reddit endpointsOne API for Reddit data. Get posts, comment threads, subreddits and users as JSON.
Ways to call it.
- Use the APISend a POST request with a Bearer key. Every endpoint returns success, data, creditsUsed and requestId.
- Use MCPAdd https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent finds an endpoint and calls it.
- Use the SDKInstall the TypeScript or Python client. Call an endpoint by its id, such as youtube.transcript.
- Use the CLICall an endpoint from the terminal. The CLI prints JSON, so you can pipe the result into a script.
Start free. Pay per call after.
No plans and no monthly fee. 1,000 free credits to start, then $1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500. Credits never expire.
Free
Every account starts with free credits. No card needed.
1,000 free credits
$0
- ✓Every source
Pay as you go
Add credits to your balance and spend them one call at a time.
$1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500
$0.0015/ credit
10,000 credits≈ $13.50
Most calls cost 1 credit.
- ✓Never expires
Custom
For teams that need higher rate limits or a source we do not cover yet.
Volume pricing
Custom
- ✓Custom rate limits
- ✓New sources on request
- ✓Direct support
Questions and answers.
No. You call the Stophy API, so you need no Reddit app and no Reddit OAuth token. The first page of a search needs no key. To get later pages, send a Stophy API key.
A results list with up to 25 items, and a cursor when more results exist. Each post has postId, postUrl, title, text, subreddit, authorUsername, score, upvotePercent, comments and publishedAt. Set type to subreddits or users to search those.
subreddit limits the search to one subreddit. sort takes relevance, hot, top, newest or mostComments. time takes pastHour, today, pastWeek, pastMonth, pastYear or allTime. Inside query, Reddit's operators work as typed: title:, selftext:, author:, subreddit:, site:, AND, OR, NOT and quotes.
Send the cursor from the last response, with the same query and filters. A request with a cursor needs an API key.
1 credit for each call that returns data. A call that returns an error or an empty list uses 0 credits. A new account has 1,000 credits.
No. reddit.search returns posts, subreddits and users. To read a post's comment thread, call reddit.post with the postUrl.
Yes. Add the MCP server at https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent calls the endpoint by the id redditSearch.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.