Get a Subreddit's Metadata (Subscribers, Type)

Fetch a subreddit's public metadata by name: title, description, subscriber and active-user counts, creation date, type, and NSFW flag.

GET/api/reddit/sub/:name/about$0.002 / call

A subreddit's public metadata (Reddit's /r/<name>/about data): title, public description, subscriber count, creation date, type, and NSFW flag. Returns a single object, not a list.

When to use this

Use it to size or vet a community before you list or search its posts: check how many subscribers it has, whether it is public/restricted/private, whether it is over-18, and read its description. One read.

Path Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Subreddit name (no `r/` prefix)

A subreddit that does not exist returns 404.

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/sub/Python/about"

const response = await fetch(
  "https://api.redditapis.com/api/reddit/sub/Python/about",
  { headers: { Authorization: "Bearer TOKEN" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.redditapis.com/api/reddit/sub/Python/about",
    headers={"Authorization": "Bearer TOKEN"},
)

Response Shape

{
  "name": "Python",
  "id": "2qh0y",
  "fullname": "t5_2qh0y",
  "title": "Python",
  "display_name_prefixed": "r/Python",
  "public_description": "The official Python community for Reddit!",
  "description": "...",
  "subscribers": 1500869,
  "active_user_count": 1240,
  "created_utc": 1201261935,
  "created": "2008-01-25T12:32:15.000Z",
  "over_18": false,
  "subreddit_type": "public",
  "url": "/r/Python/",
  "lang": "en",
  "icon_img": "https://b.thumbs.redditmedia.com/...png",
  "banner_img": "https://styles.redditmedia.com/...png"
}

Response Fields

Field	Type	Notes
`name`	string	Subreddit name (the `display_name`, no `r/` prefix)
`id`	string	Subreddit id without prefix
`fullname`	string	Full id with the `t5_` prefix
`title`	string	Subreddit title
`display_name_prefixed`	string	The `r/name` form
`public_description`	string	Short public blurb
`description`	string \| null	Full sidebar description (markdown)
`subscribers`	number	Subscriber count
`active_user_count`	number \| null	Users online now (Reddit often omits this, may be `null`)
`created_utc`	number	Unix epoch seconds
`created`	string \| null	ISO-8601 form of `created_utc`
`over_18`	boolean \| null	`true` if the subreddit is NSFW
`subreddit_type`	string	`public` \| `restricted` \| `private` \| ...
`url`	string	Subreddit path, e.g. `/r/Python/`
`lang`	string \| null	Primary language code (e.g. `en`)
`icon_img`	string \| null	Community icon URL (may be empty / `null`)
`banner_img`	string \| null	Banner image URL (may be empty / `null`)

Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.