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.
/api/reddit/sub/:name/about$0.0015 / callA 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.
GET /api/reddit/subreddit?name={name} returns the same thing at the same price (subreddit= works too). Leaving the name out is a free 404 with code: "NAME_REQUIRED" (not billed, like any unknown path).
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,
"weekly_visitors": 96863,
"weekly_contributions": 664,
"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) |
weekly_visitors | number | null | Weekly visitors, as the community card shows it (Reddit's replacement for the member count). null where the source does not show it; on a page-served answer it is then named in meta.unavailable_fields |
weekly_contributions | number | null | Weekly posts and comments, as the community card shows it. null where the source does not show it; on a page-served answer it is then named in meta.unavailable_fields |
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) |
When Reddit turns away the usual read, the response carries X-Read-Source: html_fragment and comes from the subreddit's public pages. title, created_utc, public_description, icon_img and banner_img are still filled, and over_18 is true or false when the sidebar page settles it. subscribers, active_user_count, subreddit_type, lang and description are null on such a read, because those pages do not show them.
Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.
Subreddit Comment Stream
Stream the newest comments across an entire subreddit, not one post's thread. Poll it to catch comments as they are posted, with cursor pagination.
Batch Subreddit Lookup
Fetch subscriber counts, type and metadata for up to 100 subreddits by name in a single call, with the names Reddit did not return listed.
