Apify actor · whoareyouanas/reddit-lead-finder
Reddit Lead Finder & Brand Mention Monitor
Find buying-intent posts, search Reddit comments by keyword, and track brand or competitor mentions. Export source-linked records or call the Actor from an AI agent through Apify MCP.
Documentation checked 2026-11-22 · deployed build 1.0.7 · run through your Apify account
01 / Overview
Match the actor to the job.
Search one subreddit or thread
Use a keyword and subreddit for archived results. Use a Reddit permalink to collect a known post and a bounded number of replies.
Screen posts for buying intent
Enable AI analysis and define custom labels such as needs_software. Review the source text before treating a match as a qualified lead.
Monitor mentions on a schedule
Save a task for recurring searches. Send saved posts to Slack or Notion through an authenticated Apify connector, or read all matched rows from the dataset.
02 / Input
Start with a clear, bounded input.
For a scoped keyword search, set searchTerms and withinCommunity. Use postedAfter and commentedAfter for UTC lookbacks, and set per-phrase post and comment caps. Keyword comments use searchComments and maxCommentsCount. Thread replies use crawlCommentsPerPost and maxCommentsPerPost. Reddit-wide keyword search requires a ScrapeAtlas key.
{
"searchTerms": [
"Notion"
],
"withinCommunity": "productivity",
"postedAfter": "14 days",
"commentedAfter": "14 days",
"searchPosts": true,
"searchComments": true,
"crawlCommentsPerPost": false,
"maxPostsCount": 6,
"maxCommentsCount": 6
}Replace example targets and credential placeholders before running. These are documentation examples, not a promise of currently available source results.
| Field | Type / required | Default | Purpose |
|---|---|---|---|
| searchTerms | array | [] | Search one or more buying-intent phrases, products, or brands. Set withinCommunity for subreddit search. Reddit-wide keyword search requires ScrapeAtlas. Post and comment caps apply per phrase. |
| withinCommunity | string | "" | Set this to search a single subreddit through the Arctic Shift archive without a Reddit API key. Use a subreddit name, r/name, or community URL. Leave it empty for Reddit-wide search with ScrapeAtlas. |
| searchPosts | boolean | true | Return posts that match each phrase. |
| searchComments | boolean | true | Search comment bodies for each phrase. Cap these rows with maxCommentsCount. Collecting replies from startUrls or matched posts uses crawlCommentsPerPost and maxCommentsPerPost. |
| postedAfter | string | Not specified | UTC date, timestamp with a timezone, or lookback such as 1 day. |
| commentedAfter | string | Not specified | Lower UTC bound for search comments and replies. |
| maxPostsCount | integer | 50 | Maximum saved posts per search phrase or direct target. Minimum: 0 · Maximum: 50000 |
| maxCommentsCount | integer | 400 | Maximum comments per search phrase or user URL. Minimum: 0 · Maximum: 50000 |
| crawlCommentsPerPost | boolean | true | Add individual comment rows for each saved post. |
All other input controls (36)
| Field | Type / required | Default | Purpose |
|---|---|---|---|
| searchCommunities | boolean | false | Return matching community rows. Keyless discovery matches the start of community names. |
| searchSort | string | "new" | A custom lower date bound forces newest-first for the corresponding result type. Options: new, relevance, hot, top, comments |
| searchTime | string | "all" | A preset lookback for keyword search. An explicit lower date bound takes precedence. Options: all, hour, day, week, month, year |
| postedBefore | string | Not specified | Inclusive UTC date or timestamp. A relative duration excludes newer posts. |
| commentedBefore | string | Not specified | Inclusive upper UTC bound for search comments and replies. |
| onlyWithFlair | boolean | false | Keep posts with a flair. |
| includeNSFW | boolean | false | Allow records flagged as adult content by the source. |
| maxCommentsPerPost | integer | 200 | Maximum comments for each collected thread. Minimum: 0 · Maximum: 50000 |
| maxCommunitiesCount | integer | 2 | Maximum communities from each keyword search. Minimum: 0 · Maximum: 1000 |
| startUrls | array | [] | Provide post, comment, subreddit, user, or Reddit search URLs. |
| subredditUrls | array | [] | Enter subreddit names or home URLs to collect newest posts. |
| aiAnalysis | boolean | false | Add sentiment, intent, emotion, product entities, and relevance. |
| wantsHelp | boolean | false | Seeking a product, service, recommendation, or someone to solve a problem. |
| isOwner | boolean | false | The writer says or clearly shows that they own or operate a business. |
| isVendor | boolean | false | The writer promotes or recruits users for a product or service of their own. |
| hasPain | boolean | false | Describes a concrete problem, frustration, failed tool, or unmet need. |
| mentionsPrice | boolean | false | Mentions a price, subscription, fee, or spending. |
| featureRequest | boolean | false | Requests or wishes for a missing capability. |
| willingToPay | boolean | false | States a budget, requests a quote, or expresses willingness to pay. |
| painPoint | boolean | false | Summarize the specific problem in at most 15 words. Use null if absent. |
| competitor | boolean | false | Name the competing product mentioned. Use null if absent. |
| customLabels | object | {} | Add up to five label names and plain-language classification instructions. |
| aiModel | string | Not specified | Optional model identifier. Use a model that supports structured JSON output. |
| openRouterApiKey | string | Your credential | Optional key. Apify runs can use the Apify OpenRouter integration. |
| scrapeAtlasApiKey | string | Your credential | Enables Reddit-wide post and comment search. Scoped searches and direct URLs can use Arctic Shift without a key. |
| mcpConnector | string | Not specified | Select an authorized Slack, Notion, or compatible delivery connector. |
| mcpTarget | string | Not specified | A channel ID, Notion page ID, or another identifier expected by the tool. |
| mcpMode | string | "perPost" | Send one message per post or one digest. Options: perPost, summary |
| mcpComments | string | "ignore" | Ignore, bundle the highest-scoring replies, or send them separately in per-post mode. Options: ignore, bundle, separate |
| mcpCommentsPerPost | integer | 5 | Maximum highest scoring replies to include per post. Minimum: 1 · Maximum: 50 |
| mcpMaxItems | integer | 50 | Maximum distinct posts included in delivery. Minimum: 1 · Maximum: 1000 |
| mcpMessage | string | "{{title}}\n{{postUrl}}" | Use {{field}} placeholders, including nested fields and array indexes. |
| mcpTool | string | Not specified | Exact MCP tool name. Leave empty for compatible messaging and page creation tools. |
| mcpArguments | object | {} | Optional overrides. String values can use the same placeholders as the message template. |
| mcpServerUrl | string | Not specified | Optional HTTPS Streamable HTTP MCP endpoint for development or custom connectors. |
| mcpServerToken | string | Your credential | Optional bearer token for the configured direct MCP server. |
03 / Output
Know what each returned row represents.
- Rows identify posts and comments with dataType and a Reddit ID. Keep url, createdAt, source, and searchTerm with any lead or mention you share.
- Comment rows can link to their parent post and immediate parent. Check threadComment to tell collected replies from independent keyword matches.
- Read OUTPUT in the default key-value store for counts, source warnings, failures, and delivery status. The Lead qualification view exposes analysisStatus and customLabels when AI is enabled.
{
"dataType": "post",
"id": "t3_example",
"searchTerm": "recommend",
"communityName": "r/smallbusiness",
"title": "Can anyone recommend a tool for recurring invoices?",
"source": "arctic_shift",
"analysisStatus": "analyzed",
"intent": "seeking_recommendation",
"customLabels": {
"needs_software": true
}
}Example values illustrate the published contract. Available fields and populated values depend on the source, mode, and result status.
Fields in the documented output view
dataType
Type
title
Title
body
Body
searchTerm
Search phrase
communityName
Community
authorName
Author
score
Score
createdAt
Created (UTC)
url
Reddit link
profileUrl
Profile
source
Data source
Output views select columns. They do not necessarily filter record types or exhaust the full JSON payload. Use structured JSON when you need nested arrays or objects.
Dataset links and run artifacts (3)
- Dataset
- Structured Reddit records with content, links, timestamps, and retrieval source.
- Lead qualification
- Dataset view with buying-intent labels, sentiment, and analysis status when AI analysis is enabled.
- Run summary
- Row counts, warnings, coverage failures, and optional AI or delivery status.
04 / Pricing
Understand the billable unit.
Apify bills this Actor for platform usage such as compute and storage.
- The Actor uses Apify pay-per-usage billing. Start with one phrase, a short window, and small per-type result caps.
- Optional ScrapeAtlas or OpenRouter usage can add provider charges. Review Apify run usage and provider billing for your configuration.
A result limit and a spending cap are different controls. Account charges, applicable taxes, and separately billed providers or proxies must be considered where relevant. A cap setting is not a minimum invoice charge.
05 / API & automation
Use the same input from your workflow.
Test a small run in Apify Console, inspect its records and charges, then save a task or call the actor from your own application. Keep your Apify token in an environment variable. Source-specific credentials, if required, are separate from the Apify API token.
# Save the input example as input.json and set APIFY_TOKEN.
# This request starts an asynchronous, potentially billable run.
curl --request POST \
'https://api.apify.com/v2/acts/whoareyouanas~reddit-lead-finder/runs' \
--header "Authorization: Bearer $APIFY_TOKEN" \
--header 'Content-Type: application/json' \
--data @input.jsonThe response identifies the run. Wait for it to finish, inspect its status, and use its default dataset and key-value store to retrieve results. A successful run can still contain partial or failed records; check the output contract above before continuing downstream.
Run from an AI agent with Apify MCP
https://mcp.apify.com?tools=whoareyouanas/reddit-lead-finder,storage,runsAuthenticate your MCP client with Apify and call whoareyouanas--reddit-lead-finder with the same JSON input. If the run is still active, use get-actor-run. Read results with get-dataset-items and check the OUTPUT record with get-key-value-store-record.
Coverage & interpretation
Check the result before relying on it.
- Subreddit keyword searches and direct URL collection use Arctic Shift. Ingestion can lag, and archived engagement counts can differ from current Reddit values.
- The AI labels are screening signals. Verify the original discussion and removalStatus, especially when a post looks like a recommendation request but promotes its author's product.
- Keyword comment rows stay in the dataset. Slack and Notion delivery covers saved posts and eligible replies collected from those posts.
Questions
Before you build an integration.
What do I need to provide?
For a scoped keyword search, set searchTerms and withinCommunity. Use postedAfter and commentedAfter for UTC lookbacks, and set per-phrase post and comment caps. Keyword comments use searchComments and maxCommentsCount. Thread replies use crawlCommentsPerPost and maxCommentsPerPost. Reddit-wide keyword search requires a ScrapeAtlas key.
What should I check in the output?
- Rows identify posts and comments with dataType and a Reddit ID. Keep url, createdAt, source, and searchTerm with any lead or mention you share.
- Comment rows can link to their parent post and immediate parent. Check threadComment to tell collected replies from independent keyword matches.
- Read OUTPUT in the default key-value store for counts, source warnings, failures, and delivery status. The Lead qualification view exposes analysisStatus and customLabels when AI is enabled.
How do I budget the run?
- The Actor uses Apify pay-per-usage billing. Start with one phrase, a short window, and small per-type result caps.
- Optional ScrapeAtlas or OpenRouter usage can add provider charges. Review Apify run usage and provider billing for your configuration.
Keep exploring
Practical guides for the next step.
5 Best Apify Actors for Reddit Lead Generation in 2026
Compare five Reddit lead finders and keyword monitors on Apify, including a 10-run benchmark of Harsh Maur’s Reddit Scraper Pro and my Reddit Lead Finder.
Read the guideHow to Scrape Reddit Posts and Comments for Market Research
Use a Reddit scraper to find buyer language, product complaints, content ideas, and community signals from posts, comments, subreddits, and user profiles.
Read the guideExport Reddit Posts and Comments to CSV: Browser or Archive?
Choose a local export for the Reddit page you are reviewing or a dated archive export for historical research, with the right expectations for each.
Read the guide