# Reddit Mentions Scraper (`sentry/reddit-mentions-scraper`) Actor

Search Reddit for any brand, keyword, or competitor across all subreddits. Returns ranked posts and comments with buzz scores, per-keyword summaries, and score delta tracking for ongoing brand monitoring.

- **URL**: https://apify.com/sentry/reddit-mentions-scraper.md
- **Developed by:** [Sentry](https://apify.com/sentry) (community)
- **Categories:** Social media, SEO tools, E-commerce
- **Stats:** 16 total users, 2 monthly users, 100.0% runs succeeded, 0 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/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 Mentions & Brand Monitor — Reddit Keyword Scraper & Social Listening Tool

**Track every Reddit mention of your brand, product, or keywords across all of Reddit — automatically. Search posts and comments, rank results by engagement velocity, and monitor how mentions grow between runs.**

Whether you're doing brand monitoring, competitive intelligence, product research, or lead generation, this actor gives you structured, ranked Reddit mention data for any keyword — in seconds.

***

### What Is Reddit Mentions & Brand Monitor?

Reddit Mentions & Brand Monitor is an Apify Actor that searches Reddit for any keyword, brand name, product, or topic and returns every matching post and comment — ranked by buzz score, tagged by keyword, and optionally monitored over time.

Unlike Reddit's native search, this tool lets you search multiple keywords in a single run, collect both posts and comments, deduplicate cross-keyword results, and track how mention scores change between scheduled runs. Every result is enriched with engagement metrics, subreddit context, and a buzz score that surfaces the most actively discussed mentions — not just the oldest or most upvoted.

**The key difference from generic Reddit scrapers:** this actor is built specifically for monitoring use cases. It outputs both a per-keyword summary (total mentions, top subreddits, average buzz, top post) and the full ranked list of individual mentions — giving you both the "so what" overview and the raw data in one run.

***

### Key Features

- **Multi-keyword search** — monitor multiple brands, products, or topics in a single run, each tracked separately
- **Posts and comments** — search posts only, comments only, or both in the same run
- **Buzz score ranking** — every result scored by engagement velocity (not raw upvotes), so actively discussed new mentions rank above stale old ones
- **Per-keyword summaries** — automatic summary row per keyword: total mentions, top subreddits, average buzz, top post
- **Cross-keyword deduplication** — posts matching multiple keywords appear once, tagged with all matched keywords
- **Subreddit filtering** — restrict search to specific subreddits, or search all of Reddit
- **Time window control** — filter by past hour, day, week, month, year, or all time
- **Sort control** — sort by new, relevance, top score, hot, or most comments
- **Monitor mode** — run on a schedule, track `scoreDelta` between runs to see which mentions are gaining traction
- **Minimum score filter** — suppress low-quality, zero-engagement results
- **Pagination** — collects up to 1,000 results per keyword across multiple pages
- **Flexible input** — accepts subreddit names in any format: `gaming`, `r/gaming`, or full URL

***

### Who Uses This?

#### Brand Managers & PR Teams

Monitor every Reddit mention of your brand in real time. Know when discussions about your company, product, or executives start gaining upvotes. Catch reputation issues before they spread. Track sentiment shifts across r/all. Set up scheduled runs every few hours with monitor mode to surface mentions that are actively gaining traction right now.

#### Marketing Agencies

Track client brand mentions, competitor mentions, and category keywords across Reddit for your entire client portfolio — in one workflow. Filter by subreddit to focus on the communities that matter. Export to Google Sheets, Slack, or CRMs via Apify integrations.

#### Competitive Intelligence Teams

Search competitor brand names and product names. See which subreddits discuss them, which posts are gaining momentum, what criticisms are resonating, and what features users are asking for. Reddit discussions are unfiltered, authentic consumer feedback that doesn't show up in review sites.

#### Product Managers & UX Researchers

Reddit is one of the richest sources of organic user feedback on the internet. Search your product name, your category, or specific pain points to surface real user complaints, feature requests, and use cases you haven't considered. Filter by time to see how sentiment evolves after launches or updates.

#### SEO & Content Marketers

Reddit mentions surface long-tail keyword opportunities, trending topics, and content angles that don't appear in traditional keyword tools. Trending Reddit posts and comments are often the earliest signal of emerging search demand — days before Google Trends picks it up. Use this to find content gap opportunities and build topical authority.

#### Startup Founders & Entrepreneurs

Validate ideas, track early market conversations, and monitor competitor mentions across Reddit communities. Search for discussions about the problem you solve to find prospects, understand messaging, and identify gaps in the market.

#### Journalists & Media Researchers

Track how specific topics, events, or people are being discussed across Reddit communities. Monitor keyword velocity to identify breaking narratives. Filter by subreddit to focus on relevant communities — r/worldnews, r/technology, r/politics, niche industry boards.

#### Investors & Market Researchers

Monitor ticker symbols, company names, and sector keywords across financial subreddits like r/wallstreetbets, r/stocks, r/investing, r/CryptoCurrency. Use monitor mode to track how sentiment and engagement around specific assets changes over time.

#### Lead Generation & Sales Teams

Search Reddit for people discussing problems your product solves. Filter by recency (past week or day) to find prospects actively looking for solutions right now. Combine with subreddit targeting to focus on communities most likely to convert.

#### OnlyFans Agencies & Adult Content Creators

Track brand and creator mentions across relevant subreddits. Monitor fan discussions, identify trending niches, and keep tabs on competitor creators — all in a single automated run.

***

### Output — What You Get

Each run outputs two types of records in a single dataset: **summary rows** (one per keyword) followed by **mention rows** (all individual results ranked by buzz score).

#### Summary Rows (one per keyword)

| Field | Description |
|---|---|
| `type` | `"summary"` |
| `keyword` | The keyword this summary covers |
| `totalMentions` | Total results found for this keyword |
| `postCount` | Number of matching posts |
| `commentCount` | Number of matching comments |
| `topSubreddits` | Top 5 subreddits by mention volume, e.g. `r/technology (12)` |
| `avgBuzzScore` | Average buzz score across all mentions |
| `maxBuzzScore` | Highest single buzz score for this keyword |
| `avgScore` | Average upvote score |
| `topPostTitle` | Title of the highest-buzz mention |
| `topPostUrl` | Link to the highest-buzz mention |
| `topPostSubreddit` | Subreddit of the top mention |
| `topPostScore` | Upvote count of the top mention |
| `topPostBuzzScore` | Buzz score of the top mention |

#### Mention Rows (posts and comments)

| Field | Description |
|---|---|
| `rank` | Global rank across all keywords (1 = highest buzz) |
| `type` | `"post"` or `"comment"` |
| `matchedKeywords` | Array of keywords this result matched |
| `buzzScore` | Engagement velocity score — higher = more actively gaining traction |
| `title` | Post title (posts only) |
| `body` | Comment text (comments only) |
| `postTitle` | Parent post title (comments only) |
| `postUrl` | Link to the Reddit post |
| `commentUrl` | Direct link to the comment (comments only) |
| `externalUrl` | Linked URL if a link post |
| `subreddit` | Subreddit name |
| `author` | Reddit username |
| `score` | Upvote count |
| `upvoteRatio` | Ratio of upvotes to total votes (posts only) |
| `numComments` | Total comment count (posts only) |
| `postAgeHours` | How old the post or comment is |
| `createdAt` | ISO 8601 timestamp |
| `flair` | Post flair/tag (posts only) |
| `domain` | Domain of linked content (posts only) |
| `isVideo` | Whether the post is a video (posts only) |
| `isSelf` | Whether this is a text post (posts only) |
| `thumbnail` | Thumbnail image URL (posts only) |
| `scoreDelta` | Score change since last run (monitor mode only) |

The Apify Console output tab has two views: **Summary** (one row per keyword) and **Mentions** (full ranked list). Use the Summary view for a quick overview; switch to Mentions to drill into individual results.

***

### Getting Started

1. **Enter your keywords** — Add one keyword per line. Can be brand names, product names, topic phrases, competitor names, or any search term. Each keyword is searched independently.

2. **Set your time window** — "Past week" is a good default for regular monitoring. Use "All time" for a historical sweep of a brand or topic.

3. **Choose sort order** — "New" surfaces the most recent mentions first, best for catching fast-breaking discussions. "Top" finds the highest-engagement mentions. "Relevance" uses Reddit's own ranking.

4. **Configure optional filters** — Restrict to specific subreddits if needed, toggle comment search on or off, set a minimum upvote threshold.

5. **Run** — Results appear in the Output tab, sorted by buzz score. The Summary view shows totals and top results per keyword. The Mentions view shows every result ranked globally.

***

### Input Parameters

| Parameter | Default | Description |
|---|---|---|
| `keywords` | — | Keywords to search for (required, one or more) |
| `sortBy` | `new` | Sort order: `new`, `relevance`, `top`, `hot`, `comments` |
| `timeFilter` | `week` | Time window: `hour`, `day`, `week`, `month`, `year`, `all` |
| `searchPosts` | `true` | Search posts |
| `searchComments` | `false` | Also search comments (increases run time) |
| `subredditFilter` | `[]` | Restrict to specific subreddits (empty = all of Reddit) |
| `maxResultsPerKeyword` | `100` | Max results per keyword (up to 1,000) |
| `minScore` | `1` | Minimum upvote score to include |
| `trackChanges` | `false` | Monitor mode: track score delta between runs |
| `proxyConfiguration` | Residential | Proxy settings |

***

### Buzz Score Explained

Every result is scored with a **buzz score** — an engagement velocity metric that measures how actively a post or comment is gaining traction relative to its age.

The formula: `(upvotes + comments × 2) ÷ age^0.8`

Comments count double because they signal active discussion, not passive upvoting. The age exponent dampens the advantage of brand-new posts while still rewarding momentum. A post with 200 upvotes and 80 comments at 3 hours old will score significantly higher than a post with 500 upvotes from 3 days ago — because the first is actively gaining and the second has already peaked.

This gives you a real-time signal for which mentions deserve your attention **right now**, not which ones were popular last week.

***

### Monitor Mode — Track Reddit Mentions Over Time

Enable **Track Score Changes Between Runs** to turn this actor into a full Reddit brand monitoring pipeline.

In monitor mode, each run saves a snapshot of all result scores. On subsequent runs, every result includes a `scoreDelta` field showing exactly how many upvotes (or comment score) it gained since the last snapshot. Combined with buzz score, this tells you which mentions are actively gaining momentum between your monitoring windows.

**Recommended setup:** Schedule this actor to run every 6–12 hours on Apify's scheduler. Each run captures new mentions and updates delta tracking on existing ones. Use the `scoreDelta` field to filter for the mentions growing fastest — those are the discussions that matter.

**First run behavior:** The first run in monitor mode establishes the baseline. `scoreDelta` will be null. From the second run onward, deltas are populated.

***

### Frequently Asked Questions

**Can I monitor multiple brands at once?**
Yes. Add each brand as a separate keyword. Each gets its own summary row in the output with total mention count, top subreddits, and top posts. All mentions are combined and ranked globally in the Mentions view.

**Can I restrict the search to specific subreddits?**
Yes. Add subreddit names to the `subredditFilter` field. Accepts any format: `technology`, `r/technology`, or a full Reddit URL. Leave empty to search all of Reddit.

**Does it search comments?**
By default it searches posts only. Enable "Include Comments" to also search comment text. This significantly increases the number of results but also increases run time.

**How is this different from just searching Reddit?**
Reddit's search doesn't work across multiple keywords simultaneously, doesn't score by velocity, doesn't deduplicate cross-keyword results, can't be scheduled or automated, and doesn't export structured data. This actor gives you programmable, enriched, ranked mention data you can feed into any downstream workflow.

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

**Can I schedule it to run automatically?**
Yes. Use Apify's built-in scheduler to run on any interval. Combined with monitor mode, you get a fully automated Reddit brand monitoring pipeline that tracks score changes between every run.

**What does "buzz score" mean?**
Buzz score is an engagement velocity metric. It measures how actively a mention is gaining upvotes and comments relative to its age. High buzz score = actively gaining traction right now. See the "Buzz Score Explained" section above.

**How many results can I collect per keyword?**
Up to 1,000 results per keyword. Set `maxResultsPerKeyword` to control this. The actor paginates automatically through Reddit's search API to collect up to your limit.

**Does it find mentions in NSFW subreddits?**
Reddit's search API does not return NSFW subreddit content for unauthenticated requests, regardless of parameters. Public SFW subreddits are fully supported.

**Can I use this for lead generation?**
Yes — search for keywords that indicate buying intent or problems your product solves, filtered to the past day or week, sorted by new. The results surface people actively discussing those topics right now.

***

### Use Case Examples

**Brand reputation monitoring:**
Add your brand name, product name, and any common misspellings as keywords. Set time filter to "Past week", sort by "New", enable monitor mode, and schedule every 6 hours. Every run surfaces new mentions ranked by buzz and shows which existing mentions are gaining upvotes — giving you an early warning system for reputation issues.

**Competitive intelligence sweep:**
Add competitor brand names and product names. Set time filter to "Past month", sort by "Top". Get the highest-scoring Reddit discussions about each competitor, ranked by engagement. See which criticisms, features, and use cases are resonating with their users.

**Product research & voice of customer:**
Add your product category and core pain points as keywords. Set time filter to "All time", sort by "Relevance". The results surface Reddit's most relevant discussions about the problem you solve — unfiltered user language you can use for messaging, positioning, and feature prioritization.

**SEO content gap research:**
Add 5–10 topic keywords in your niche. Sort by "Top", time filter "Past year". The highest-scoring posts in your niche are the content angles Reddit's audiences found most valuable — use them as content ideas, title formulas, and long-tail keyword targets.

**Financial sentiment monitoring:**
Add ticker symbols, company names, and sector terms. Restrict to subreddits like r/wallstreetbets, r/stocks, r/investing. Enable monitor mode and schedule hourly. Track `scoreDelta` to see which assets are generating accelerating discussion.

**Lead generation:**
Search for phrases like "looking for \[your category]", "any recommendations for \[problem]", "best \[product type]". Sort by "New", time filter "Past day". The results are people actively asking for what you offer, right now.

***

*Built for brand managers, marketing teams, product researchers, and analysts who need reliable, automated Reddit mention data at scale.*

# Actor input Schema

## `keywords` (type: `array`):

Keywords, brand names, or phrases to search for across Reddit. Add one per line. Each keyword is searched independently — results are deduplicated and tagged with which keyword matched them.

## `sortBy` (type: `string`):

How to rank the search results returned by Reddit.

• New — most recent mentions first. Best for brand monitoring and catching new discussions fast.
• Relevance — Reddit's own relevance ranking. Good for finding the most on-topic results.
• Top — highest-scored posts matching the keyword. Good for finding what resonated most.
• Hot — currently active discussions. Good for catching momentum.
• Most Comments — posts with the most discussion. Good for finding engaged threads.

## `timeFilter` (type: `string`):

Limit results to mentions posted within this time window. 'Past week' is a good default for regular monitoring. Use 'All time' for a full historical sweep of a topic.

## `searchPosts` (type: `boolean`):

Search for posts (links, articles, discussions) that mention your keyword. Covers the vast majority of Reddit content.

## `searchComments` (type: `boolean`):

Also search for individual comments that mention your keyword. Useful for catching mentions in discussion threads. Increases run time — disabled by default.

## `subredditFilter` (type: `array`):

Optionally restrict the search to specific subreddits. Leave empty to search all of Reddit. Accepts any format: gaming, r/gaming, or full URL.

## `maxResultsPerKeyword` (type: `integer`):

Maximum number of results to collect per keyword. Increase for broader coverage on high-volume topics.

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

Filter out results with fewer upvotes than this threshold. Set to 0 to include everything including brand-new posts with no votes yet.

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

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

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

## `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
{
  "keywords": [
    "ChatGPT",
    "Claude AI",
    "OpenAI"
  ],
  "sortBy": "new",
  "timeFilter": "week",
  "searchPosts": true,
  "searchComments": false,
  "subredditFilter": [],
  "maxResultsPerKeyword": 100,
  "minScore": 1,
  "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 = {
    "keywords": [
        "ChatGPT",
        "Claude AI",
        "OpenAI"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sentry/reddit-mentions-scraper").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 = { "keywords": [
        "ChatGPT",
        "Claude AI",
        "OpenAI",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("sentry/reddit-mentions-scraper").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 '{
  "keywords": [
    "ChatGPT",
    "Claude AI",
    "OpenAI"
  ]
}' |
apify call sentry/reddit-mentions-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/C566NsWxjI2KAjA5K/builds/5i2XJlxImA8qNuO5d/openapi.json