100 free credits. No credit card required.Start building
Logo
Reddit logo
100 free credits. No credit card required

Reddit Subreddit Details API

Scrape Reddit Subreddit Details data with one API call. Returns detailed information about a subreddit including the subscriber count at `author.followers`, weekly active users and weekly contributions at `author.ext.weekly_active_users` and `author.ext.weekly_contributions`, the description, creation date, rules, and subreddit icon URL. The subscriber count and Reddit's own community language tag at `author.ext.language` come from a second source that runs only when the main one leaves the count empty, so on a small share of calls they are null while every other field is unchanged. The subreddit name is case-sensitive on the main source: pass the canonical casing (e.g. `AskReddit`, not `askreddit`) to get the whole object. A non-canonical spelling is not a 404 — it falls through to the second source, which still answers with the core fields but without the weekly-activity numbers.

Last updated October 2026Maintained by the SocialCrawl team

Returns a subreddit's own details: subscriber count, active user count, description, creation date, rules, and icon URL.

Use it to size up a community before pulling its posts; the name is case-sensitive here, so spell it exactly as Reddit does.

Searching 68 platforms in parallel

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
Reddit API

What can you do with the Subreddit Details API?

The Subreddit Details endpoint gives you structured Reddit data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/reddit/subreddit/details?subreddit=AskReddit"
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/reddit/subreddit/details",
    params={
    'subreddit': 'AskReddit',
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()
const response = await fetch(
  "https://www.socialcrawl.dev/v1/reddit/subreddit/details?subreddit=AskReddit",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

Parameters

ParameterRequiredDescription
subredditNoSubreddit name without the r/ prefix. Case-sensitive: use the subreddit's canonical casing (e.g. `AskReddit`).
urlNoSubreddit URL
Example Response

What does the Reddit Subreddit Details API return?

Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.

Example response
{
  "success": true,
  "platform": "reddit",
  "endpoint": "/v1/reddit/subreddit/details",
  "data": {
    "author": {
      "id": "AskReddit",
      "username": "AskReddit",
      "display_name": "AskReddit",
      "avatar_url": "https://styles.redditmedia.com/t5_2qh1i/styles/communityIcon_p6kb2m6b185b1.png?width=128&frame=1&auto=webp&s=1124511c3a95cc4ec094a4e8886de1e08a0f1e0a",
      "bio": "r/AskReddit is the place to ask and answer thought-provoking questions.",
      "verified": null,
      "followers": 59785424,
      "following": null,
      "posts_count": null,
      "likes_count": null,
      "url": "https://www.reddit.com/r/AskReddit",
      "private": null,
      "joined_at": "2008-01-25T03:52:15.108Z",
      "ext": {
        "is_nsfw": false,
        "weekly_active_users": 13295443,
        "weekly_contributions": 1097994,
        "rules_text": "1 Rule 1 - Questions must be clear and direct and may not use the body textbox All questions must be clear, written in English, and conclude with a question mark All context in the title must be necessary to understanding the question; do not give “example answers” in the post title (i.e. “Other than your mom, ______?”) No text in the text box - any additional info from you must be added as a comment to your post The full rule can be viewed here\n\n2 Rule 2 - No personal or professional advice requests Askreddit is NOT your personal or professional advice platform Do not makes posts asking for professional advice - medical, legal, financial, or otherwise All posts asking for advice must be generic and not specific to your situation alone Do not use first person pronouns No crowdsourcing naming or purchasing decisions The full rule can be viewed here\n\n3 Rule 3 - Open ended questions only Post must be an open-ended discussion question Title must not be phrased to allow a simple yes/no answer No questions that have definite answers Question must not be a poll or survey No “Either/Or” type questions Do not ask for NSFW links Do not specify a length (eg \"in three words...\") or make your post into a game The full rule can be viewed here\n\n4 Rule 4 - No personal info Do not post or seek any real or fake personal information (examples include: full names, phone numbers, email addresses, or social media accounts) Only link another user's comment when it is relevant and never when it is to launch a personal attack or encourage others to do so Do not ask questions designed to target specific usernames or links to social media The full rule can be viewed here\n\n5 Rule 5 - No loaded questions Do not include an opinion, bias, or lead respondents towards expressing a specific opinion in your post title Do not use this subreddit to promote a specific agenda or to gain positive or negative publicity for an entity or person The full rule can be viewed here\n\n6 Rule 6 - [Serious] tagged posts are off-limits to jokes or irrelevant replies [Serious] posts are off-limits for joke replies and irrelevant or off-topic comments and discussion If the OP asks for answers from a specific group in a [Serious] post, top level comments must be made from members of that group Posts that do not receive relevant answers within an hour will be removed The full rule can be viewed here\n\n7 Rule 7 - No begging for goods or services, or Reddit rewards Do not ask for Reddit rewards, money, goods, services,or favors Do not form a brigade to draw positive or negative attention to posts or comments in AskReddit, even from other subreddits The full rule can be viewed here\n\n8 Rule 8 - Be respectful to other users at all times and conduct your behaviour in a civil manner Do not make personal attacks, insult, or demean a specific group or person Do not use slurs without relevant context and quotes No blatant statements of bigotry No posts that 'bait' users into breaking other rules Zero tolerance for posts/comments that sexualize minors Zero tolerance for posts/comments that encourage suicide The full rule can be viewed here\n\n9 Rule 9 - No image only replies or large ascii art Comment replies must consist of more than just an image or link No ASCII/emoji images over one line The full rule can be viewed here\n\n10 Rule 10 - Harmful Misinformation Do not downplay the effects of a medical crisis Do not undermine the efficacy of vaccines where there is widespread agreement among the medical and scientific communities Do not encourage illegal activity Do not encourage delayed medical treatment The full rule can be viewed here\n\n11 Rule 11 - No spam, machine generated content or karma farming Do not post spam Do not edit comments to mislead and/or advertise Do not farm karma or shotgun comments Bots are not allowed in r/AskReddit The full rule can be viewed here\n\n12 Rule 12 - All content must be written in English All content must be written in English so that it is widely understood by the user base of the sub. Posts not in English will be removed. Comments not in English may be removed. The full rule can be viewed here",
        "language": "en"
      }
    },
    "computed": {
      "engagement_rate": null,
      "language": "en",
      "content_category": "other",
      "estimated_reach": null
    }
  },
  "credits_used": 1,
  "request_id": "req_example000000",
  "cached": false,
  "credits_remaining": 9999,
  "source": "captured",
  "captured_at": "2026-10-02T15:39:31.337Z",
  "redacted": true
}

Live sample illustrating the unified response shape. Field values reflect the record you query.

API Details

How does the Reddit Subreddit Details API work?

Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for Reddit Subreddit Details data?

We handle the complexity of Reddit data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.

One schema, every platform

Query 68 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.

See your data before you code

Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 68 platforms
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
How do I get subreddit details with an API?
Send a GET request to /v1/reddit/subreddit/details with either the subreddit name (no r/ prefix) or the full subreddit URL. SocialCrawl returns subscriber count, active user count, description, creation date, rules, and icon URL.
What fields does the subreddit details endpoint return?
Subscriber count, active user count, full description, creation timestamp, rules array, subreddit icon URL, banner image, NSFW flag, and type (public, restricted, private). Fields are normalised into the SocialCrawl author schema.
Can I pass a subreddit URL instead of the name?
Yes. The endpoint accepts either subreddit (the name without r/) or url (the full URL). Pass exactly one of the two. Useful when ingesting URLs from Reddit scrapers or user submissions without having to parse the slug yourself.
How fresh is the subscriber count?
A cache miss reads the current public subscriber and active-user counts from Reddit. Exact repeats may use the 15-minute profile cache and cost 0 credits, so a cache hit is free; send Cache-Control: no-cache for a billed refresh.
How much does the Subreddit Details API cost?
Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required. Use this endpoint to validate a subreddit exists and is public before calling the subreddit posts endpoint.

Ask AI about SocialCrawl

Ready to scrape Reddit Subreddit Details data?

Get your API key and start pulling Reddit data in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown