# Reddit Viral Content Tracker (`sentry/reddit-viral-content-tracker`) Actor

Find what's going viral across all of Reddit right now. Pulls hot, rising, and new feeds from r/all — deduplicates, ranks by viral score, and flags posts confirmed exploding across multiple feeds. No configuration needed. Just run it.

- **URL**: https://apify.com/sentry/reddit-viral-content-tracker.md
- **Developed by:** [Sentry](https://apify.com/sentry) (community)
- **Categories:** Social media, News, SEO tools
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## 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/platform/actors/running/actors-in-store#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

## Reddit Viral Content Tracker — Find What's Going Viral Right Now

**No configuration needed. Just run it and get the top trending posts across all of Reddit, ranked by viral score.**

Pulls Reddit's hot, rising, and new feeds from r/all, deduplicates across feeds, and ranks every post by a viral score that weights engagement against age. Posts appearing in multiple feeds are flagged — if something is both hot and rising, it's confirmed exploding.

***

### What It Does

Reddit's r/all is a real-time pulse of the entire internet. This actor fetches the feeds you choose (hot, rising, new), deduplicates posts that appear in multiple feeds, and returns a clean ranked list ordered by viral score. Run it once to see what's blowing up right now. Schedule it to track what goes viral over time.

***

### How Viral Score Works

`viralScore = (upvotes + comments × 2) / age^0.8`

Engagement (upvotes + weighted comments) divided by post age. Younger posts with high engagement score higher than old posts with the same engagement — because going viral fast matters more than having accumulated votes over days.

**sortSources field:** A post that appears in both the hot and rising feeds is doubly confirmed viral. The `sortSources` array shows which feeds each post came from — `["hot", "rising"]` means it's trending on both.

***

### Output

| Field | Description |
|---|---|
| `rank` | Position in the viral ranking |
| `title` | Post title |
| `subreddit` | Which subreddit it's from |
| `score` | Reddit upvote score |
| `upvoteRatio` | Ratio of upvotes to total votes |
| `numComments` | Number of comments |
| `viralScore` | Computed viral score (engagement / age) |
| `sortSources` | Which feeds it appeared in: `hot`, `rising`, `new` |
| `flair` | Post flair tag (if set) |
| `postUrl` | Direct link to the post |
| `author` | Reddit username |
| `createdAt` | When it was posted |

***

### Getting Started

1. Run with defaults — hot + rising feeds, top 100 results
2. Optionally exclude subreddits you don't care about (r/politics, r/worldnews, etc.)
3. Schedule hourly or daily to track viral trends over time

***

### Use Cases

**Content creators**
Find what formats, topics, and angles are resonating across Reddit right now. If a post type is going viral, replicate it on your platform.

**Social media managers**
Monitor what's trending before it hits Twitter or TikTok. Reddit often breaks trends 12-24 hours before other platforms.

**News aggregators**
Pull the rising feed to catch stories gaining traction before they peak. Use the hot feed for confirmed breakout stories.

**Meme and trend tracking**
Filter to entertainment subreddits (or exclude news/politics) to track pure meme virality. The `flair` field helps categorize content types.

**Scheduled monitoring**
Run hourly and compare rankings over time to see which posts sustain momentum vs. which spike and die.

***

### Input Parameters

| Parameter | Default | Description |
|---|---|---|
| `sortTypes` | `["hot", "rising"]` | Which r/all feeds to fetch: hot, rising, new |
| `maxResults` | `100` | Max posts in final ranked output |
| `minScore` | `0` | Minimum upvote score filter |
| `excludedSubreddits` | `[]` | Subreddits to exclude from results |
| `proxyConfiguration` | Residential | Proxy settings |

***

### Related Actors

- **[Subreddit Trend Finder](https://apify.com/your-username/reddit-trend-finder)** — trending topics within a specific subreddit, not all of Reddit
- **[Reddit Mentions Scraper](https://apify.com/your-username/reddit-mentions-scraper)** — track specific keywords across Reddit instead of r/all
- **[Reddit Brand Monitor](https://apify.com/your-username/reddit-brand-monitor)** — scheduled monitoring with delta tracking between runs

***

*Built for content creators, social media managers, news aggregators, and trend chasers who need to know what's exploding on Reddit before everyone else does.*

# Actor input Schema

## `sortTypes` (type: `array`):

Which r/all feeds to fetch. Hot = currently trending. Rising = gaining momentum fast. New = most recent posts.

Posts appearing in multiple feeds are flagged — a post in both Hot and Rising is confirmed exploding.

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

Maximum number of posts to return in the final ranked output. Each feed returns up to 100 posts before deduplication.

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

Exclude posts with fewer upvotes than this. Set to 0 to include everything including brand-new rising posts.

## `excludedSubreddits` (type: `array`):

Subreddits to exclude from results. Useful for filtering out politics, news, or other communities you don't want. Accepts any format: memes, r/memes, or full URL.

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

Proxy settings for routing requests. Residential proxies are strongly recommended for reliable results.

## Actor input object example

```json
{
  "sortTypes": [
    "hot",
    "rising"
  ],
  "maxResults": 100,
  "minScore": 0,
  "excludedSubreddits": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("sentry/reddit-viral-content-tracker").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("sentry/reddit-viral-content-tracker").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call sentry/reddit-viral-content-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sentry/reddit-viral-content-tracker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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