Local Business Lead Finder & AI Outreach Engine API

This Actor is a Google Maps lead finder, local business lead generation API, and AI outreach generator for agencies that sell local SEO, Google Business Profile optimization, website design, review growth, and technical SEO services.

It helps you find local businesses with visible gaps such as no website, low review count, weak rating, missing contact details, incomplete profiles, and basic website SEO issues. It also enriches leads with publicly visible business emails, contact pages, and social links so the output is stronger than a basic local scraper. The output is designed for agency prospecting, cold outreach preparation, CRM imports, and manual sales review.

No Coding Needed

You do not need to integrate this API into your website.

Just enter:

1. Business keyword
2. Location
3. Number of leads

Then click Run.

The Actor gives you a ready dataset with:

• local business leads
• pain points
• opportunity scores
• emails when found
• outreach messages
• WhatsApp/call scripts

You can download the results as CSV, Excel, JSON, or use the Apify API only if you want automation.

Search-Friendly Positioning

The README is optimized around buyer-intent long-tail phrases that fit the product naturally:

• google maps lead finder
• local business lead generation api
• local seo lead generation
• google business profile audit tool
• ai outreach generator for agencies
• website design leads finder
• business email finder
• local business email extractor
• email discovery API
• contact enrichment
• AI outreach leads

What This Actor Does

• Finds local businesses by keyword, location, country, language, and result limit.
• Collects public business data such as name, category, address, phone, website, rating, reviews, maps URL, status, and coordinates when available.
• Scans public business websites for visible emails, contact pages, and social links without paid enrichment APIs.
• Detects sales triggers like no website, low reviews, weak rating, missing HTTPS, missing title or meta description, missing schema, broken pages, slow sites, and incomplete public profiles.
• Scores each lead with opportunityScore, leadQualityScore, priorityScore, opportunityLevel, contactReadiness, and email-quality signals.
• Recommends the best offer angle: GBP optimization, local SEO, website design, review growth, citation building, technical SEO, or speed optimization.
• Recommends the best outreach channel and drafts outreach for email, follow-up email, WhatsApp, and cold calls.
• Saves a non-billable run summary to OUTPUT.json.

Best Fit Users

• Local SEO agencies
• Google Business Profile agencies
• Web design freelancers
• Lead generation services
• Cold outreach teams
• Consultants selling marketing services to local businesses

Input Schema

Required inputs:

• keyword: business niche such as roofing contractors, plumbers, dentists, or HVAC companies
• location: city, metro area, state, or region such as Dallas, TX

Optional inputs:

• country: expands the discovery query and fallback geocoding
• language: language hint for public search requests
• maxResults: maximum billable leads to keep after scoring and deduplication
• minOpportunityScore: filter out weak opportunities
• includeWebsiteSeoCheck: run lightweight website checks
• includeCompetitorGap: calculate nearby review and rating gaps
• includeAiOutreach: try AI-written drafts before using rule-based templates
• includeEmailDiscovery: scan websites for public business emails
• emailScanDepth: number of internal pages to scan per website
• maxWebsitesToEnrich: max websites to scan for email enrichment per run
• emailMxCheck: optionally validate extracted email domains with MX lookups
• includeSocialLinks: extract visible social profile links
• preferBusinessEmails: prioritize role-based business emails like info@ and contact@
• outreachService: force the offer angle or leave it on auto
• tone: outreach voice, such as friendly or professional

Example input:

{
  "keyword": "roofing contractors",
  "location": "Dallas, TX",
  "country": "United States",
  "language": "en",
  "maxResults": 50,
  "minOpportunityScore": 60,
  "includeWebsiteSeoCheck": true,
  "includeCompetitorGap": true,
  "includeAiOutreach": true,
  "includeEmailDiscovery": true,
  "emailScanDepth": 1,
  "maxWebsitesToEnrich": 25,
  "emailMxCheck": false,
  "includeSocialLinks": true,
  "preferBusinessEmails": true,
  "outreachService": "auto",
  "tone": "friendly"
}

Output Schema

The Actor now defines input, dataset, key-value store, and output schema files in .actor/ so the contract is explicit in Apify Console and API integrations.

Dataset output:

• Billable lead rows are pushed to the default dataset
• Row type is one of local_business_lead, high_opportunity_lead, or outreach_ready_lead
• Dataset views include leads, email, outreach, and painPoints

Key-value store output:

• The non-billable report is saved under the OUTPUT key
• The report includes target context, summary counts, top pain points, top leads, recommendations, and limitations

Output schema links:

• leadResults: default dataset with the leads view selected
• emailResults: default dataset with the email view selected
• outreachResults: default dataset with the outreach view selected
• summaryReport: the OUTPUT record in the default key-value store

Email Discovery & Contact Enrichment

The actor can scan publicly visible business websites to find business emails, contact pages, and social links. It scores email quality and recommends the best outreach channel for each lead.

What it adds to each lead row:

• emails
• primaryEmail
• hasEmail
• emailQuality
• socials
• contactPages
• enrichment
• recommendedOutreachChannel
• contactAction

This helps position the actor as a:

• business email finder
• local business email extractor
• email discovery API
• contact enrichment tool
• AI outreach leads workflow

Example Dataset Row

{
  "type": "outreach_ready_lead",
  "businessName": "Dallas Roofing Pros",
  "category": "Roofing contractor",
  "keyword": "roofing contractors",
  "location": "Dallas, TX",
  "address": "123 Main St, Dallas, TX 75201",
  "phone": "+1 214-555-0198",
  "primaryEmail": "info@dallasroofingpros.com",
  "hasEmail": true,
  "website": "https://dallasroofingpros.com",
  "googleMapsUrl": "https://www.google.com/maps/place/Dallas+Roofing+Pros",
  "rating": 3.8,
  "reviewCount": 18,
  "opportunityScore": 85,
  "opportunityLevel": "high",
  "leadQualityScore": 80,
  "contactReadiness": "email_ready",
  "detectedPainPoints": [
    "Low review count",
    "Missing meta description"
  ],
  "recommendedService": "Google Business Profile Optimization",
  "recommendedOutreachChannel": "email",
  "contactAction": "Send email",
  "emailSubject": "Quick idea for your Google visibility",
  "shortEmail": "Hi Dallas Roofing Pros, I noticed your profile has fewer reviews than stronger nearby competitors. Would it be useful if I sent a quick free audit? If this is not relevant, feel free to ignore this.",
  "followUpEmail": "Hi Dallas Roofing Pros, just following up on my earlier note with a few practical local visibility fixes. If this is not relevant, feel free to ignore this.",
  "whatsappMessage": "Hi Dallas Roofing Pros, I noticed a few local visibility gaps and can send a quick audit if helpful.",
  "coldCallOpener": "Hi, is this the right person for local marketing at Dallas Roofing Pros?",
  "priorityScore": 83,
  "reason": "This business has only 18 reviews while nearby competitors average 89+, which means they are likely losing customers compared to nearby competitors. This creates a strong opportunity for Google Business Profile Optimization.",
  "source": "google_local_html"
}

Example OUTPUT.json

{
  "target": {
    "keyword": "roofing contractors",
    "location": "Dallas, TX",
    "country": "United States"
  },
  "scanDate": "2026-05-04T16:20:00.000Z",
  "summary": {
    "totalBusinessesFound": 50,
    "billableLeadsReturned": 25,
    "highOpportunityLeads": 12,
    "outreachReadyLeads": 18,
    "averageOpportunityScore": 73,
    "topRecommendedServices": [
      "Google Business Profile Optimization",
      "Review Growth Campaign"
    ]
  },
  "emailEnrichment": {
    "websitesScanned": 20,
    "leadsWithEmail": 11,
    "leadsWithBusinessEmail": 8,
    "leadsWithSocialLinks": 13,
    "averageEmailQualityScore": 72,
    "topEmailDomains": [
      "dallasroofingpros.com",
      "gmail.com"
    ]
  },
  "topPainPoints": [
    "Low review count",
    "Missing meta description"
  ],
  "topLeads": [
    {
      "businessName": "Dallas Roofing Pros",
      "opportunityScore": 85,
      "recommendedService": "Google Business Profile Optimization"
    }
  ],
  "recommendations": {
    "bestServiceToSell": "Google Business Profile Optimization",
    "bestOutreachChannel": "Email first",
    "suggestedDailyOutreachVolume": 20,
    "nextSteps": [
      "Prioritize email-ready leads first because they are the fastest to launch into personalized outreach."
    ]
  },
  "limitations": [
    "Only publicly visible business data is collected."
  ]
}

Opportunity Scoring

The actor builds an opportunityScore from common local-business sales triggers:

• no website
• low review count
• rating below 4.0
• broken or slow website
• missing basic SEO elements
• weak profile completeness

Opportunity labels:

• high
• medium
• low

Outreach Generation

If GEMINI_API_KEY is available, the actor can lightly polish outreach tone while keeping the same core sales structure. If no Gemini key is configured or the request fails, it falls back to rule-based messaging.

Generated outreach fields:

• emailSubject
• shortEmail
• followUpEmail
• whatsappMessage
• coldCallOpener

Recommended contact-routing fields:

• recommendedOutreachChannel
• contactAction

The messaging is intentionally short, pain-point focused, opt-out friendly, and avoids deceptive claims or guaranteed ranking promises.

Billing Notes

• Only dataset lead rows are billable
• Email enrichment is included inside the same lead rows and does not create extra dataset rows
• OUTPUT.json is non-billable
• Summary and recommendation records stay in the default key-value store

Limitations

• Only publicly visible business information is collected
• No private personal data is collected
• Website checks are lightweight and not a replacement for a full SEO audit
• Email discovery only uses publicly visible website content and never hallucinates emails
• Public discovery sources can be rate-limited or incomplete
• If live discovery fails for the default QA input, rows may use source: "sample_prefill_for_qa" only for Apify QA prefill

FAQ

Is this only a Google Maps scraper?

No. Discovery is only the first layer. The Actor also scores pain points, recommends services, checks website basics, estimates competitor gaps, and drafts outreach.

Can I use it without an AI key?

Yes. Rule-based outreach still works without GEMINI_API_KEY.

Where is the summary report stored?

The summary report is saved as OUTPUT.json in the default key-value store under the OUTPUT key.