Google Maps Email Extractor Apify Skill

Overview

This skill helps an AI agent run the Apify Google Maps Email Extractor actor for public business email lead generation from Google Maps.

Default actor:

• Actor ID: f3dlnXVnBc6v8JMNK
• Actor name: x_guru/google-maps-email-extractor
• Store page: https://apify.com/x_guru/google-maps-email-extractor
• Console source: https://console.apify.com/actors/f3dlnXVnBc6v8JMNK/source

Use this skill when a user asks to:

• build local business email lead lists from Google Maps
• find public emails for dentists, roofers, lawyers, photographers, gyms, clinics, restaurants, contractors, agencies, real estate offices, or other local niches
• enrich Google Maps places with websites, emails, phones, social links, ratings, reviews count, addresses, and coordinates
• run Google Maps searches by keyword and location with emailsOnly output
• run exact Google Maps URLs or Google Place IDs and return email lead rows
• control Apify spend with maxTotalChargeUsd
• export rows for Sheets, Airtable, n8n, CRM, BI, CSV, JSON, or agent workflows

Quick Workflow

1. Clarify the niche, location, desired saved email lead count, and whether person-like emails are allowed.
2. Build a small payload first with searchStringsArray, locationQuery, maxCrawledPlacesPerSearch, contactResultMode: "emailsOnly", website: "withWebsite", and language.
3. Use startUrls or placeIds when the user already has exact Google Maps sources.
4. Increase contactPagesLimit only when a niche hides emails on team, staff, legal, imprint, or contact pages.
5. Use category/rating/website filters when the search is broad or noisy.
6. Set a budget guard with Apify maxTotalChargeUsd when spend matters.
7. Run scripts/google_maps_email_extractor_actor.py or call the Apify API directly.
8. Return compact metrics and email lead rows. Check RUN_SUMMARY for diagnostics when counts are lower than requested.

Payload Rules

• Standard search uses searchStringsArray, locationQuery, maxCrawledPlacesPerSearch, and language.
• Default saved-output mode is contactResultMode: "emailsOnly".
• Use website: "withWebsite" for email extraction because public emails usually come from business websites.
• maxCrawledPlacesPerSearch is the requested saved lead target. The actor may scan more Google Maps candidates internally to find enough email leads.
• contactPagesLimit defaults to 2; use 3-5 for deeper email discovery.
• includePersonalData=false keeps mostly generic company contacts such as info@, sales@, hello@, and contact@.
• startUrls must be array objects: [{"url": "https://www.google.com/maps/..."}].
• placeIds accepts raw Google Place IDs and compatible place_id: values.
• contactResultMode must be emailsOnly, contactsOnly, or allPlaces.
• Paid filters include categoryFilterWords, placeCategories, customPlaceCategories, searchMatching, placeMinimumStars, website, and skipClosedPlaces.
• Search area can use locationQuery, countryCode, city, state, county, postalCode, customGeolocation, locationBounds, or strictLocationBounds.
• Do not use review-row fields such as maxReviews here. Use the Google Maps Reviews Scraper skill for reviews.

Authentication

Use the Apify API token from the environment:

export APIFY_TOKEN='apify_api_xxx'

Never hardcode or print the full token in user-facing output.

Script Usage

The bundled script uses only Python standard library.

Run a quick email-lead search:

APIFY_TOKEN='apify_api_xxx' \
python3 scripts/google_maps_email_extractor_actor.py quick-search \
  --query "wedding photographer" \
  --location "Austin, Texas, USA" \
  --limit 25 \
  --budget-usd 1

Run by Google Maps URL:

APIFY_TOKEN='apify_api_xxx' \
python3 scripts/google_maps_email_extractor_actor.py quick-url \
  --url "https://www.google.com/maps/search/roofing+contractor+Dallas,+TX" \
  --limit 50 \
  --budget-usd 1

Run by Place ID:

APIFY_TOKEN='apify_api_xxx' \
python3 scripts/google_maps_email_extractor_actor.py quick-place-id \
  --place-id "ChIJE2Flwy-1RIYRWqJr_ZiMGc" \
  --budget-usd 1

Run custom JSON:

APIFY_TOKEN='apify_api_xxx' \
python3 scripts/google_maps_email_extractor_actor.py run \
  --input-file references/sample_input.json \
  --budget-usd 1

Recommended Inputs

Local email leads

{
  "searchStringsArray": ["wedding photographer"],
  "locationQuery": "Austin, Texas, USA",
  "maxCrawledPlacesPerSearch": 100,
  "contactResultMode": "emailsOnly",
  "contactPagesLimit": 2,
  "includePersonalData": true,
  "website": "withWebsite",
  "skipClosedPlaces": true,
  "language": "en"
}

Generic company emails only

{
  "searchStringsArray": ["commercial electrician"],
  "locationQuery": "Denver, Colorado, USA",
  "maxCrawledPlacesPerSearch": 100,
  "contactResultMode": "emailsOnly",
  "includePersonalData": false,
  "website": "withWebsite"
}

Exact sources

{
  "startUrls": [
    {
      "url": "https://www.google.com/maps/search/marketing+agency+near+Chicago,+IL"
    }
  ],
  "maxCrawledPlacesPerSearch": 50,
  "contactResultMode": "emailsOnly",
  "website": "withWebsite"
}

Output Contract

The runner returns JSON:

• ok
• actorId
• fetchedAt
• inputUsed
• itemCount
• rows[]

Rows are actor dataset items. Important groups:

• Business: title, categoryName, categories, rank, searchString
• Emails: emails, emailDetails.email, emailDetails.type, emailDetails.sourceUrl, emailDetails.domainMatch
• Contacts: website, phone, phoneUnformatted, additionalPhones, social profile arrays
• Address: address, street, city, state, postalCode, countryCode, location, plusCode
• Google metrics: totalScore, reviewsCount, reviewsDistribution, closed flags
• Google IDs: placeId, fid, cid, kgmid, url, searchPageUrl
• Diagnostics: contactSignals, contactStatus, additionalInfo.companyContacts, scrapedAt

For the full contract, read references/input-output-contract.md.

Agent Response Rules

• If rows are empty, say the run succeeded but no email leads were saved, then suggest checking RUN_SUMMARY.
• If fewer rows than requested are returned, explain that the niche/area had fewer public emails or the budget/filter stopped saving.
• If emails is empty in contactsOnly or allPlaces, explain that the row was saved due to other contact data.
• Explain public email extraction as best-effort because each business controls what its website publishes.
• Use maxTotalChargeUsd for any user concerned about spend.
• Do not promise review text or full review datasets from this actor. Use the separate Google Maps Reviews Scraper for reviews.

References

• references/input-output-contract.md
• references/sample_input.json
• references/troubleshooting.md