# Reddit Subreddit Finder (`deepmine/reddit-subreddit-finder`) Actor

Subreddit finder and subreddit search: find subreddits and Reddit communities for any niche or keyword, ranked by subscribers with weekly active users and activity %. Subreddit discovery and a subreddit search API for marketers and community managers.

- **URL**: https://apify.com/deepmine/reddit-subreddit-finder.md
- **Developed by:** [DeepMine](https://apify.com/deepmine) (community)
- **Categories:** Social media, Lead generation, Other
- **Features:** Limited permissions
- **Stats:** 20 total users, 4 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.09 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Reddit Subreddit Finder: Discover Communities for Any Niche

**Find every subreddit talking about your topic. Search multiple queries, get subscriber counts, weekly active users and activity ratios, so you know which communities are worth targeting.**

One run, every relevant subreddit, ranked by size and filtered for quality. First rows in seconds, no login, no browser.

| 🏅 Rank | 👥 Subreddit | 👥 Subscribers | 📈 Weekly Visitors | 📊 Activity % | 🔍 Queries |
|---|---|---|---|---|---|
| 1 | r/productivity | 4,257,060 | 352,936 | 8.29 | productivity |
| 2 | r/antiwork | 3,008,159 | 874,171 | 29.06 | productivity |
| 3 | r/ADHD | 2,299,526 | 635,356 | 27.63 | productivity |

<sub>Collected 2026-10-11 with the query `productivity`.</sub>

***

### What it does

Reddit has thousands of communities for every niche. Finding the right ones by hand is slow: Reddit's own search buries results and shows no useful numbers. This Actor searches Reddit's subreddit search for your topics and returns one structured row per matching community: size, weekly activity, description and which of your queries found it.

Enter `"AI tools"`, `"productivity"`, `"SaaS"` and get back every subreddit that covers those topics, deduplicated, ranked by subscriber count, with an activity ratio showing which communities are actually alive.

***

### Key features

- **Multi-query search**: each topic is searched on its own; results are deduplicated across queries (a subreddit is one row and one charge, however many queries find it)
- **Activity ratio**: `weeklyActiveUsers / subscribers` as a percentage. Finds small-but-engaged communities that a raw subscriber sort would bury
- **Posting activity (optional)**: turn on `includeActivity` to add posts per day, median score, median comments, comments per post, distinct authors and the newest post's age, from each community's newest posts (100 by default). Included in the row price
- **`matchedQueries`**: which of your queries returned each subreddit (useful when a community covers several topics)
- **Subscriber filter**: skip dead communities below a minimum
- **NSFW filter**: adult communities are left out by default
- **Fast and light**: plain HTTPS calls to Reddit's app API through Apify's datacenter proxy; rows go out in rank order as they are ready, so even a run you stop early keeps its top results

***

### Output

One row per subreddit, largest first:

| Field | Description |
|---|---|
| `rank` | Rank by subscriber count across all your queries (1 = largest) |
| `name` | Subreddit name, e.g. `r/learnprogramming` |
| `title` | Subreddit display title |
| `description` | Short public description |
| `subscribers` | Total subscriber count |
| `weeklyActiveUsers` | Weekly visitors Reddit shows on the subreddit's page |
| `activityRatio` | `weeklyActiveUsers / subscribers × 100`: engagement % |
| `url` | Full Reddit URL |
| `nsfw` | Whether the community is marked 18+ |
| `lang` | Community language |
| `createdAt` | Subreddit creation date (UTC) |
| `matchedQueries` | Which of your search queries returned this subreddit |
| `descriptionSnippet` | First 50 characters of the description |
| `iconUrl`, `bannerUrl` | Community icon and banner |
| `weeklyContributions` | Posts and comments made in the past week |
| `postsPerDay`, `medianScore`, `medianComments`, `commentsPerPost`, `distinctAuthors`, `newestPostAgeHours`, `activitySamplePosts` | With `includeActivity` only: posting numbers from the newest posts (100 by default), and how many posts they come from |
| `communityAgeDays` | Days since the subreddit was created |
| `subredditType` | public, restricted, private, archived or user |
| `category` | Reddit's advertiser category, when set |
| `fullDescription` | The full sidebar text (rules and links) |
| `submissionType`, `allowImages`, `allowVideos`, `restrictPosting` | What members can post |
| `quarantined` | Whether Reddit quarantined the community |
| `adWhitelistLevel`, `whitelistStatus` | Reddit's ad suitability code and name |
| `id` | Reddit's id (`t5_...`) |
| `scrapedAt` | When the run read it |

Unknown values are `null` (for example `weeklyActiveUsers` when Reddit doesn't show it). The Output tab has three views: 📊 Overview, 📈 Stats and 🗓️ Activity (empty unless `includeActivity` is on: the run's prefill leaves it off). The run's summary (per-query counts) is in the `OUTPUT` record.

***

### Getting started

1. Enter your topics (e.g. `AI tools`, `project management`, `bootstrapped SaaS`)
2. Set `minSubscribers` to filter out dead communities (default: 1,000)
3. Run: results come back ranked by subscriber count with activity ratios
4. Found the right communities? Paste them into [Reddit Scraper](https://apify.com/deepmine/reddit-scraper) for their posts and comments, and a post link into [Reddit Comments Scraper](https://apify.com/deepmine/reddit-comments-scraper) for the whole thread.

***

### Use cases

**Community targeting for marketers.** Find every subreddit where your audience already hangs out. Use `activityRatio` to put engaged communities ahead of large-but-dead ones. Export to a spreadsheet and plan your community strategy.

**Reddit advertising.** Reddit ads target specific subreddits. Discover all communities relevant to your product before building your targeting list.

**Content distribution.** Find where to post your content for the most reach. `matchedQueries` shows which communities cover several angles of your topic: those are your best bets.

**Competitor research.** Search your competitor's brand name and product category to find where their users gather.

**Niche validation.** Low subscriber counts mean a limited audience; high activity ratios mean passionate communities. Use both to size an opportunity.

***

### Input

| Parameter | Default | Description |
|---|---|---|
| `queries` | (required) | Search topics |
| `maxResultsPerQuery` | `25` | Subreddits per query after the filters (max 100; Reddit's subreddit search ends after about 200) |
| `minSubscribers` | `1000` | Leave out communities smaller than this |
| `includeNSFW` | `false` | Include adult communities |
| `includeActivity` | `false` | Add posting numbers from each community's newest posts (one more request per subreddit; same price per row) |
| `activitySampleSize` | `100` | How many newest posts those numbers come from (10-100; 25 answers about twice as fast) |

Tip: a big run with `includeActivity` reads a lot of post data. Giving it 1 GB of memory (Run options) makes it about twice as fast: 74 subreddits with activity took 12 s at 1 GB and 27-30 s at the default 256 MB. Runs without it are just as fast at 256 MB.
| `proxyConfiguration` | Apify datacenter | Reddit answers the datacenter proxy. If you pick Residential, the run still reads on datacenter and keeps residential for retries |

***

### Activity ratio explained

`activityRatio = (weeklyActiveUsers / subscribers) × 100`

A subreddit with 500,000 subscribers and 2,000 weekly visitors has an activity ratio of 0.4%: effectively dead. One with 8,000 subscribers and 3,500 weekly visitors has 43.75%: an engaged community where your posts will be seen.

Use it to sort by engagement rather than raw size when you want communities to take part in, not just advertise to.

***

### Related Actors

- **[Reddit Scraper](https://apify.com/deepmine/reddit-scraper)**: once you've found the right subreddits, get their posts, comments and users
- **[Subreddit Trend Finder](https://apify.com/deepmine/subreddit-trend-finder)**: what is rising right now in the communities you found
- **[Reddit Lead Generation Scraper](https://apify.com/deepmine/reddit-lead-gen-scraper)**: the posts and comments in those communities that ask for a recommendation or a switch
- **[Reddit Comments Scraper](https://apify.com/deepmine/reddit-comments-scraper)**: paste a post link for every comment and reply
- **[Reddit API](https://apify.com/deepmine/reddit-api)**: the same data from your own code, with ready-made examples

***

*Built for marketers, community managers, content strategists and Reddit advertisers who need to find their audience fast.*

# Actor input Schema

## `queries` (type: `array`):

Topics, niches, brands or industries to find subreddits for, one per line. Each query is searched on its own; a subreddit several queries find is one row (and one charge), with every query that found it in `matchedQueries`.

Examples: 'AI tools', 'personal finance', 'SaaS', 'woodworking'.

## `maxResultsPerQuery` (type: `integer`):

How many subreddits to return for each query, after the filters below (Reddit's subreddit search ends after about 200 results).

## `minSubscribers` (type: `integer`):

Leave out subreddits smaller than this, to skip dead or spam communities. 0 keeps everything.

## `includeNSFW` (type: `boolean`):

Include communities marked 18+.

## `includeActivity` (type: `boolean`):

Also read each subreddit's newest posts and add posts per day, median score, median comments, comments per post, distinct authors and the newest post's age to its row. Included in the row price; it adds one request per subreddit, so runs take a little longer.

## `activitySampleSize` (type: `integer`):

With Include posting activity: how many of each subreddit's newest posts the numbers come from. 100 gives steadier numbers; 25 answers about twice as fast.

## `proxyConfiguration` (type: `object`):

Reddit's app API answers Apify's datacenter proxy, so the default is all you need. If you pick Residential, the run still reads through datacenter and keeps residential for retries Reddit refuses there.

## Actor input object example

```json
{
  "queries": [
    "AI tools",
    "productivity",
    "SaaS"
  ],
  "maxResultsPerQuery": 25,
  "minSubscribers": 1000,
  "includeNSFW": false,
  "includeActivity": false,
  "activitySampleSize": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `subreddits` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "AI tools",
        "productivity",
        "SaaS"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("deepmine/reddit-subreddit-finder").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": [
        "AI tools",
        "productivity",
        "SaaS",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("deepmine/reddit-subreddit-finder").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "AI tools",
    "productivity",
    "SaaS"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call deepmine/reddit-subreddit-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepmine/reddit-subreddit-finder"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rIRGWCnDbVwbZjqT9/builds/iHiHMk3lHoohRM29r/openapi.json