Get subreddit details
reddit_get_subredditRetrieve subreddit subscriber counts and metadata to size a community for market research. Optionally get rules and moderators for additional credits.
Instructions
Fetch one subreddit's profile: title, description, subscriber and active-user counts, age, NSFW flag, and topics. subreddit_name is the name without the r/ prefix, e.g. 'selfhosted'; a full reddit.com URL also works. Set include_settings to also get the community rules and moderator list for +2 credits (useful before posting or judging moderation culture). Costs 4 credits base. Subscriber counts here are the standard sizing signal for market research. This tool does not return posts: read the feed with reddit_get_subreddit_posts, and discover subreddits you don't know by name with reddit_search type=subreddits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| freshness | No | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. | recent |
| max_credits | No | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. | |
| subreddit_name | Yes | Subreddit name without the r/ prefix, e.g. 'selfhosted'. Full URLs are accepted and cleaned. | |
| include_settings | No | Also return rules and moderators for +2 credits. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| usage | Yes | ||
| common | Yes | ||
| entity | Yes | ||
| platform | Yes | ||
| freshness | Yes | ||
| data_as_of | Yes | ||
| canonical_url | Yes | ||
| schema_version | Yes | ||
| platform_fields | Yes |