Find subreddits by topic 6 credits

Audience research starts with "where does this niche hang out". reddit_search with type=subreddits turns a topic into matching communities, ready to size with the subreddit API's subscriber and active-user counts and to read with the subreddit posts API.

Each search page costs 6 credits. Broad topics do better decomposed into several narrower queries: result depth per query caps upstream around a few hundred.

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/search?query=self+hosting&type=subreddits" \
  -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_search:

tools/call

{
  "method": "tools/call",
  "params": {
    "name": "reddit_search",
    "arguments": {
      "query": "self hosting",
      "type": "subreddits"
    }
  }
}

Parameters#

Param	Required	Type	Description
`query`	yes	`string`	Free-text keywords, e.g. 'self hosted photo backup'. Not a URL; use reddit_resolve_url for URLs.
`type`	no	`string`	What to search. 'comments' finds mentions inside discussions; 'subreddits' finds communities.
`sort`	no	`string`	posts: any value; comments: relevance\|top\|new; invalid for subreddits and users.
`range`	no	`string`	Time window. posts only.
`cursor`	no	`string`	Cursor from a previous page.
`freshness`	no	`string`	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.
`max_credits`	no	`integer`	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.

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

Pricing#

reddit_search costs 6 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#

How do I judge whether a community fits?

Fetch its profile: subscriber and active-user counts size it, and include_settings adds the rules and moderator list before you post.

Can I find users the same way?

Yes: type=users finds accounts by topic.

What comes after finding communities?

A sort=new poll on each feed is the standard monitoring loop; worked costs at /use-cases/brand-monitoring.