Veezee

Subreddit API 4 credits

Fetch one subreddit's profile: title, description, subscriber and active-user counts, age, NSFW flag, and topics. Subscriber counts are the standard community-sizing signal for market research; include_settings adds the community rules and moderator list for 2 credits more, worth reading before posting or judging moderation culture.

The base call costs 4 credits. Name the subreddit without the r/ prefix ('selfhosted') or paste a full URL.

Try it now#

No account, no card: mint a free key in one call, then call the endpoint.

Terminal
curl -s -X POST https://api.veezee.io/v1/keys/mint
Request
curl "https://api.veezee.io/v1/reddit/subreddits?subreddit_name=selfhosted" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Over MCP#

Point an MCP client at https://mcp.veezee.io/reddit (streamable-http; https://mcp.veezee.io/all serves every platform over one connection) and call reddit_get_subreddit:

tools/call
{
  "method": "tools/call",
  "params": {
    "name": "reddit_get_subreddit",
    "arguments": {
      "subreddit_name": "selfhosted"
    }
  }
}

Parameters#

ParamRequiredTypeDescription
subreddit_nameyesstringSubreddit name without the r/ prefix, e.g. 'selfhosted'. Full URLs are accepted and cleaned.
include_settingsnobooleanAlso return rules and moderators for +2 credits.
freshnessnostringrecent (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.
max_creditsnointegerSpend 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.

Returns a subreddit envelope. Full field list: /docs/fields#subreddit.

Pricing#

reddit_get_subreddit costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches are in the full reference). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

FAQ#

Does it return posts?

No: read the feed with the subreddit posts API.

How do I find subreddits I don't know by name?

Search by topic with reddit_search type=subreddits.

What's in settings?

The community's rules and its moderator list.

Read next#