Skip to content

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.

Look up a subreddit now, no signupThen call the same data from code.

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

  1. Read the community

    Call reddit.subreddit with a name to get members, description and rules.

  2. List its posts

    Call reddit.subreddit_posts with a sort and a time window.

  3. Find communities

    Call reddit.communities with a topic to find subreddits that match it.

Endpoints that do it

EndpointWhat it's forCredits
Get a subredditGET /v1/reddit/subreddits/{name}Members, description and rules for one subreddit.2 credits
List subreddit postsGET /v1/reddit/subreddits/{name}/postsA subreddit's posts by sort.2 credits
Search subredditsGET /v1/reddit/subreddits/searchSubreddits 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"
response, first 2 rows
{
  "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?
Call 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?
Yes. The subreddit call returns the rules along with the description and member count.
Can I find subreddits for a topic?
Yes. The communities call searches by topic. The free subreddit finder does it in your browser.
Is there a page for each subreddit's stats?
For the communities we track, yes. See the subreddit stats pages.

More ways to use the API

Build it with one API key

Try it free for 7 days with 1,000 credits.