# Reddit Subreddit Details API (https://www.socialcrawl.dev/platforms/reddit/subreddit-details)

> Returns detailed information about a subreddit including subscriber count, active user count, description, creation date, rules, and subreddit icon URL. Note: the subreddit name is case-sensitive here — pass the subreddit's canonical casing (e.g. `AskReddit`, not `askreddit`). An incorrect casing returns a refunded 404.

TL;DR: `GET /v1/reddit/subreddit/details` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `subreddit` | no | Subreddit name without the r/ prefix. Case-sensitive — use the subreddit's canonical casing (e.g. `AskReddit`). |
| `url` | no | Subreddit URL |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/reddit/subreddit/details" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### 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?

Subscriber and active user counts are pulled directly from Reddit at request time, so they reflect the current public value. Response results are cached briefly for repeat calls — pass the noCache header to force a live fetch.

### 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.

See the full Reddit API: https://www.socialcrawl.dev/platforms/reddit

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get subreddit subscriber count with an API
- What fields does the SocialCrawl subreddit details endpoint return?