The subreddit posts your agent needs.
Reddit Subreddit returns a subreddit's info, rules and posts, a page at a time. Control the posts by sort and time.
terminal
Reddit Subreddit APIfor AI agents
One API call to read a subreddit. Get its info, rules and posts as JSON.
What people use it for.
Watch a community
Set sort to newest and run the call on a schedule. Compare each postId with the ids you saved to find new posts.
Write a weekly digest
Set sort to top and time to pastWeek. The score and comments fields show which topics got the most attention.
Check a subreddit before you post
Read rules and members before you post. The rules list tells you what the moderators remove.
More Reddit endpoints.
- SearchSearch Reddit posts, subreddits and users
- PostRead a post and its comment thread, with a cursor for the rest of the comments
- 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 Stophy with a Stophy API key. You need no Reddit app, no OAuth token and no Reddit login.
The subreddit and a results list of its posts. The subreddit has subredditName, title, description, members, createdAt, isNsfw and rules. Each post has postId, postUrl, title, text, authorUsername, score, comments, flair and publishedAt.
sort takes hot, newest, top, rising or controversial. The default is hot. time takes pastHour, today, pastWeek, pastMonth, pastYear or allTime.
Yes. The rules field is a list. Each rule has a title and a description, as the subreddit shows them.
Send the cursor from the last response, with the same subreddit, sort and time.
1 credit for each call that returns data. A call that returns an error uses 0 credits.
Yes. Add the MCP server at https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent calls the endpoint by the id redditSubreddit.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.