# Lead Generation Suite (`venueengine.co/lead-gen-suite`) Actor The COMPLETE Lead Gen Pipeline. Scrape Google Maps -> Find verified emails (7 methods) -> Score leads (0-100) -> Generate personalized call scripts & cold emails. Works standalone or enriches leads from Fast Scraper. Includes webhooks for Zapier/Make. The ultimate tool for SDRs & agencies. - **URL**: https://apify.com/venueengine.co/lead-gen-suite.md - **Developed by:** [Samuel Joel Rencken](https://apify.com/venueengine.co) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 27 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $18.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Lead Generation Suite 🚀 > **All-in-One Lead Generation: Scrape → Enrich → Qualify → Scripts & Emails** From search query to **sales-ready leads with personalized outreach** in one click. --- #### 🤖 Free AI Consultant **Need expert help configuring your campaign?** Chat with our [Lead Gen Architect GPT](https://chatgpt.com/g/g-696a2c0ab5448191a7020beea411dd08-lead-gen-architect). It will interview you about your niche, write your sales scripts, and generate the perfect JSON for this Actor. --- ### 🔗 Works with Fast Scraper (A→B Pipeline) Already scraped leads with our [⚡ Fastest Google Maps Scraper](https://apify.com/venueengine.co/fast-google-maps-scraper)? Use `enrich_from_fast_scraper` mode to unlock the premium data: ```json { "mode": "enrich_from_fast_scraper", "leads": [...output from Fast Scraper...] } ```` This filters leads with `email_found: true` and enriches them with verified emails, decision makers, and scripts. *** ### 🎯 Features | Stage | What It Does | |-------|--------------| | **Scrape** | Search Google Maps for businesses | | **Enrich** | Find emails using 7 discovery methods | | **Qualify** | Score leads 0-100 (customizable weights) | | **Scripts** | Generate gatekeeper bypass call scripts | | **Emails** | Generate tested cold email sequences | *** ### ✨ Full Customization #### Custom Call Scripts Use your own openers with variables: ```json { "customCallScripts": { "openerPrimary": "Hi — who handles {{businessType}} at your location?", "valueHook": "We help {{businessType}} businesses save 10+ hours/week on scheduling." } } ``` #### Custom Email Templates Personalized cold emails: ```json { "customEmailTemplates": { "subject1": "Quick question about {{businessName}}", "body1": "Hi {{firstName}},\n\nI noticed {{businessName}} in {{city}}..." } } ``` #### Custom Scoring Weights Prioritize what matters to YOU: ```json { "scoringWeights": { "hasEmail": 30, "hasPhone": 20, "highRating": 15 } } ``` #### Output Filters Only get the leads you want: ```json { "minScoreThreshold": 50, "outputFilters": { "onlyWithEmail": true, "excludeCategories": ["Golf equipment store"] } } ``` #### Webhook Integration Push leads to Zapier/Make/n8n in real-time: ```json { "webhookUrl": "https://hooks.zapier.com/hooks/catch/...", "webhookBatchSize": 10 } ``` #### Feedback Analytics (Optional) Track run performance for continuous improvement: ```json { "feedbackWebhook": "https://your-analytics-endpoint.com/ingest" } ``` Receives POST with: `success`, `totalLeads`, `emailsFound`, `hotLeads`, `duration`, `errors[]` *** ### 🔧 Available Variables | Variable | Description | Example | |----------|-------------|---------| | `{{businessName}}` | Company name | "Swing Shack" | | `{{city}}` | Location | "Miami, FL" | | `{{businessType}}` | From search query | "golf simulator" | | `{{firstName}}` | Decision maker first name | "John" | | `{{rating}}` | Star rating | "4.9" | *** ### 📥 Input Examples #### Full Pipeline with Customization ```json { "mode": "full_pipeline", "searchQuery": "yoga studio", "locations": ["Austin, TX", "Denver, CO"], "maxResultsPerLocation": 50, "verifyEmails": true, "generateCallScripts": true, "generateEmailTemplates": true, "minScoreThreshold": 50, "customCallScripts": { "valueHook": "We help yoga studios automate class bookings and reduce no-shows by 40%." } } ``` *** ### 📤 Sample Output ```json { "businessName": "Zen Yoga Austin", "email": "hello@zenyoga.com", "phone": "5125551234", "qualification": { "score": 75, "tier": "warm" }, "callScript": { "openerPrimary": "Hi — who handles yoga studio bookings?", "valueHook": "We help yoga studios automate class bookings..." }, "emailTemplates": { "subject1": "Quick question about Zen Yoga Austin", "body1": "Hi there,\n\nI noticed Zen Yoga Austin in Austin..." } } ``` *** ### 🔬 7 Email Discovery Methods 1. **Website Crawl** - Contact pages 2. **Pattern Generation** - info@, hello@, etc. 3. **WHOIS Lookup** - Domain registration 4. **Social Scrape** - Facebook/Instagram 5. **DNS TXT** - DMARC records 6. **DuckDuckGo Dorking** - Search exposed emails 7. **Wayback Machine** - Historical pages *** ### 💰 Pricing | Mode | Price/Lead | |------|------------| | Full Pipeline | ~$0.05 | | Scrape Only | ~$0.01 | | Enrich Only | ~$0.025 | | Qualify Only | ~$0.01 | *** ### 🎯 Perfect For - **SDRs** - Call-ready leads with scripts - **Email Marketers** - Enriched lists with copy - **Agencies** - White-label lead gen - **ANY Niche** - Fully customizable *** ### 📜 License MIT # Actor input Schema ## `mode` (type: `string`): Select which pipeline stage(s) to run ## `searchQuery` (type: `string`): Business type to search for (e.g., 'golf simulator', 'escape room', 'yoga studio') ## `locations` (type: `array`): Cities/regions to search (e.g., 'Miami, FL', 'London, UK') ## `maxResultsPerLocation` (type: `integer`): Maximum leads to scrape per location ## `domains` (type: `array`): Domains to enrich. Only used in enrich\_only mode. ## `leads` (type: `array`): Pre-existing leads to qualify. Only used in qualify\_only mode. ## `enrichmentMethods` (type: `array`): Email discovery methods to use ## `customEmailPrefixes` (type: `array`): Email prefixes to try (e.g., 'info', 'bookings', 'reservations') ## `verifyEmails` (type: `boolean`): SMTP verification of discovered emails ## `findDecisionMaker` (type: `boolean`): Attempt to find owner/manager name from website ## `scoringWeights` (type: `object`): Customize lead scoring weights (0-100 total) ## `minScoreThreshold` (type: `integer`): Only output leads with score >= this value (0 = no filter) ## `generateCallScripts` (type: `boolean`): Create personalized gatekeeper bypass call scripts ## `generateEmailTemplates` (type: `boolean`): Create personalized cold email sequences ## `customCallScripts` (type: `object`): Override default scripts. Use {{businessName}}, {{city}}, {{businessType}}, {{rating}} ## `customEmailTemplates` (type: `object`): Override default email copy. Use {{businessName}}, {{firstName}}, {{city}}, {{businessType}} ## `outputFormat` (type: `string`): How to format the output ## `outputFilters` (type: `object`): Filter which leads are included in output ## `webhookUrl` (type: `string`): Send leads to this URL (Zapier, Make, n8n, etc.) ## `webhookBatchSize` (type: `integer`): How many leads to send per webhook call ## `maxConcurrency` (type: `integer`): How many leads to process in parallel ## `feedbackWebhook` (type: `string`): Receive run metrics and errors for continuous improvement. POST payload includes success/failure, lead counts, and timing. ## Actor input object example ```json { "mode": "full_pipeline", "searchQuery": "golf simulator", "locations": [ "Miami, FL" ], "maxResultsPerLocation": 50, "enrichmentMethods": [ "website", "pattern", "dns", "dork" ], "customEmailPrefixes": [ "info", "hello", "contact", "sales", "support", "bookings", "enquiries" ], "verifyEmails": true, "findDecisionMaker": true, "scoringWeights": { "hasWebsite": 15, "hasEmail": 25, "hasPhone": 10, "noBookingSystem": 20, "highRating": 10, "hasDecisionMaker": 10, "hasReviews": 5 }, "minScoreThreshold": 0, "generateCallScripts": true, "generateEmailTemplates": true, "customCallScripts": { "openerPrimary": "Hi — who's the best person to speak to about {{businessType}}?", "openerCallback": "Hi — I'm following up on a call earlier regarding {{businessName}}.", "icebreaker": "{{businessName}} looks like a great spot in {{city}}!", "valueHook": "We help {{businessType}} businesses automate bookings and fill empty slots.", "close": "Would it make sense to show you how it works? Takes about 10 minutes." }, "customEmailTemplates": { "subject1": "Quick question about {{businessName}}", "subject2": "{{city}} {{businessType}} - booking idea", "body1": "Hi {{firstName}},\n\nI noticed {{businessName}} in {{city}} and wanted to reach out.\n\nWe help {{businessType}} businesses automate bookings and fill empty time slots without changing how you operate.\n\nWould it make sense to show you how it works?\n\nBest,\n[Your Name]", "followUp": "Hi {{firstName}},\n\nJust following up on my last note about {{businessName}}.\n\nHappy to share a quick demo if helpful.\n\nBest,\n[Your Name]" }, "outputFormat": "json", "outputFilters": { "onlyWithEmail": false, "onlyWithPhone": false, "excludeCategories": [] }, "webhookBatchSize": 10, "maxConcurrency": 3 } ``` # 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 = { "mode": "full_pipeline", "searchQuery": "golf simulator", "locations": [ "Miami, FL" ] }; // Run the Actor and wait for it to finish const run = await client.actor("venueengine.co/lead-gen-suite").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 = { "mode": "full_pipeline", "searchQuery": "golf simulator", "locations": ["Miami, FL"], } # Run the Actor and wait for it to finish run = client.actor("venueengine.co/lead-gen-suite").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 '{ "mode": "full_pipeline", "searchQuery": "golf simulator", "locations": [ "Miami, FL" ] }' | apify call venueengine.co/lead-gen-suite --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=venueengine.co/lead-gen-suite", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Lead Generation Suite", "description": "The COMPLETE Lead Gen Pipeline. Scrape Google Maps -> Find verified emails (7 methods) -> Score leads (0-100) -> Generate personalized call scripts & cold emails. Works standalone or enriches leads from Fast Scraper. Includes webhooks for Zapier/Make. The ultimate tool for SDRs & agencies.", "version": "1.0", "x-build-id": "i0NgvxQHRlO6bHUu8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/venueengine.co~lead-gen-suite/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-venueengine.co-lead-gen-suite", "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/venueengine.co~lead-gen-suite/runs": { "post": { "operationId": "runs-sync-venueengine.co-lead-gen-suite", "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/venueengine.co~lead-gen-suite/run-sync": { "post": { "operationId": "run-sync-venueengine.co-lead-gen-suite", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "full_pipeline", "scrape_only", "enrich_only", "enrich_from_fast_scraper", "qualify_only" ], "type": "string", "description": "Select which pipeline stage(s) to run", "default": "full_pipeline" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Business type to search for (e.g., 'golf simulator', 'escape room', 'yoga studio')" }, "locations": { "title": "Locations", "type": "array", "description": "Cities/regions to search (e.g., 'Miami, FL', 'London, UK')", "items": { "type": "string" } }, "maxResultsPerLocation": { "title": "Max Results Per Location", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum leads to scrape per location", "default": 50 }, "domains": { "title": "Domains (enrich_only mode)", "type": "array", "description": "Domains to enrich. Only used in enrich_only mode.", "items": { "type": "string" } }, "leads": { "title": "Leads JSON (qualify_only mode)", "type": "array", "description": "Pre-existing leads to qualify. Only used in qualify_only mode." }, "enrichmentMethods": { "title": "Enrichment Methods", "type": "array", "description": "Email discovery methods to use", "items": { "type": "string", "enum": [ "website", "pattern", "whois", "social", "dns", "dork", "wayback" ] }, "default": [ "website", "pattern", "dns", "dork" ] }, "customEmailPrefixes": { "title": "Custom Email Prefixes", "type": "array", "description": "Email prefixes to try (e.g., 'info', 'bookings', 'reservations')", "default": [ "info", "hello", "contact", "sales", "support", "bookings", "enquiries" ], "items": { "type": "string" } }, "verifyEmails": { "title": "Verify Emails", "type": "boolean", "description": "SMTP verification of discovered emails", "default": true }, "findDecisionMaker": { "title": "Find Decision Maker", "type": "boolean", "description": "Attempt to find owner/manager name from website", "default": true }, "scoringWeights": { "title": "Scoring Weights", "type": "object", "description": "Customize lead scoring weights (0-100 total)", "default": { "hasWebsite": 15, "hasEmail": 25, "hasPhone": 10, "noBookingSystem": 20, "highRating": 10, "hasDecisionMaker": 10, "hasReviews": 5 } }, "minScoreThreshold": { "title": "Minimum Score Threshold", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only output leads with score >= this value (0 = no filter)", "default": 0 }, "generateCallScripts": { "title": "Generate Call Scripts", "type": "boolean", "description": "Create personalized gatekeeper bypass call scripts", "default": true }, "generateEmailTemplates": { "title": "Generate Email Templates", "type": "boolean", "description": "Create personalized cold email sequences", "default": true }, "customCallScripts": { "title": "Custom Call Scripts", "type": "object", "description": "Override default scripts. Use {{businessName}}, {{city}}, {{businessType}}, {{rating}}", "default": { "openerPrimary": "Hi — who's the best person to speak to about {{businessType}}?", "openerCallback": "Hi — I'm following up on a call earlier regarding {{businessName}}.", "icebreaker": "{{businessName}} looks like a great spot in {{city}}!", "valueHook": "We help {{businessType}} businesses automate bookings and fill empty slots.", "close": "Would it make sense to show you how it works? Takes about 10 minutes." } }, "customEmailTemplates": { "title": "Custom Email Templates", "type": "object", "description": "Override default email copy. Use {{businessName}}, {{firstName}}, {{city}}, {{businessType}}", "default": { "subject1": "Quick question about {{businessName}}", "subject2": "{{city}} {{businessType}} - booking idea", "body1": "Hi {{firstName}},\n\nI noticed {{businessName}} in {{city}} and wanted to reach out.\n\nWe help {{businessType}} businesses automate bookings and fill empty time slots without changing how you operate.\n\nWould it make sense to show you how it works?\n\nBest,\n[Your Name]", "followUp": "Hi {{firstName}},\n\nJust following up on my last note about {{businessName}}.\n\nHappy to share a quick demo if helpful.\n\nBest,\n[Your Name]" } }, "outputFormat": { "title": "Output Format", "enum": [ "json", "csv", "manyreach" ], "type": "string", "description": "How to format the output", "default": "json" }, "outputFilters": { "title": "Output Filters", "type": "object", "description": "Filter which leads are included in output", "default": { "onlyWithEmail": false, "onlyWithPhone": false, "excludeCategories": [] } }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Send leads to this URL (Zapier, Make, n8n, etc.)" }, "webhookBatchSize": { "title": "Webhook Batch Size", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many leads to send per webhook call", "default": 10 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many leads to process in parallel", "default": 3 }, "feedbackWebhook": { "title": "Feedback Webhook (Optional)", "type": "string", "description": "Receive run metrics and errors for continuous improvement. POST payload includes success/failure, lead counts, and timing." } } }, "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 } } } } } } } } } } ```