# Subreddit Trend Finder (`deepmine/subreddit-trend-finder`) Actor

Catch trending Reddit posts before and as they go viral. Scans multiple subreddits simultaneously, scores content by real engagement velocity, and surfaces the fastest-rising posts ranked by momentum — not just raw upvotes. Built for marketers, social media managers, journalists, and creators.

- **URL**: https://apify.com/deepmine/subreddit-trend-finder.md
- **Developed by:** [DeepMine](https://apify.com/deepmine) (community)
- **Categories:** Social media, Lead generation, News
- **Stats:** 10 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$25.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Subreddit Trend Finder — Reddit Trend Tracker & Viral Post Monitor

**Find trending Reddit posts before they go viral. Monitor any subreddit, track rising content across multiple communities, and surface the topics gaining real momentum — right now.**

Whether you're a content marketer looking for trending topics, a social media manager hunting for viral content, or a brand analyst monitoring Reddit communities, Subreddit Trend Finder gives you ranked, scored, actionable Reddit trend data on demand.

***

### What Is Subreddit Trend Finder?

Subreddit Trend Finder is an Apify Actor that scans one or more subreddits, scores every post by engagement velocity, and returns a ranked list of the content gaining the most traction right now.

Unlike a basic Reddit scraper that just dumps raw posts, this tool scores every post with a **composite trend score** based on how fast it's gaining upvotes and comments relative to its age. Posts gaining momentum fast rank higher than older posts sitting on stale upvotes — giving you a real signal of what's actually trending, not just what's already popular.

You can scan a single subreddit or dozens at once. Results are sorted globally across all subreddits so you always see the hottest content first, regardless of which community it came from.

***

### Key Features

- **Multi-subreddit scanning** — monitor any number of subreddits in a single run, ranked together
- **Velocity-based trend scoring** — every post gets a composite trend score based on engagement speed, not just raw vote count
- **Viral content detection** — catches posts gaining momentum before they peak using multiple content source signals
- **Rising trend signals** — dedicated focus on content that's accelerating fast, the strongest early indicator of a viral trend
- **Trend labels** — posts are automatically labelled: 🔥 Viral, 📈 Rising Fast, ⬆️ Gaining, 📊 Steady
- **Post type filtering** — filter to link posts only (articles, news, videos) or text/discussion posts only
- **Monitor mode** — schedule recurring runs to track how post scores change over time with `scoreDelta`
- **Flexible input** — accepts subreddit names in any format: `gaming`, `r/gaming`, or full Reddit URL
- **Clean structured output** — every result includes rank, trend score, title, URL, upvote ratio, comment count, age, and more
- **Separate dataset output** — optionally split link posts and text posts into separate datasets for downstream processing

***

### Who Uses This?

#### Content Marketers & Bloggers

Find trending topics in any niche before they saturate Google. Reddit surfaces trends days or weeks before they appear in mainstream search. Use Subreddit Trend Finder to discover what your audience is talking about right now and build content around it while the topic is still rising.

#### Social Media Managers

Monitor relevant subreddits to spot viral posts and trending narratives early. Adapt the content for your brand's social channels before competitors catch on. Perfect for Twitter/X, LinkedIn, Instagram, and TikTok content calendars.

#### OnlyFans Agencies & Adult Content Creators

Track which content niches and topics are exploding on relevant subreddits. Identify trends in fan communities to stay ahead of demand, plan content that matches what audiences are actively searching for, and monitor competitor communities.

#### Digital Marketers & Growth Hackers

Reddit is one of the most powerful early-signal platforms on the internet. Trending subreddit posts often predict what will dominate Google Trends within days. Use this tool to get ahead of the curve on emerging topics, memes, products, and conversations.

#### SEO Specialists & Keyword Researchers

Reddit discussions surface organic long-tail keywords that don't show up in traditional keyword tools. Trending post titles and comment threads are goldmines for content gap analysis, topic clustering, and finding untapped search demand.

#### Journalists & Media Researchers

Monitor news subreddits like r/worldnews, r/news, and niche community boards to catch breaking stories and trending narratives before they hit mainstream media. Track which angles are resonating with Reddit audiences in real time.

#### E-commerce & Product Teams

Monitor product subreddits, shopping communities, and category-specific boards to catch trending products, common complaints, and emerging consumer desires. Ideal for Amazon sellers, Shopify store owners, and product managers.

#### Finance, Crypto & Trading Analysts

Track trending discussions across r/wallstreetbets, r/CryptoCurrency, r/investing, r/stocks and other financial communities. Catch sentiment shifts and trending tickers early. Monitor how fast specific topics are gaining engagement as a signal for emerging market interest.

#### YouTubers, Podcasters & Content Creators

Never run out of content ideas. Scan subreddits in your niche to find what your audience is most interested in right now. Trending Reddit posts are a direct window into what people want to watch, listen to, and read about.

#### Brand Managers & PR Teams

Monitor brand-relevant subreddits to track sentiment, spot emerging issues, and identify when topics related to your brand or competitors are gaining rapid traction.

#### Startup Founders & Product Researchers

Reddit communities are filled with unfiltered user pain points, feature requests, and product feedback. Track trending discussions in your target market to validate ideas and spot opportunities before they're obvious.

#### Game Developers & Gaming Communities

Monitor r/gaming, game-specific subreddits, and esports communities to track trending games, patch reactions, and community sentiment spikes in real time.

***

### Output — What You Get

Every run returns a ranked dataset of trending posts. Each record includes:

| Field | Description |
|---|---|
| `rank` | Position in final results (1 = most trending) |
| `trendScore` | Composite trend score — higher means more momentum |
| `trendLabel` | 🔥 Viral / 📈 Rising Fast / ⬆️ Gaining / 📊 Steady |
| `title` | Post title |
| `postUrl` | Full Reddit link to the post |
| `externalUrl` | Linked article or video URL (if link post) |
| `subreddit` | Which subreddit this came from |
| `author` | Post author username |
| `score` | Raw upvote count |
| `upvoteRatio` | Ratio of upvotes to total votes (0–1) |
| `numComments` | Total comment count |
| `postAgeHours` | How old the post is in hours |
| `createdAt` | ISO 8601 timestamp |
| `scoreVelocity` | Upvotes per hour |
| `commentVelocity` | Comments per hour |
| `feedsFoundIn` | Which content sources this post appeared in |
| `flair` | Post flair/tag (if any) |
| `domain` | Domain of linked content |
| `isVideo` | Whether the post is a video |
| `isSelf` | Whether this is a text/self post |
| `thumbnail` | Thumbnail image URL |
| `scoreDelta` | Score change since last run (monitor mode only) |

***

### Getting Started

1. **Add your subreddits** — Enter one or more subreddit names. Any format works: `technology`, `r/technology`, or `https://reddit.com/r/technology`.

2. **Choose your content sources** — Toggle Hot, Rising, and New posts on or off. All three are enabled by default for the broadest signal coverage.

3. **Set your filters** — Choose post type (all, links only, or text posts only), minimum upvote threshold, and how many results you want back.

4. **Run** — Results appear in the dataset tab, ranked by trend score. The top result is the most trending post across all your subreddits right now.

***

### Input Parameters

| Parameter | Default | Description |
|---|---|---|
| `subreddits` | — | Subreddits to scan (required) |
| `fetchHot` | `true` | Include hot posts |
| `fetchRising` | `true` | Include rising posts |
| `fetchNew` | `true` | Include new posts |
| `postType` | `all` | Filter: `all`, `links_only`, or `self_only` |
| `separateDatasets` | `false` | Split link posts and text posts into separate datasets |
| `postsPerSource` | `25` | Posts to collect per source per subreddit (max 100) |
| `maxResults` | `50` | Number of top results to return |
| `minScore` | `5` | Minimum upvote count to include a post |
| `trackChanges` | `false` | Enable monitor mode for score delta tracking |
| `proxyConfiguration` | Residential | Proxy settings |

***

### Monitor Mode — Track Reddit Trends Over Time

Enable **Track Score Changes Between Runs** to turn the actor into a full Reddit trend monitoring tool.

In monitor mode, each run saves a snapshot of post scores. On subsequent runs, every result includes a `scoreDelta` field showing exactly how many upvotes a post gained since the last snapshot. This tells you not just what's trending now, but what's **accelerating** — the posts gaining ground fastest between your monitoring windows.

**Ideal setup:** Use Apify's built-in scheduler to run this actor every 1–6 hours on your target subreddits. You'll get a continuous stream of trend data showing what's rising, what's peaked, and what's emerging — perfect for newsrooms, trading desks, marketing teams, and anyone who needs a real-time pulse on Reddit communities.

***

### Trend Scoring Explained

Each post receives a composite **trend score** that prioritizes momentum over raw popularity. A post with 500 upvotes in 2 hours scores significantly higher than a post with 2,000 upvotes from 3 days ago. Posts that appear across multiple content sources receive a bonus, as cross-source appearance is a strong signal of breakout momentum.

The final score determines:

- 🔥 **Viral** — exceptional momentum, likely already spreading beyond Reddit
- 📈 **Rising Fast** — strong and accelerating, catch it now
- ⬆️ **Gaining** — solid upward trajectory
- 📊 **Steady** — consistent engagement but not spiking

***

### Frequently Asked Questions

**Can I scan multiple subreddits at once?**
Yes — add as many as you want. Results are ranked globally across all of them, so the #1 result is always the single most trending post across your entire subreddit list.

**How is this different from just browsing Reddit?**
Reddit's native interface shows you what's popular right now, but it doesn't rank across multiple communities, doesn't score by velocity, doesn't filter by post type, and can't be automated or integrated into workflows. This actor gives you structured, scored, programmable data you can pipe into any system.

**Can I use this for Reddit competitor monitoring?**
Yes. If your competitors are active on Reddit or have communities discussing their products, you can monitor those subreddits and track which content is gaining traction fastest.

**Can I connect this to Zapier, Make, or other tools?**
Yes — all Apify actors integrate natively with Zapier, Make (formerly Integromat), Google Sheets, and hundreds of other tools via Apify's built-in integrations.

**Can I schedule it to run automatically?**
Yes. Use Apify's built-in scheduler to run on any interval. Combined with monitor mode, this gives you a fully automated Reddit trend tracking pipeline.

**What subreddits work best?**
Any public subreddit works. The most popular use cases involve news subreddits (r/worldnews, r/news), tech communities (r/technology, r/programming), finance (r/wallstreetbets, r/CryptoCurrency), entertainment, gaming, and niche interest communities relevant to specific industries.

**Does it work with NSFW subreddits?**
Public NSFW subreddits are supported the same as any other subreddit.

**How many subreddits can I scan in one run?**
There's no hard limit. The more subreddits you add, the longer the run takes. For large-scale monitoring of dozens of subreddits, increase `postsPerSource` and `maxResults` to match your coverage needs.

***

### Use Case Examples

**Trending topic research across tech subreddits:**
Scan r/technology, r/programming, r/MachineLearning, r/artificial, r/webdev simultaneously. Get the top 50 most trending posts ranked by momentum. Use titles as content ideas or SEO topics.

**Viral news monitoring:**
Scan r/worldnews, r/news, r/politics, r/europe on a 2-hour schedule. Catch breaking stories and trending narratives the moment they start gaining traction, before they hit mainstream media.

**Finance & crypto sentiment tracking:**
Scan r/wallstreetbets, r/CryptoCurrency, r/Bitcoin, r/ethereum, r/stocks with monitor mode enabled. The `scoreDelta` field shows which tickers and topics are accelerating fastest between runs.

**Content calendar planning:**
Scan your niche subreddits weekly. The top trending posts are your audience telling you exactly what they want to read, watch, or hear about. Build your content calendar around real demand signals instead of guesses.

**Competitor & brand monitoring:**
Scan subreddits where your brand, product, or competitors are discussed. Rising posts about competitors are early warnings. Trending discussions about problems your product solves are leads.

***

*Built for marketers, analysts, creators, and researchers who need reliable, automated Reddit trend data at scale.*

# Actor input Schema

## `subreddits` (type: `array`):

Which subreddits to scan for trending content. Add one per line. Accepts any format — bare name (gaming), prefixed (r/gaming), or full URL (https://reddit.com/r/gaming). Duplicates are ignored automatically.

## `fetchHot` (type: `boolean`):

Include posts that are currently getting high engagement. Good for capturing what's already trending right now.

## `fetchRising` (type: `boolean`):

Include posts that are gaining momentum unusually fast. This is the strongest signal for catching trends before they peak — recommended to keep on.

## `fetchNew` (type: `boolean`):

Include recently posted content. Posts here that are already gaining early traction get surfaced as emerging trends.

## `postType` (type: `string`):

Filter which types of posts to include in results.

• All posts — everything, mixed together
• Links only — posts that point to an external article, image, or video
• Text/self posts only — discussions and write-ups posted directly to the subreddit

To get both types but in separate output datasets, choose 'All posts' and enable 'Separate Datasets' below.

## `separateDatasets` (type: `boolean`):

Only takes effect when Post Type is set to 'All posts'. When enabled, link posts and text/self posts are saved to two separate named datasets ('link-posts' and 'text-posts') instead of being mixed into one. Useful if you're piping the output into different workflows.

## `postsPerFeed` (type: `integer`):

How many posts to collect per content source per subreddit. Higher values give broader coverage and surface more potential trends, but take longer to run. Maximum is 100.

## `maxResults` (type: `integer`):

How many posts to include in the final output, ranked by trend score. All collected posts are scored first, then only the top N are saved. Increase this if you're scanning many subreddits and want more coverage.

## `minScore` (type: `integer`):

Filters out posts with fewer upvotes than this threshold. Useful for cutting out brand-new posts with no traction yet that would otherwise add noise to results. Set to 0 to include everything.

## `trackChanges` (type: `boolean`):

Turns on monitor mode. Each run records a snapshot of post scores, and subsequent runs include a 'scoreDelta' field showing how much each post has grown since the last snapshot.

Designed for use with Apify's scheduled runs (e.g. every 6 hours). The first run establishes the baseline — scoreDelta will be null. From the second run onward, deltas are populated.

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

Proxy settings for routing requests. Residential proxies are strongly recommended for reliable results. Defaults to Apify's residential proxy pool.

## Actor input object example

```json
{
  "subreddits": [
    "programming",
    "technology",
    "worldnews"
  ],
  "fetchHot": true,
  "fetchRising": true,
  "fetchNew": true,
  "postType": "all",
  "separateDatasets": false,
  "postsPerFeed": 25,
  "maxResults": 50,
  "minScore": 5,
  "trackChanges": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `trendingPosts` (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 = {
    "subreddits": [
        "programming",
        "technology",
        "worldnews"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("deepmine/subreddit-trend-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 = { "subreddits": [
        "programming",
        "technology",
        "worldnews",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("deepmine/subreddit-trend-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 '{
  "subreddits": [
    "programming",
    "technology",
    "worldnews"
  ]
}' |
apify call deepmine/subreddit-trend-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepmine/subreddit-trend-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/vA4gf92kM0CJ9Su7T/builds/vZJmpMHz9EjWGVAu5/openapi.json