# Reddit Lead Generation (`evenleads/reddit-lead-generation`) Actor Extract high-intent leads from Reddit with AI scoring. Browse subreddits, search keywords, and get qualified leads with engagement metrics. No coding required. - **URL**: https://apify.com/evenleads/reddit-lead-generation.md - **Developed by:** [EvenLeads](https://apify.com/evenleads) (community) - **Categories:** Lead generation, Other, Social media - **Stats:** 21 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Lead Generation Scraper ### Find 1,000 High-Intent Reddit Leads in Under 5 Minutes Reddit users openly share their problems, ask for recommendations, and signal buying intent — every single day. This scraper turns those conversations into a qualified lead pipeline, delivered as structured data you can plug into your CRM, outreach tool, or spreadsheet. **No coding. No Reddit account. No rate limits.** Just enter your target subreddits or keywords, hit Start, and get a clean dataset of leads with engagement metrics, direct links, and optional AI relevance scoring. --- ### Who Is This For? **SaaS Founders & Product Teams** — Find users complaining about competitors, asking for tool recommendations, or describing the exact pain point your product solves. Monitor r/SaaS, r/startups, r/Entrepreneur for real-time market signals. **Agencies & Freelancers** — Discover businesses and founders actively looking for help. Filter for posts like "looking for a developer," "need a marketing agency," or "who can build this for me?" **Recruiters & HR Teams** — Surface candidates posting in career subreddits, sharing portfolio work, or announcing they're open to new opportunities. **Content Marketers & SEO Teams** — Extract trending topics, recurring questions, and content gaps from any niche subreddit. Build data-driven content calendars from real conversations. **Market Researchers** — Track sentiment, emerging trends, and competitive mentions across thousands of subreddit communities at scale. --- ### How It Works #### Step 1: Target Your Audience Enter subreddit names (e.g. `startups`, `webdev`, `smallbusiness`) or search keywords (e.g. `"looking for a developer"`, `"need help with"`, `"recommend a tool"`). #### Step 2: Set Your Filters Choose sort order, time range, and minimum engagement thresholds. Only collect posts that matter — skip low-quality noise. #### Step 3: (Optional) Enable AI Lead Scoring Describe your ideal lead in plain English: > *"I want posts from startup founders asking for technical advice about scaling, or anyone looking to hire a developer or contractor."* The AI scores every post 0–100 on relevance and drops anything below 50. No API key needed — it works out of the box. Bring your own Groq key for higher rate limits. #### Step 4: Export & Take Action Download your results as JSON, CSV, or Excel. Plug into your CRM via Apify integrations (Zapier, Make, Google Sheets, webhooks). Each lead includes a direct Reddit permalink so you can engage immediately. --- ### What You Get (Per Lead) | Field | What It Tells You | | -------------------- | ------------------------------------------------------------------ | | `title` | The post headline — your conversation opener | | `author` | Reddit username — your lead | | `subreddit` | Where they posted — tells you their community | | `score` | Upvotes — how much the community agrees | | `numComments` | Engagement level — hot conversations = high intent | | `permalink` | Direct link to the post — click and engage | | `flair` | Post category — quick qualification signal | | `createdAt` | When they posted — freshness matters for outreach | | `aiRelevanceScore` | AI confidence score 0–100 (with AI filtering enabled) | | `aiFilterReason` | AI's explanation of why this lead matches your criteria | | `id` | Reddit's unique post ID | | `source` | How it was found: `browse` or `search` | | `searchQuery` | Which keyword matched (for search results) | | `url` | External link shared in the post | | `domain` | Link domain (e.g. `github.com`, `self.startups`) | | `isSelfPost` | Text post vs. link post | | `isNSFW` | NSFW flag | | `scrapedAt` | Extraction timestamp | --- ### Example: Find SaaS Founders Looking for Help ```json { "subreddits": ["SaaS", "startups", "Entrepreneur", "smallbusiness"], "sort": "new", "timeFilter": "week", "searchQueries": ["looking for a developer", "need help building", "recommend a tool for"], "searchSort": "new", "searchTimeFilter": "month", "maxPosts": 200, "minComments": 3, "enableAiFiltering": true, "aiFilterPrompt": "I want posts where someone is actively looking for a technical co-founder, developer, agency, or SaaS tool to solve a specific business problem. High score for explicit hiring intent or budget mentions." } ```` **Expected output:** 50–200 high-intent leads with AI relevance scores, ready for outreach. *** ### Example: Recruitment Lead Gen ```json { "subreddits": ["forhire", "remotejs", "reactjs", "node"], "sort": "new", "timeFilter": "week", "maxPosts": 500, "minScore": 5 } ``` *** ### Example: Competitive Intelligence ```json { "searchQueries": ["alternative to Notion", "switched from Slack", "better than Asana"], "searchSort": "relevance", "searchTimeFilter": "month", "maxPosts": 300, "enableAiFiltering": true, "aiFilterPrompt": "Posts where users describe why they left a competitor product or are actively evaluating alternatives. Prioritize posts with specific complaints or feature requests." } ``` *** ### AI Lead Filtering — Your Unfair Advantage Most scrapers give you raw data and leave you to sort through hundreds of irrelevant posts manually. The AI Lead Filter does the qualification for you: 1. You describe your ideal lead in plain English 2. Every scraped post is scored 0–100 by AI on how well it matches 3. Only posts scoring 50+ make it to your final dataset 4. Each passing lead includes the AI's reasoning, so you can prioritize **Works out of the box** — no API key needed. We provide a built-in Groq key so you can start filtering immediately. For heavy usage or higher rate limits, bring your own free key from [groq.com](https://groq.com). Powered by `llama-3.1-8b-instant` for fast, cheap inference. *** ### Integrations Export your leads to: - **Google Sheets** — via Apify integration - **Zapier / Make** — trigger workflows on new leads - **Webhooks** — push to any endpoint in real time - **CRM** — HubSpot, Salesforce, Pipedrive via Zapier/Make - **CSV / JSON / Excel** — one-click download from the Apify console *** ### Technical Details - Runs on **Camoufox** (stealth Firefox) — no blocks, no CAPTCHAs - **Residential proxy rotation** with session-pinned IPs — looks like real users - **Automatic pagination** — follows "next page" links until your quota is filled - **NSFW bypass** — accesses age-gated subreddits without manual intervention - **Retry logic** — up to 5 automatic retries with exponential backoff - Targets **old.reddit.com** — stable DOM, fast rendering, reliable selectors - **18 structured fields** per lead (see table above) # Actor input Schema ## `subreddits` (type: `array`): Enter subreddit names without r/ prefix. These are the communities where your leads hang out. Examples: startups, SaaS, webdev, smallbusiness, Entrepreneur, forhire ## `sort` (type: `string`): How to sort subreddit posts. Use 'New' for fresh leads, 'Hot' for trending conversations, 'Top' for highest engagement. ## `timeFilter` (type: `string`): How far back to look. 'Past Week' is ideal for fresh outreach leads. ## `searchQueries` (type: `array`): Search Reddit for specific phrases your leads would use. Tip: use quotes for exact phrases. Examples: "looking for a developer", "need help with", "recommend a tool", "alternative to \[competitor]" ## `searchSort` (type: `string`): Sort search results. 'New' gets the freshest leads. 'Relevance' gets the best keyword matches. ## `searchTimeFilter` (type: `string`): How far back to search. 'Past Month' balances volume and freshness. ## `searchInSubreddits` (type: `boolean`): When ON, searches only within the subreddits listed above instead of all of Reddit. Turn ON for focused lead gen in specific communities. ## `maxPosts` (type: `integer`): Maximum number of leads to extract per subreddit or per search keyword. Higher = more leads but longer run time. ## `minScore` (type: `integer`): Skip posts below this upvote count. Higher upvotes = more community engagement. Set to 0 to collect everything. ## `minComments` (type: `integer`): Skip posts with fewer comments than this. Posts with more comments signal active discussion and higher intent. Set to 0 to collect everything. ## `proxyConfiguration` (type: `object`): Residential proxies recommended for best results. The scraper rotates IPs automatically. ## `enableAiFiltering` (type: `boolean`): Turn ON to have AI score every lead on relevance to your criteria. Only leads scoring 50+ are kept. Works out of the box — no API key needed (we provide one). Bring your own Groq key for higher limits. ## `aiFilterPrompt` (type: `string`): Tell the AI what you're looking for in plain English. Be specific about the type of person, problem, or intent you want to find. ## `groqApiKey` (type: `string`): Optional. Leave empty to use our built-in API key. For higher rate limits or heavy usage, get your own free key at groq.com/keys. ## Actor input object example ```json { "subreddits": [ "startups", "SaaS", "Entrepreneur" ], "sort": "new", "timeFilter": "week", "searchQueries": [ "looking for a developer", "need help building" ], "searchSort": "new", "searchTimeFilter": "month", "searchInSubreddits": false, "maxPosts": 200, "minScore": 0, "minComments": 0, "enableAiFiltering": false, "aiFilterPrompt": "I want posts where someone is actively looking for a developer, agency, or SaaS tool to solve a business problem. Prioritize posts with hiring intent or budget mentions." } ``` # Actor output Schema ## `leads` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "subreddits": [ "startups", "SaaS", "Entrepreneur" ], "searchQueries": [ "looking for a developer", "need help building" ], "maxPosts": 200, "aiFilterPrompt": "I want posts where someone is actively looking for a developer, agency, or SaaS tool to solve a business problem. Prioritize posts with hiring intent or budget mentions." }; // Run the Actor and wait for it to finish const run = await client.actor("evenleads/reddit-lead-generation").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 = { "subreddits": [ "startups", "SaaS", "Entrepreneur", ], "searchQueries": [ "looking for a developer", "need help building", ], "maxPosts": 200, "aiFilterPrompt": "I want posts where someone is actively looking for a developer, agency, or SaaS tool to solve a business problem. Prioritize posts with hiring intent or budget mentions.", } # Run the Actor and wait for it to finish run = client.actor("evenleads/reddit-lead-generation").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 '{ "subreddits": [ "startups", "SaaS", "Entrepreneur" ], "searchQueries": [ "looking for a developer", "need help building" ], "maxPosts": 200, "aiFilterPrompt": "I want posts where someone is actively looking for a developer, agency, or SaaS tool to solve a business problem. Prioritize posts with hiring intent or budget mentions." }' | apify call evenleads/reddit-lead-generation --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=evenleads/reddit-lead-generation", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit Lead Generation", "description": "Extract high-intent leads from Reddit with AI scoring. Browse subreddits, search keywords, and get qualified leads with engagement metrics. No coding required.", "version": "0.3", "x-build-id": "bQ7ZZhYtraV4X77nO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/evenleads~reddit-lead-generation/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-evenleads-reddit-lead-generation", "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/evenleads~reddit-lead-generation/runs": { "post": { "operationId": "runs-sync-evenleads-reddit-lead-generation", "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/evenleads~reddit-lead-generation/run-sync": { "post": { "operationId": "run-sync-evenleads-reddit-lead-generation", "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", "properties": { "subreddits": { "title": "Target Subreddits", "type": "array", "description": "Enter subreddit names without r/ prefix. These are the communities where your leads hang out. Examples: startups, SaaS, webdev, smallbusiness, Entrepreneur, forhire", "items": { "type": "string" } }, "sort": { "title": "Sort Posts By", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "How to sort subreddit posts. Use 'New' for fresh leads, 'Hot' for trending conversations, 'Top' for highest engagement.", "default": "new" }, "timeFilter": { "title": "Time Range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "How far back to look. 'Past Week' is ideal for fresh outreach leads.", "default": "week" }, "searchQueries": { "title": "Search Keywords", "type": "array", "description": "Search Reddit for specific phrases your leads would use. Tip: use quotes for exact phrases. Examples: \"looking for a developer\", \"need help with\", \"recommend a tool\", \"alternative to [competitor]\"", "items": { "type": "string" } }, "searchSort": { "title": "Search Sort", "enum": [ "relevance", "new", "hot", "top", "comments" ], "type": "string", "description": "Sort search results. 'New' gets the freshest leads. 'Relevance' gets the best keyword matches.", "default": "new" }, "searchTimeFilter": { "title": "Search Time Range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "How far back to search. 'Past Month' balances volume and freshness.", "default": "month" }, "searchInSubreddits": { "title": "Search Only in Target Subreddits", "type": "boolean", "description": "When ON, searches only within the subreddits listed above instead of all of Reddit. Turn ON for focused lead gen in specific communities.", "default": false }, "maxPosts": { "title": "Max Leads to Collect", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of leads to extract per subreddit or per search keyword. Higher = more leads but longer run time.", "default": 100 }, "minScore": { "title": "Minimum Upvotes", "minimum": 0, "type": "integer", "description": "Skip posts below this upvote count. Higher upvotes = more community engagement. Set to 0 to collect everything.", "default": 0 }, "minComments": { "title": "Minimum Comments", "minimum": 0, "type": "integer", "description": "Skip posts with fewer comments than this. Posts with more comments signal active discussion and higher intent. Set to 0 to collect everything.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxies recommended for best results. The scraper rotates IPs automatically." }, "enableAiFiltering": { "title": "Enable AI Lead Scoring", "type": "boolean", "description": "Turn ON to have AI score every lead on relevance to your criteria. Only leads scoring 50+ are kept. Works out of the box — no API key needed (we provide one). Bring your own Groq key for higher limits.", "default": false }, "aiFilterPrompt": { "title": "Describe Your Ideal Lead", "type": "string", "description": "Tell the AI what you're looking for in plain English. Be specific about the type of person, problem, or intent you want to find." }, "groqApiKey": { "title": "Groq API Key (Optional)", "type": "string", "description": "Optional. Leave empty to use our built-in API key. For higher rate limits or heavy usage, get your own free key at groq.com/keys." } } }, "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 } } } } } } } } } } ```