Reddit · Guide

How to get Reddit subreddit details

TL;DR
To get Reddit subreddit details, sign up for a free Captapi key, then send one GET request to /v1/reddit/subreddit-details with your input. You get clean JSON back in seconds for 1 credit per call — no OAuth, scraping or platform SDKs. Subreddit card — id (t5_…), weekly visitors and contributions, rules[], ISO createdAt. Flat 1 credit.

How to get Reddit subreddit details (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Reddit Subreddit Details API

    Send an authenticated GET request to /v1/reddit/subreddit-details with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

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_..."

What the response looks like

{
  "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": null,
    "activeUsers": null,
    "category": null,
    "language": null,
    "type": null,
    "weeklyVisitors": 376803,
    "weeklyContributions": 3343,
    "createdAt": "2008-01-26T06:07:54.000Z",
    "nsfw": null,
    "submitText": null,
    "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": null,
        "violationReason": null,
        "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": null,
        "violationReason": null,
        "priority": 1
      }
    ],
    "icon": "https://styles.redditmedia.com/t5_2qh87/styles/communityIcon_ub69d1lpjlf51.png",
    "banner": null
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
urlstring YesSubreddit 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.
cachebooleanNoSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

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. 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 access, 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.

Why are members and activeUsers null?

Reddit's public subreddit page no longer shows a member count or an online count. It shows weekly visitors and weekly contributions, which we return as weeklyVisitors and weeklyContributions. We do not estimate the missing numbers.

Where do rules come from?

From the rules list on the subreddit's public about page, as a structured array (name, description, priority). The short public description stays in description.

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. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to get Reddit subreddit details?

Start free with 100 credits — no credit card required.

Get your free API key