GET /v1/reddit/subreddit-details

Reddit Subreddit Details API

Subreddit card — id (t5_…), members, activeUsers, rules[], ISO createdAt, nsfw/type. Flat 1 credit.

1 credit per request

Try in Playground Get your API key — free Read the docs

TL;DR

Subreddit card — id (t5_…), members, activeUsers, rules[], ISO createdAt, nsfw/type. Flat 1 credit. The Reddit Subreddit Details API (Reddit) is a single authenticated GET request to /v1/reddit/subreddit-details that responds with clean JSON and costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.

What is the Reddit Subreddit Details API?

Pass a subreddit URL, r/name, or bare name (case-insensitive — AskReddit and askreddit both resolve; response name is Reddit's canonical casing) and get clean JSON: stable id (t5_…), name, title, public description, members, activeUsers (accounts currently online — Reddit active_user_count, not weekly uniques), category (advertiser niche), language, type (public/restricted/private), ISO-8601 createdAt, nsfw, submitText, rules[{name,description,kind,violationReason,priority}] from about/rules, icon, and banner. Flat 1 credit. Use it to map communities before sampling posts or comments.

What you get

Stable id (t5_…) + canonical name/url
members + activeUsers (currently online)
rules[] from Reddit about/rules + submitText
ISO createdAt, nsfw, type, language, category, icon/banner

Platform limits

Honest ceilings from the upstream platform surface — not Captapi bugs. Unexpected truncation here is usually the platform, not us.

activeUsers is Reddit's live online count, not weekly active users. Treat ScrapeCreators weekly_active_users with the same caution when the ratio looks unrealistic vs members.
rules[] is empty when the subreddit has no configured rules endpoint payload (rare on large communities).

Try it

Open in Playground

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

Parameters

url*stringSubreddit URL, r/name, or bare name (case-insensitive), e.g. r/technology or AskReddit. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.cacheoptionalbooleanSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

API keyoptionalPaste your key to get a ready-to-run snippet. It stays in your browser.Sign in to run live

curl "https://api.captapi.com/v1/reddit/subreddit-details?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fspace" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Edit the parameters and the code updates instantly. Switch languages and hit copy.

Example response

{
  "success": true,
  "data": {
    "platform": "reddit",
    "id": "t5_2qh87",
    "name": "space",
    "url": "https://www.reddit.com/r/space",
    "title": "/r/space: news, articles and discussion",
    "description": "Share & discuss informative content on:\n\n* Astrophysics\n* Cosmology\n* Space Exploration\n* Planetary Science\n* Astrobiology",
    "members": 27940319,
    "activeUsers": null,
    "category": "Lifestyles",
    "language": "en",
    "type": "public",
    "createdAt": "2008-01-26T06:07:54.000Z",
    "nsfw": false,
    "submitText": "PLEASE **[READ THE SIDEBAR](https://www.reddit.com/r/space/wiki/sidebar_template)** BEFORE POSTING.",
    "rules": [
      {
        "name": "Submissions must be related to Space/Cosmology",
        "description": "This includes \"circlejerky\" submissions or space-related art, with the exception of art from space agencies or historically-significant art.",
        "kind": "link",
        "violationReason": "Submissions must be related to Space/Cosmology",
        "priority": 0
      },
      {
        "name": "No sensationalist/misleading/unscientific content or titles",
        "description": "Post titles need to be descriptive and non-clickbait.  When submitting images titles need to accurately describe the content of the image (e.g. if an image is a composite this needs to be clearly stated), and without attempting to draw in upvotes or comments.  The image should stand on it's own.",
        "kind": "all",
        "violationReason": "No sensationalist/misleading/unscientific content or titles",
        "priority": 1
      }
    ],
    "icon": "https://styles.redditmedia.com/t5_2qh87/styles/communityIcon_ub69d1lpjlf51.png",
    "banner": "https://styles.redditmedia.com/t5_2qh87/styles/bannerBackgroundImage_n7bxapsg3kq81.png"
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Top-level fields

platformPlatform identifier for this response (matches the endpoint's platform).
idStable Reddit fullname (t5_…). Prefer this over name for joins.
nameName of the item or account. On profile endpoints: deprecated alias of displayName (one release).
urlCanonical URL of the item.
titleTitle of the item.
descriptionDescription text.
membersSubscriber count (Reddit subscribers).
activeUsersAccounts currently online on the subreddit (Reddit active_user_count). Not weekly unique actives.
categoryReddit advertiser_category niche label (e.g. Lifestyles). Empty/null when Reddit omits it — not a SponsorBlock enum.
languageDetected or requested language code.
typeSubreddit access type: "public" | "restricted" | "private" | "archived" when Reddit exposes it.
createdAtWhen the subreddit was created (ISO-8601 UTC, e.g. 2008-01-26T06:07:54.000Z).
nsfwWhether Reddit marks the community over-18.
submitTextText shown when submitting a post (community posting guidelines) when configured.
iconIcon URL.
bannerBanner / cover image URL. Canonical across profile endpoints.

Rules

Each item in rules contains:

nameName of the item or account. On profile endpoints: deprecated alias of displayName (one release).
descriptionDescription text.
kindKind. Example: "link".
violationReasonViolation reason.
priorityPriority. Example: 0.

Parameters

Name	Type	Required	Description
url	string	Yes	Subreddit URL, r/name, or bare name (case-insensitive), e.g. r/technology or AskReddit. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
cache	boolean	No	Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh.

Using an AI agent? This endpoint is the MCP tool reddit_subreddit_details via @captapi/mcp. Set it up →

How it works

1. Sign up — get 100 free credits, no card required.
2. Create a key from your dashboard.
3. Send one request to /v1/reddit/subreddit-details and parse the JSON response.

Use cases

Community Enrichment

Pull id, members, activeUsers, rules[], and ISO createdAt.

Research

Map communities (nsfw/type/language) before sampling posts or comments.

Frequently asked questions

What does the Reddit Subreddit Details API do?+

The Reddit Subreddit Details API lets you fetch full metadata and key stats from a public Reddit subreddit details using one GET request to /v1/reddit/subreddit-details. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Reddit Subreddit Details API cost?+

Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Reddit API key or OAuth?+

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the subreddit name case-sensitive?+

No. AskReddit and askreddit both resolve — Reddit is case-insensitive. The response name field uses Reddit's canonical casing.

Is activeUsers weekly active users?+

No. It is Reddit's active_user_count — accounts currently online. That is the public metric Reddit exposes on about.json. Treat third-party “weekly active” fields skeptically when the ratio to members looks unrealistic.

Where do rules come from?+

From Reddit's /r/{name}/about/rules endpoint as a structured array (name, description, kind, …). The short public_description stays in description; submitText is the compose-box guidelines when set.

Is the Reddit Subreddit Details API suitable for production use?+

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

More Reddit APIs

Reddit Subreddit Posts API Reddit Post Details API Reddit Post Comments API Reddit Post Transcript API Reddit Search API Reddit Subreddit Search API

Ready to use the Reddit Subreddit Details API?

Get started free