How to get Reddit subreddit details
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_…), members, activeUsers, rules[], ISO createdAt, nsfw/type. Flat 1 credit.How to get Reddit subreddit details (step by step)
- 1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
- 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
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": 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 (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.
Request 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. |
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.
Ready to get Reddit subreddit details?
Start free with 100 credits — no credit card required.
Get your free API key