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.

input.json · example based on the deployed schema
{
  "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.

Deployed actor input fields, types, defaults, and descriptions
FieldType / requiredDefaultPurpose
searchTermsarray[]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.
withinCommunitystring""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.
searchPostsbooleantrueReturn posts that match each phrase.
searchCommentsbooleantrueSearch comment bodies for each phrase. Cap these rows with maxCommentsCount. Collecting replies from startUrls or matched posts uses crawlCommentsPerPost and maxCommentsPerPost.
postedAfterstringNot specifiedUTC date, timestamp with a timezone, or lookback such as 1 day.
commentedAfterstringNot specifiedLower UTC bound for search comments and replies.
maxPostsCountinteger50Maximum saved posts per search phrase or direct target.

Minimum: 0 · Maximum: 50000

maxCommentsCountinteger400Maximum comments per search phrase or user URL.

Minimum: 0 · Maximum: 50000

crawlCommentsPerPostbooleantrueAdd individual comment rows for each saved post.
All other input controls (36)
Deployed actor input fields, types, defaults, and descriptions
FieldType / requiredDefaultPurpose
searchCommunitiesbooleanfalseReturn matching community rows. Keyless discovery matches the start of community names.
searchSortstring"new"A custom lower date bound forces newest-first for the corresponding result type.

Options: new, relevance, hot, top, comments

searchTimestring"all"A preset lookback for keyword search. An explicit lower date bound takes precedence.

Options: all, hour, day, week, month, year

postedBeforestringNot specifiedInclusive UTC date or timestamp. A relative duration excludes newer posts.
commentedBeforestringNot specifiedInclusive upper UTC bound for search comments and replies.
onlyWithFlairbooleanfalseKeep posts with a flair.
includeNSFWbooleanfalseAllow records flagged as adult content by the source.
maxCommentsPerPostinteger200Maximum comments for each collected thread.

Minimum: 0 · Maximum: 50000

maxCommunitiesCountinteger2Maximum communities from each keyword search.

Minimum: 0 · Maximum: 1000

startUrlsarray[]Provide post, comment, subreddit, user, or Reddit search URLs.
subredditUrlsarray[]Enter subreddit names or home URLs to collect newest posts.
aiAnalysisbooleanfalseAdd sentiment, intent, emotion, product entities, and relevance.
wantsHelpbooleanfalseSeeking a product, service, recommendation, or someone to solve a problem.
isOwnerbooleanfalseThe writer says or clearly shows that they own or operate a business.
isVendorbooleanfalseThe writer promotes or recruits users for a product or service of their own.
hasPainbooleanfalseDescribes a concrete problem, frustration, failed tool, or unmet need.
mentionsPricebooleanfalseMentions a price, subscription, fee, or spending.
featureRequestbooleanfalseRequests or wishes for a missing capability.
willingToPaybooleanfalseStates a budget, requests a quote, or expresses willingness to pay.
painPointbooleanfalseSummarize the specific problem in at most 15 words. Use null if absent.
competitorbooleanfalseName the competing product mentioned. Use null if absent.
customLabelsobject{}Add up to five label names and plain-language classification instructions.
aiModelstringNot specifiedOptional model identifier. Use a model that supports structured JSON output.
openRouterApiKeystringYour credentialOptional key. Apify runs can use the Apify OpenRouter integration.
scrapeAtlasApiKeystringYour credentialEnables Reddit-wide post and comment search. Scoped searches and direct URLs can use Arctic Shift without a key.
mcpConnectorstringNot specifiedSelect an authorized Slack, Notion, or compatible delivery connector.
mcpTargetstringNot specifiedA channel ID, Notion page ID, or another identifier expected by the tool.
mcpModestring"perPost"Send one message per post or one digest.

Options: perPost, summary

mcpCommentsstring"ignore"Ignore, bundle the highest-scoring replies, or send them separately in per-post mode.

Options: ignore, bundle, separate

mcpCommentsPerPostinteger5Maximum highest scoring replies to include per post.

Minimum: 1 · Maximum: 50

mcpMaxItemsinteger50Maximum distinct posts included in delivery.

Minimum: 1 · Maximum: 1000

mcpMessagestring"{{title}}\n{{postUrl}}"Use {{field}} placeholders, including nested fields and array indexes.
mcpToolstringNot specifiedExact MCP tool name. Leave empty for compatible messaging and page creation tools.
mcpArgumentsobject{}Optional overrides. String values can use the same placeholders as the message template.
mcpServerUrlstringNot specifiedOptional HTTPS Streamable HTTP MCP endpoint for development or custom connectors.
mcpServerTokenstringYour credentialOptional bearer token for the configured direct MCP server.

03 / Output

Know what each returned row represents.

Illustrative output shape · not a live run
{
  "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.

cURL · start an asynchronous actor run
# 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.json

The 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

MCP server URL
https://mcp.apify.com?tools=whoareyouanas/reddit-lead-finder,storage,runs

Authenticate 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.

Apify MCP setup

Coverage & interpretation

Check the result before relying on it.

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.