Subreddit API

Get the details of a subreddit by name: title, description, subscriber count, creation date, icon and banner, posting settings and the community rules.

Endpoint: POST /reddit/get-subreddit
Price: 1 credit per request
SDK: client.reddit.getSubreddit()
MCP tool: reddit_get_subreddit

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/reddit/get-subreddit" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subreddit": "programming"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/reddit/get-subreddit",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "subreddit": "programming",
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/reddit/get-subreddit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "subreddit": "programming"
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.reddit.getSubreddit({
  subreddit: "programming"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Subreddit API return?

Subreddit API: get any subreddit’s details by name as JSON, with description, subscriber count, creation date, posting settings and community rules. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

subredditstringrequired: Subreddit name, with or without the "r/" prefix, or the subreddit link, e.g. "programming" or "https://www.reddit.com/r/programming/".

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "id": "string",
    "fullname": "string",
    "name": "string",
    "namePrefixed": "string",
    "title": "string",
    "description": "string",
    "publicDescription": "string",
    "subscribers": 0,
    "activeUserCount": 0,
    "over18": true,
    "quarantine": true,
    "subredditType": "string",
    "submissionType": "string",
    "lang": "string",
    "url": "string",
    "subredditUrl": "string",
    "createdUtc": 0,
    "iconUrl": "string",
    "bannerUrl": "string",
    "headerImageUrl": "string",
    "primaryColor": "string",
    "keyColor": "string",
    "bannerBackgroundColor": "string",
    "wikiEnabled": true,
    "restrictPosting": true,
    "restrictCommenting": true,
    "allowImages": true,
    "allowVideos": true,
    "allowGalleries": true,
    "allowPolls": true,
    "spoilersEnabled": true,
    "rules": [
      {
        "shortName": "string",
        "description": "string",
        "violationReason": "string",
        "kind": "string",
        "priority": 0,
        "createdUtc": 0
      }
    ],
    "siteRules": [
      "string"
    ]
  }
}

[ USE CASES ]

What can you build with the Subreddit API?

Vet communities

Check size, activity and rules before you post in a subreddit.

Track growth

Record subscriber counts over time for the communities you follow.

Respect the rules

Read a subreddit’s rules before an agent or tool posts on your behalf.

[ FAQ ]

Subreddit API questions

How do I get a subreddit’s subscriber count?

Send the subreddit’s name, with or without r/. The response has the subscriber count along with the title, description, creation date, icon, banner, posting settings and rules.

Can I read a subreddit’s rules before posting there?

Yes. The rules come back with the subreddit’s details and posting settings, so a tool can check a post against them before it is submitted.

How do I use the Subreddit API?

Send a POST request to https://api.bridgly.app/reddit/get-subreddit with subreddit in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.reddit.getSubreddit(). AI agents connected to Bridgly over MCP can call the reddit_get_subreddit tool.

How much does the Subreddit API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

Try it with a free tool

Look up a public example in your browser before connecting the API. No account needed.

RedditSubreddit Stats ViewerEnter a subreddit name to see its subscribers, age, description and rules, before you post there.Open tool →

[ MORE ENDPOINTS ]

More Reddit endpoints

The same API key works on every endpoint. See all Reddit API endpoints.

Try the Subreddit API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs