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

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.

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?