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

> 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 name can be sent in any casing: `askreddit` is resolved to Reddit's own spelling `AskReddit` and returns the whole object.

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, in any casing (e.g. `AskReddit` or `askreddit`). |
| `url` | no | Subreddit URL |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/reddit/subreddit/details" \
  --data-urlencode "subreddit=AskReddit" \
  -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?