# Reddit Mentions Monitor - Brand, Keyword & Lead Alerts (`aolmo/reddit-mentions`) Actor

Find every Reddit post that mentions your brand, product, competitor or keyword, with the text around the mention, subreddit, author, score and comments. Filter by subreddits and excluded words. Schedule it and only new mentions are flagged, for brand monitoring and lead alerts. $0.002 per mention.

- **URL**: https://apify.com/aolmo/reddit-mentions.md
- **Developed by:** [Antonio del Olmo Tena](https://apify.com/aolmo) (community)
- **Categories:** Social media, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 mention founds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

Track every Reddit post that mentions your brand, your product, a competitor or a buying-intent phrase. Give keywords and the Actor returns one row per post that really contains the keyword, with the text around the mention, the subreddit, author, score, comments and date. Filter by subreddits and excluded words. Schedule it daily or hourly and only the new mentions are flagged, so you can send them to Slack, email or your CRM. Brand monitoring, competitor research and Reddit lead generation at $0.002 per mention.

### What you get

**Mention** (one row each): `keyword`, `title`, `snippet` (the text around the mention), `text`, `matchedIn` (title or text), `subreddit`, `author`, `url`, `link`, `domain`, `postType`, `score`, `commentCount`, `createdAt`, `id`, `position`.

**Changes** on scheduled runs: `isNew` is true for mentions published since the previous run.

### How to use it

1. Open the **Input** tab.
2. Add **Keywords**, one per line: your brand, your product, competitors, or phrases such as `looking for a CRM`.
3. Optionally limit to **Subreddits** and add **Exclude words** to drop noise (for example `hiring`).
4. Choose the **Time range** and **Max mentions per keyword**.
5. Click **Start**, then schedule it and connect a webhook or integration to receive new mentions.

### Input

```json
{
  "keywords": ["notion ai", "looking for a crm"],
  "subreddits": ["SaaS", "startups"],
  "excludeKeywords": ["hiring"],
  "time": "week",
  "maxMentions": 50,
  "exactMatch": true
}
```

### Output

```json
{
  "keyword": "notion ai",
  "id": "t3_1xpah03",
  "subreddit": "Solopreneur",
  "title": "Which AI tools actually save you time?",
  "matchedIn": "text",
  "snippet": "…I moved all my notes to Notion AI last month and the summaries are good enough…",
  "author": "kezjah",
  "url": "https://www.reddit.com/r/Solopreneur/comments/1xpah03/...",
  "score": 12,
  "commentCount": 9,
  "createdAt": "2026-11-05T14:12:00.000Z",
  "isNew": true,
  "timestamp": "2026-11-06T10:00:00.000Z"
}
```

Example values are illustrative.

### Pricing

Pay per event: **$0.002 per mention** and **$0.002 per new mention** on a scheduled run. Keywords without mentions are free. 500 mentions cost $1.

### Limits and notes

- With **Exact match only** on, posts are kept only if they contain the keyword as a whole word; Reddit search alone also returns loose matches. Use distinctive keywords: a common word such as `notion` also matches everyday language.
- Posts are covered; comments are not searched.
- Reddit search returns up to about 250 recent posts per keyword and subreddit.

### Related Actors

- **Reddit Scraper**: posts and comments of subreddits, users and searches.
- **Threads Search Scraper**: posts on Threads by keyword.
- **Google News Scraper**: news articles by keyword.

# Actor input Schema

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

One per line: your brand, product or competitor names, or phrases such as "looking for a CRM". Up to 50 per run.

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

Optional: search only these subreddits, such as SaaS or r/marketing.

## `excludeKeywords` (type: `array`):

Skip posts that contain any of these words.

## `time` (type: `string`):

How far back to search.

## `maxMentions` (type: `integer`):

Newest first, up to 250.

## `exactMatch` (type: `boolean`):

Keep only posts that contain the keyword as written. Reddit search also returns loose matches.

## `product` (type: `string`):

Internal. Leave as is.

## Actor input object example

```json
{
  "keywords": [
    "notion ai"
  ],
  "time": "week",
  "maxMentions": 50,
  "exactMatch": true,
  "product": "reddit-mentions"
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset items: url, changed, events, data, timestamp and error (when the target failed).

# 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": [
        "notion ai"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aolmo/reddit-mentions").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": ["notion ai"] }

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

```

## MCP server setup

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

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/C0EceL8r4cYlENudv/builds/SntZ9wyv8450sKDle/openapi.json