Apify Google Maps Leads

Google Maps Leads (with Scalelist backfill)

Build a lead CSV from Google Maps in one pipeline:

1. Interview — ask target audience, target geography, and whether to use reviews for lead scoring.
2. Scrape — one compass/crawler-google-places run with four add-ons pre-configured (leads enrichment, website contacts, Instagram + Facebook profiles, optional reviews).
3. Filter & score — apply a review-based score if scoring is on.
4. Discover missing names — for places that came back with zero (or unnamed) leads, call apify/ai-web-scraper on the business website to extract owner/decision-maker names. Scalelist can't work without a name.
5. Backfill contacts — call scalelist/phone-finder for leads with a missing phone, scalelist/email-finder for leads with a missing email.
6. Deliver — a deduplicated CSV plus a run_metadata.json sidecar.

Prerequisites

• Apify account (sign up)
• Auth via one of:
  • apify login (OAuth, if using the Apify CLI)
  • APIFY_TOKEN env var
  • Token from Apify Console → Settings → Integrations

Either the Apify CLI (recommended for portability) or the Apify MCP connector works. Commands below use the CLI; the MCP path is a drop-in via the call-actor and get-dataset-items tools.

Workflow

Track progress with this checklist:

Task Progress:
- [ ] Step 1: Interview — audience, geography, scoring choice
- [ ] Step 2: Build the Google Maps input
- [ ] Step 3: Run compass/crawler-google-places
- [ ] Step 4: Filter + score (if scoring enabled)
- [ ] Step 5: Discover missing names via apify/ai-web-scraper
- [ ] Step 6: Backfill missing phones and emails via scalelist Actors
- [ ] Step 7: Deduplicate and render the CSV

Step 1: Interview

Ask three questions as one block — don't drip them one by one.

1. Target audience — the business type(s) to search for. Free text. Examples: "dentists", "vegan restaurants", "boutique hotels", "dog groomers, pet stores" (comma-splittable → array).
2. Target geography — one location per run. City + country reads best ("Berlin, Germany", "Austin, TX"). If the user gives a country only, warn that Maps runs perform best on city-scoped searches.
3. Use reviews for lead scoring? (y/n) — if yes, we pull reviews (maxReviews) and filter by review volume + star rating post-run. If no, we skip reviews to cut cost.

Follow-ups only if the user asks for more control:

• maxCrawledPlacesPerSearch — default 50. Bigger runs = bigger cost.
• maximumLeadsEnrichmentRecords — default 3 per place (people to enrich per business). Never 0 — that disables leads enrichment, which is the point.
• leadsEnrichmentDepartments — default [] (any). Enum values are listed in references/actor-inputs.md.
• Minimum star rating pre-filter (placeMinimumStars) — cheaper than post-filtering when scoring is off.
• Review-scoring thresholds — default is ≥ 10 reviews AND ≥ 4.0 rating.

Cost warning threshold. Compute expected_leads = maxCrawledPlacesPerSearch × maximumLeadsEnrichmentRecords. If it exceeds 200, restate the number back to the user and confirm before running. Leads enrichment is the dominant cost line; a slip here is what surprises people.

Step 2: Build the Google Maps input

Set every field below on every run. Full field reference in references/actor-inputs.md.

scrapeSocialMediaProfiles auto-enables scrapeContacts. Both are billed on top of the base scrape — see the Actor's pricing tab.

Step 3: Run compass/crawler-google-places

apify actors call "compass/crawler-google-places" \
  --input '<JSON_FROM_STEP_2>' \
  --user-agent apify-awesome-skills/apify-google-maps-leads \
  --json 2>/dev/null

Capture id (runId) and defaultDatasetId. Pull the dataset:

apify datasets get-items <DATASET_ID> --format json \
  --user-agent apify-awesome-skills/apify-google-maps-leads 2>/dev/null > places.json

Leads enrichment adds 30–90 s per place — expect long runs. If a run times out, the dataset already holds partial results; pull by datasetId.

Step 4: Filter and score

Applied to the raw places.json in order. Full logic in references/scoring-and-backfill.md.

1. Spurious-match filter (always on). Drop leads whose leadsEnrichment[].companyWebsite hostname doesn't match the place.website hostname. Same failure mode as apify-verified-email-finder — a global-fallback lead attributed to unrelated places by substring. Count drops in run_metadata.json.
2. Review-based score (only if scoring is on).
   • Default keep-logic: place.reviewsCount >= 10 AND place.totalScore >= 4.0.
   • Emit a numeric Lead Score column: round(place.totalScore * log10(place.reviewsCount + 1), 2). Higher = better local reputation.
   • If scoring is off, Lead Score is blank.
3. Empty-lead surfacing. If a place has zero enriched leads, keep one row for the place with blank person fields — the user sees the business but knows nobody was found. Never silently drop.

Step 5: Discover missing names via apify/ai-web-scraper

Scalelist needs a person name (or LinkedIn URL) to look anything up. When a place has zero enriched leads — or leads with blank firstName / lastName — but has a working website, run apify/ai-web-scraper on that website to extract owner/decision-maker names.

When to run this step per place (all conditions must hold):

• place.website is non-empty (nothing to scrape otherwise)
• Either leadsEnrichment[] is empty, or every lead has a blank firstName
• The place survived Step 4's scoring filter (don't spend on places we're going to drop)

Payload — same input pattern as the Apify AI Web Scraper "list of writers" example, retargeted from blog authors to local-business decision-makers:

{
  "startUrls": [{"url": "<place.website>"}],
  "extractionMode": "agentic",
  "prompt": "Find the owner, founder, or key decision-makers of this business. For each person, include their full name and job title. Prioritize pages like /about, /team, /contact, or the site footer.",
  "maxPagesToVisit": 20,
  "maxCrawlDepth": 3
}

Defaults trimmed vs. the blog example (which uses maxPagesToVisit: 100 / maxCrawlDepth: 5) — small-business sites are typically shallow, and this is one call per website.

apify actors call "apify/ai-web-scraper" \
  --input '{"startUrls":[{"url":"<place.website>"}],"extractionMode":"agentic","prompt":"...","maxPagesToVisit":20,"maxCrawlDepth":3}' \
  --user-agent apify-awesome-skills/apify-google-maps-leads \
  --json 2>/dev/null

One place per call — the Actor's crawl fans out from startUrls, so batching multiple business sites in one startUrls array would mix results. Run one call per place website. Parallelize across places if you have many.

Merge results back onto the place:

• The Actor returns rows with url, data, markdown. data holds the extracted people — expect { "people": [{ "name": "...", "jobTitle": "..." }] } or an array of such objects (LLM output shape varies).
• For each extracted person, split name on the last space into firstName / lastName.
• Append a new lead into place.leadsEnrichment[] with firstName, lastName, jobTitle, companyWebsite = place.website, and mark Backfill Source = "ai-web-scraper".
• Cap at 3 new leads per place — the Actor sometimes returns lots of tangential names (past employees, testimonial subjects).

Skip conditions:

• Skip entirely if the user opts out of name discovery up front (offer this as a follow-up when running large batches — this is the priciest step per place).
• Skip if place.website returns a redirect to a social profile (Facebook page, Instagram) — the AI scraper handles JS sites but Meta login walls will burn budget for nothing.