🗺️ Google Maps Enricher — Emails & Socials

Scrape businesses from Google Maps and automatically enrich them with emails, phone numbers, and social media profiles — all in one run.

---

❓ What does this actor do?

This actor searches Google Maps using the Serper.dev API and then visits each business website to extract contact information. Unlike other Google Maps scrapers that only return raw listings, this one gives you leads ready for outreach.

📥 What you give it A search query (e.g. "restaurants", "dental clinics") A location (e.g. "Miami, FL", "Madrid, Spain") Your Serper.dev API key

📤 What you get back Business name, address, phone, rating, GPS ✉️ Email addresses (all found, not just one) 📱 Social media profiles (up to 12 networks) 🌐 Website URL + Google Maps link

---

⚡ Key Features

🔍	Google Maps Search — Fast, structured search via Serper.dev API. No browser needed for searching. Supports pagination for up to 200 results per run.
🔗	Automatic Website Recovery — When the API doesn't return a website (common for restaurants, bars, hotels), the actor visits the Google Maps page directly using the business CID to recover the website URL and phone number.
📧	Multi-Layer Email Extraction — Finds emails via mailto: links, visible text regex, raw HTML scanning, and deobfuscation ([at], (dot)). Also visits internal /contact and /about pages.
📱	12 Social Networks — Detects Facebook, Instagram, TikTok, LinkedIn, Twitter/X, YouTube, WhatsApp, Pinterest, and Threads. Uses 4 techniques: href links, JSON-LD sameAs, Open Graph meta tags, and aria-label attributes.
⚡	Two-Phase Enrichment — Phase 1 uses fast httpx requests. If a site blocks or requires JavaScript, Phase 2 automatically falls back to a full Playwright browser (headless Chromium). No manual intervention needed.
🛡️	Smart Filtering — Automatically skips aggregator sites (Yelp, TripAdvisor, Booking, etc.) and social media share buttons. Only real business websites and profile links are kept.
🔄	Concurrent Processing — Enriches multiple websites simultaneously with configurable parallelism (default: 5 concurrent requests).

---

🎯 Use Cases

Use Case	Example Query	What You Get
Local Business Outreach	hair salons in Los Angeles, CA	Names + emails + Instagram profiles for cold email campaigns
Sales Prospecting	law firms in New York, NY	Phone numbers + LinkedIn + websites for sales reps
Market Research	restaurants in Madrid, Spain	Ratings + reviews + price ranges + GPS coordinates
Competitor Analysis	dentists in Miami, FL	Complete web presence across all social platforms
CRM Enrichment	plumbers in Chicago, IL	Structured JSON data ready to import into any CRM

---

📋 Input Parameters

Parameter	Type	Required	Default	Description
serperApiKey	String	✅ Yes	—	Your API key from serper.dev. Free tier includes 2,500 searches.
query	String	✅ Yes	—	What to search for. Examples: restaurants, dental clinics, hair salons, law firms
location	String	✅ Yes	—	City or area. Examples: Miami, FL, Madrid, Spain, Santo Domingo, Dominican Republic
country	String	No	us	Two-letter country code (us, es, do, uk, fr, etc.)
language	String	No	en	Language for results (en, es, fr, de, etc.)
maxResults	Integer	No	20	Maximum number of businesses to return. Range: 1–200.
enrichData	Boolean	No	true	When enabled, the actor visits each website to extract emails and social profiles. Disable for faster, search-only runs.
maxConcurrency	Integer	No	5	How many websites to visit simultaneously during enrichment. Higher = faster but uses more memory.

---

📤 Output Format

Each business in the output dataset contains:

{
    "name": "Elia on the River",
    "category": "Restaurant",
    "rating": 4.7,
    "reviewCount": 2500,
    "address": "1440 NW N River Dr Suite 195, Miami, FL",
    "phone": "+1 305-904-4045",
    "website": "https://www.eliaontheriver.com/",
    "priceRange": "$100+",
    "latitude": 25.785099,
    "longitude": -80.22043,
    "cid": "5855841797704673724",
    "gmapsUrl": "https://maps.google.com/?cid=5855841797704673724",
    "emails": ["info@eliaontheriver.com"],
    "socials": {
        "facebook": "https://www.facebook.com/eliaontheriver",
        "instagram": "https://instagram.com/eliaontheriver",
        "tiktok": "https://www.tiktok.com/@eliaontheriver"
    }
}

Field	Type	Description
name	String	Business name
category	String	Business category from Google Maps
rating	Number	Google Maps rating (1.0 – 5.0)
reviewCount	Number	Total number of reviews
address	String	Full street address
phone	String	Phone number (format varies by country)
website	String	Business website URL (or null if not found)
priceRange	String	Price level from Google Maps (e.g. $$, $30-50)
latitude	Number	GPS latitude coordinate
longitude	Number	GPS longitude coordinate
cid	String	Google Maps unique business identifier
gmapsUrl	String	Direct link to Google Maps listing
emails	Array	All email addresses found on the website
socials	Object	Social media profiles (keys: facebook, instagram, tiktok, linkedin, twitter, youtube, whatsapp, pinterest, threads)

---

⚙️ How It Works

The actor runs in 3 automatic phases:

Phase	What happens	Technology
1. Search	Queries Google Maps via Serper.dev API with automatic pagination and deduplication by CID	Serper API + httpx
1.5. Details Recovery	For businesses missing website/phone (common with restaurants, bars, hotels), visits the Google Maps page directly to recover those fields	Playwright (Chromium)
2a. Fast Enrichment	Visits each business website with fast HTTP requests to extract emails and social links	httpx + BeautifulSoup
2b. Deep Enrichment	Automatic fallback — if a website blocks or requires JavaScript, retries with a full browser	Playwright (Chromium)

---

💰 Cost

This actor uses the Serper.dev API for Google Maps data. You need your own API key:

Plan	Searches	Price
🆓 Free Tier	2,500 searches	$0
Starter	50,000 searches/month	$50/month
Enterprise	Unlimited	Custom

👉 Get your API key at serper.dev

Note: Each run with maxResults: 20 uses approximately 1 Serper API call. With maxResults: 200, it may use up to 10 calls due to pagination (20 results per API request).

---

💾 Memory Recommendations

Configuration	Recommended Memory	Use When
Search only (enrichData: false)	256 MB	You only need business names, addresses, ratings, and GPS
Search + Enrichment (small runs)	1024 MB	Up to 50 businesses with enrichment enabled
Search + Enrichment (large runs)	2048 MB	100+ businesses with enrichment and Playwright fallback

---

🌍 Supported Countries & Languages

This actor works globally. Set the country and language parameters to match your target market:

Market	Country Code	Language
🇺🇸 United States	us	en
🇪🇸 Spain	es	es
🇩🇴 Dominican Republic	do	es
🇬🇧 United Kingdom	uk	en
🇫🇷 France	fr	fr
🇩🇪 Germany	de	de
🇧🇷 Brazil	br	pt
🇲🇽 Mexico	mx	es
🇮🇹 Italy	it	it
🇸🇬 Singapore	sg	en

Any country supported by Google Maps is supported by this actor. Use the standard ISO 3166-1 alpha-2 country codes.

---

📱 Social Networks Detected

Network	Domains Matched	Detection Methods
Facebook	facebook.com, fb.com	href, JSON-LD, OG, aria-label
Instagram	instagram.com	href, JSON-LD, OG, aria-label
TikTok	tiktok.com	href, JSON-LD, OG, aria-label
LinkedIn	linkedin.com	href, JSON-LD, OG, aria-label
Twitter / X	twitter.com, x.com	href, JSON-LD, OG, meta tag
YouTube	youtube.com	href, JSON-LD, OG, aria-label
WhatsApp	wa.me, api.whatsapp.com	href, aria-label
Pinterest	pinterest.com	href, JSON-LD, aria-label
Threads	threads.net	href, JSON-LD, aria-label

---

🔧 Integrations

The output dataset is compatible with:

• Google Sheets — Export directly from the Apify console
• Zapier / Make — Trigger workflows with new results
• CRMs — Import JSON into HubSpot, Salesforce, Pipedrive
• Clay — Sync via Apify integration
• Excel / CSV — Download from the Apify console

---

❓ FAQ

Q: Does this work with any search term? Yes. Restaurants, dental clinics, law firms, hair salons, plumbers — any business type you can find on Google Maps.

Q: Some businesses don't have emails or social media. Why? Not all businesses have contact information on their websites. The actor extracts everything available, but some businesses simply don't publish emails or maintain social media profiles.

Q: How many Serper API credits does each run use? Approximately 1 credit per 20 results. A run with maxResults: 100 uses ~5 credits.

Q: Can I run this without enrichment? Yes. Set enrichData: false to get only Google Maps data (faster, no website visits, 256MB memory).