Subreddit API
Read a subreddit's member count, description and rules, list its posts by hot, new or top, and find communities that match a topic. JSON back, one key.
The job
To get posts from a subreddit by API, list its feed by hot, new or top and page through with the cursor. Before you post, advertise or study a community, you want to know how big it is, what its rules say and what gets upvoted there. This API gives you those three answers as data instead of a manual check.
It is read-only. It reads public community pages and cannot post, join or moderate.
How it works
Read the community
Call
reddit.subredditwith a name to get members, description and rules.List its posts
Call
reddit.subreddit_postswith a sort and a time window.Find communities
Call
reddit.communitieswith a topic to find subreddits that match it.
Endpoints that do it
| Endpoint | What it's for | Credits |
|---|---|---|
| Get a subredditGET /v1/reddit/subreddits/{name} | Members, description and rules for one subreddit. | 2 credits |
| List subreddit postsGET /v1/reddit/subreddits/{name}/posts | A subreddit's posts by sort. | 2 credits |
| Search subredditsGET /v1/reddit/subreddits/search | Subreddits that match a topic. | 2 credits |
Free tools for the same job
Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.
Reading a subreddit
Call the subreddit endpoint with a name to see its size and rules.
curl "https://api.chatterapi.com/v1/reddit/subreddits/SaaS" \
-H "Authorization: Bearer $CHATTERAPI_KEY"{
"data": {
"name": "SaaS",
"title": "Software as a Service",
"description": "Discussions and useful links for SaaS owners, online business owners, and more.",
"subscribers": 820451,
"createdAt": "2008-07-31T21:06:38.000Z",
"nsfw": false,
"url": "https://www.reddit.com/r/SaaS/",
"rules": [
{
"title": "Submission Guidelines",
"description": "Follow the Reddit site-wide rules and please treat others with respect, stay on-topic, and avoid non-productive self-promotion.\n\n",
"appliesTo": "all"
},
{
"title": "Posting SaaS Relevant Content Only",
"description": "Please keep the discussions oriented around the SaaS ecosystem, tech companies, business, operational or even personal aspects of the tech business world.\n\n- __Strict Focus:__ Content must touch on SaaS-specific topics.\n…",
"appliesTo": "all"
},
{
"title": "No Vendor Spam on posts or comments",
"description": "Promotion is allowed occasionally, but accounts focused solely on it will be removed.\n- __Limit:__ Max 1 mention or 3 links can be shared every 60 days\n- __Transparency:__ Must clearly disclose affiliation at the beginn…",
"appliesTo": "all"
},
{
"title": "No Low-Effort / Low-Quality Content",
"description": "- **Posts and comments must provide actual value:** Content that is spammy, repetitive, or lacks depth will be removed.\n- **Originality is required:** All posts must showcase original human thought, clear context, and me…",
"appliesTo": "all"
},
{
"title": "No selling, soliciting, or fundraising",
"description": "This community is for knowledge exchange, not a marketplace, posts or comments focused on selling services, soliciting clients, or asking for donations/funding are not allowed.\n\n- __No Solicitation:__ Do not post or comm…",
"appliesTo": "all"
},
{
"title": "AMA / Surveys / Polls require approval",
"description": "All research-related posts must be vetted by moderators before being posted.\n- __What's Included:__ Academic surveys, market research, vendor polls, and \"product validation\" forms\n- __How to apply:__ Message the mods via…",
"appliesTo": "all"
},
{
"title": "No obfuscated, shortened or indirect URLs",
"description": "All links must point directly to the final resource because indirect URLs are prone to breaking or being hijacked later. Transparency and security are mandatory.\n- __Disguised or obfuscated links:__ Lead to a direct ban …",
"appliesTo": "all"
},
{
"title": "No Personal Information (Doxing)",
"description": "This follows a site-wide rule, strict adherence to Reddit’s Content Policy is required.\n- __Zero Tolerance:__ Do not post real names, emails, phone numbers, or private social media profiles (yours or others).\n- __Screens…",
"appliesTo": "all"
},
{
"title": "Be excellent to eachother",
"description": "We value authenticity. Whether your tone is formal, professional, informal or sarcastic, it’s welcome as long as it’s respectful.\n- __No Toxicity:__ Personal attacks, insults, harassment, or \"flame wars\" are strictly pro…",
"appliesTo": "all"
},
{
"title": "No \"I'll review/audit/feedback/test/roast or create something for you\" posts",
"description": "Posts or comments offering free reviews, audits, roasts, or feedback on others' products/websites/pitches are prohibited, regardless of price or stated intent.\n- __No self-promotion:__ These posts function as personal or…",
"appliesTo": "all"
},
{
"title": "No Promotional or Advertising SaaS",
"description": "r/SaaS does not allow promotion, recommendation, launch announcements, feedback requests, recruiting, or user acquisition for SaaS products made for advertising, promotional outreach, lead/opportunity detection, or ad/co…",
"appliesTo": "all"
}
],
"moderators": [
{
"name": "Dubinko",
"since": "2026-04-13T18:27:26.000Z"
},
{
"name": "ergonet",
"since": "2026-04-13T18:27:30.000Z"
},
{
"name": "bot-bouncer",
"since": "2026-04-06T17:50:57.000Z"
},
{
"name": "FluidIdea",
"since": "2026-04-13T20:46:41.000Z"
},
{
"name": "baganga",
"since": "2026-04-13T21:47:14.000Z"
},
{
"name": "modmail-userinfo",
"since": "2026-04-16T10:57:11.000Z"
},
{
"name": "evasion-guard",
"since": "2026-04-16T11:00:20.000Z"
},
{
"name": "scanslop",
"since": "2026-04-17T21:44:59.000Z"
},
{
"name": "AutoModerator",
"since": "2026-04-24T08:36:04.000Z"
}
],
"posting": {
"submissionType": "any",
"restrictPosting": true,
"linkFlairEnabled": true,
"allowImages": true,
"allowVideos": true,
"allowPolls": false,
"allowGalleries": false,
"submitText": null
}
}
}Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.
What it won't do
- It is read-only. It cannot post, join or moderate.
- Private and banned communities are not returned.
- Reddit's content rules apply to what you do with the data.
Questions
How do I get subreddit posts through the API?
reddit.subreddit_posts with the subreddit name, a sort and a time window. It returns posts with title, score, comment count and link, plus a cursor for the next page.Can I get a subreddit's rules?
Can I find subreddits for a topic?
Is there a page for each subreddit's stats?
Guides
More ways to use the API
- Access the Twitter API
- Claude Reddit bot
- Live Twitter monitor
- Reddit API application
- Reddit brand monitoring
- Reddit data export
- Reddit post API
- Reddit scraper API
- Social listening API
- Post with the Twitter API
- Twitter API statuses
- Twitter exporter
- Twitter scraper API
- Twitter webhook
- Reddit comments API
- Reddit user API
- Twitter followers API
- Twitter user API
- Twitter search API
- Social media scraping API
- Reddit listening tool
- Twitter feed API
- Twitter hashtag API
- Social media analytics API
- Twitter image API