# Reddit Keyword Monitor — Mentions & Alerts (`signalengine/reddit-keyword-monitor`) Actor Watch subreddits (or all of Reddit) for your keywords on a schedule, surface only NEW matches since the last run, and push them to Slack or a webhook. - **URL**: https://apify.com/signalengine/reddit-keyword-monitor.md - **Developed by:** [James Taylor](https://apify.com/signalengine) (community) - **Categories:** Lead generation, Social media, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 matches 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Keyword Monitor — Mentions & Alerts Track Reddit for the keywords that matter to you — your **brand**, a **competitor**, or a **buying-intent phrase** like *"speed to lead"* — and get only the **new** posts since your last run, pushed straight to **Slack** or a webhook. Built for founders, marketers, community and sales teams who want to **catch conversations as they happen** without refreshing Reddit all day. ### Why this monitor - **Only-new by design.** It remembers what it has already seen, so a scheduled run never re-alerts you on the same post. Point it at a schedule and treat it like an inbox. - **Slack-ready.** Drop in a Slack Incoming Webhook URL and new matches arrive as a tidy message. Any other webhook works too (Make/Zapier/n8n/your backend). - **No login, no API key, no proxy.** It reads Reddit's public search RSS. ### What it does - Searches one or more **queries** across **all of Reddit** or a list of **subreddits**. - Keeps only matches that are **new since the last run** (toggle off to get everything). - Saves matches to a dataset **and** optionally POSTs the new ones to your webhook/Slack. ### Input | Field | Type | Default | Description | |---|---|---|---| | `queries` | array | `["speed to lead"]` | Search terms (Reddit search operators work). | | `subreddits` | array | `[]` | Limit to these subreddits; empty = all of Reddit. | | `sort` | string | `new` | `new`, `relevance`, `top`, `comments`, or `hot`. | | `onlyNew` | boolean | `true` | Return only posts not seen on previous runs. | | `webhookUrl` | string | — | New matches are POSTed here; Slack URLs are auto-formatted. | | `limitPerQuery` | integer | `25` | Results checked per query/subreddit (1–100). | | `maxNewPerRun` | integer | `100` | Stop after this many new matches (caps spend). | | `maxConcurrency` | integer | `4` | Parallel search requests. | #### Example input ```json { "queries": ["speed to lead", "lead response time", "CRM recommendations"], "subreddits": ["sales", "SaaS", "marketing"], "sort": "new", "onlyNew": true, "webhookUrl": "https://hooks.slack.com/services/T000/B000/XXXX", "maxNewPerRun": 50 } ```` ### How to run (as a monitor) 1. Enter your **queries** (and optionally narrow to **subreddits**). 2. Paste a **Slack Incoming Webhook** (or any webhook) into `webhookUrl` — optional but recommended. 3. Keep **onlyNew** on. 4. Open **Schedules** in Apify and run it every 15–60 minutes. Each run posts only what's new. The first run seeds the "seen" memory (you'll get current matches); subsequent runs deliver only fresh posts. ### Output Each dataset item: ```json { "type": "match", "matchedQuery": "CRM recommendations", "scope": "r/SaaS", "subreddit": "SaaS", "author": "founder_jane", "title": "Mailchimp alternatives?", "postUrl": "https://www.reddit.com/r/SaaS/comments/abc123/mailchimp_alternatives", "createdAt": "2026-06-02T18:22:00.000Z" } ``` If a `webhookUrl` is set, the new matches are also POSTed (Slack URLs get a formatted message; other URLs receive `{ "source": "reddit-keyword-monitor", "newCount": N, "matches": [...] }`). ### Pricing Apify Pay-Per-Event — you're charged per **new match** returned. Set `maxNewPerRun` to cap spend. Already-seen posts are free (they're filtered before any charge). ### Limitations - **Search matches Reddit's index**, not a full-text scan of every comment; phrase quality matters. - **RSS depth.** Each query returns up to ~100 recent results — fine for monitoring, not a full historical export. - **No engagement metrics** (RSS doesn't expose them; we never fake data). ### Compliance Reads **public Reddit search RSS** only, identifies itself, and never logs in, posts, votes, or messages. Use the output in line with Reddit's terms and any rules that apply to your outreach. ### FAQ **How does "only new" work across runs?** The actor stores the IDs it has seen in its key-value store and skips them next time — so a schedule behaves like an alert feed. **Does it work with Slack?** Yes — paste a Slack Incoming Webhook URL and matches arrive as a message. Any other webhook receives JSON. **No account or proxy needed?** Correct — public RSS, plain requests. *** #### Want replies handled for you? This monitor finds the conversations. If you want **AI-drafted, on-brand replies and DMs** plus full outreach and follow-up, that's what we build at **[SignalEngine](https://engine.signalsprint.io)** — this actor is a taste of the engine behind it. # Actor input Schema ## `queries` (type: `array`): Search terms to monitor, e.g. your brand name, a competitor, or "speed to lead". Reddit search operators work. ## `subreddits` (type: `array`): Limit the search to these subreddits (with or without r/). Leave empty to search all of Reddit. ## `sort` (type: `string`): How to sort search results. ## `onlyNew` (type: `boolean`): Remember posts seen on previous runs and return only new matches. Ideal for scheduled monitoring. ## `webhookUrl` (type: `string`): If set, new matches are POSTed here as JSON. A Slack Incoming Webhook URL is auto-formatted as a Slack message. ## `limitPerQuery` (type: `integer`): How many recent results to check per query/subreddit (1-100). ## `maxNewPerRun` (type: `integer`): Stop after this many new matches (caps your spend). ## `maxConcurrency` (type: `integer`): Parallel search requests. Kept low by default to stay polite. ## Actor input object example ```json { "queries": [ "speed to lead", "lead response time" ], "subreddits": [], "sort": "new", "onlyNew": true, "limitPerQuery": 25, "maxNewPerRun": 100, "maxConcurrency": 4 } ``` # Actor output Schema ## `matches` (type: `string`): Posts matching your keywords that are new since the last run. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "speed to lead", "lead response time" ] }; // Run the Actor and wait for it to finish const run = await client.actor("signalengine/reddit-keyword-monitor").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": [ "speed to lead", "lead response time", ] } # Run the Actor and wait for it to finish run = client.actor("signalengine/reddit-keyword-monitor").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 '{ "queries": [ "speed to lead", "lead response time" ] }' | apify call signalengine/reddit-keyword-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=signalengine/reddit-keyword-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit Keyword Monitor — Mentions & Alerts", "description": "Watch subreddits (or all of Reddit) for your keywords on a schedule, surface only NEW matches since the last run, and push them to Slack or a webhook.", "version": "0.1", "x-build-id": "EJlXzlQVQVyU4kqaE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalengine~reddit-keyword-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalengine-reddit-keyword-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/signalengine~reddit-keyword-monitor/runs": { "post": { "operationId": "runs-sync-signalengine-reddit-keyword-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/signalengine~reddit-keyword-monitor/run-sync": { "post": { "operationId": "run-sync-signalengine-reddit-keyword-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries" ], "properties": { "queries": { "title": "Keywords / search queries", "type": "array", "description": "Search terms to monitor, e.g. your brand name, a competitor, or \"speed to lead\". Reddit search operators work.", "default": [ "speed to lead" ], "items": { "type": "string" } }, "subreddits": { "title": "Subreddits (optional)", "type": "array", "description": "Limit the search to these subreddits (with or without r/). Leave empty to search all of Reddit.", "default": [], "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "new", "relevance", "top", "comments", "hot" ], "type": "string", "description": "How to sort search results.", "default": "new" }, "onlyNew": { "title": "Only new since last run", "type": "boolean", "description": "Remember posts seen on previous runs and return only new matches. Ideal for scheduled monitoring.", "default": true }, "webhookUrl": { "title": "Webhook / Slack URL (optional)", "type": "string", "description": "If set, new matches are POSTed here as JSON. A Slack Incoming Webhook URL is auto-formatted as a Slack message." }, "limitPerQuery": { "title": "Results per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many recent results to check per query/subreddit (1-100).", "default": 25 }, "maxNewPerRun": { "title": "Max new matches per run", "minimum": 1, "type": "integer", "description": "Stop after this many new matches (caps your spend).", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel search requests. Kept low by default to stay polite.", "default": 4 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```