🗺️ Google Maps Scraper

Extract complete business data from Google Maps with email discovery - A comprehensive solution for market research, business intelligence, and lead generation.

⚠️ Important Notice

📋 Responsible Use: This actor is designed for legitimate business research, market analysis, and contact discovery. Users are responsible for ensuring compliance with applicable terms of service and data protection regulations.

🔒 Legal Compliance: Please ensure your usage complies with:

• Platform terms of service
• Local privacy and data protection laws (GDPR, CCPA, etc.)
• Respect for website robots.txt and rate limiting
• Applicable business and marketing regulations

🎯 What Does This Tool Do?

This actor extracts comprehensive business information from Google Maps search results, including:

• 📍 Business Details: Name, address, phone, rating, reviews, operating hours
• 📧 Email Addresses: Extracts emails by visiting business websites from Google Maps listings
• 🌍 Multi-language Support: Works in English and Traditional Chinese
• ⚡ Efficient Processing: Handle up to 120 businesses per search

Perfect for lead generation, B2B sales, market research, and business intelligence.

✨ Key Features

🗺️ Google Maps Data Extraction

• Complete Business Profiles: Extract name, address, phone numbers, ratings, review counts
• Operating Hours: Get detailed business hours for each day of the week
• Location Data: Precise latitude/longitude coordinates and Google Place IDs
• Business Categories: Automatically detect business types (restaurant, shop, service, etc.)

📧 Email Collection Capabilities

• Website Extraction: Visits business websites from Google Maps listings to extract emails
• Email Pattern Detection: Finds email addresses from website content
• Batch Processing: Processes multiple business websites efficiently
• Website Integration: Uses business websites from Google Maps data for email discovery

🚀 Performance & Reliability

• Concurrent Processing: Process multiple searches simultaneously for faster results
• Error Recovery: Built-in retry mechanisms and error handling
• Memory Optimized: 8GB RAM allocation for stable processing
• Timeout Management: Smart timeout calculations based on workload

🌍 Multi-language & Location Support

• 2 Languages: English, Traditional Chinese
• Wide Coverage: Search businesses in major cities and regions on Google Maps
• Local Results: Get region-specific business data with proper language settings

🚀 Quick Start Guide

1. Basic Usage (Apify Platform)

{
    "searchQueries": ["coffee shops Manhattan NYC", "restaurants Brooklyn"],
    "maxResults": 100,
    "language": "en",
    "scrapeEmails": true,
    "maxScrolls": 50
}

2. CLI Usage (Apify CLI)

# Install Apify CLI
npm install -g apify-cli

# Run the scraper
apify call google-maps-email-extractor \
  -i '{"searchQueries":["dentists Los Angeles"],"maxResults":50,"scrapeEmails":true}' \
  --timeout 3600

3. Advanced Configuration

{
    "searchQueries": [
        "digital marketing agencies San Francisco",
        "software companies Austin Texas",
        "restaurants with outdoor seating Seattle"
    ],
    "maxResults": 100,
    "language": "en",
    "scrapeEmails": true,
    "maxScrolls": 50,
    "startUrls": [
        {"url": "https://www.google.com/maps/search/pizza+near+downtown+portland"}
    ]
}

📊 Input Parameters

Parameter	Type	Default	Range	Description
searchQueries	Array	Required	1-50 items	Search terms like "coffee shops NYC"
maxResults	Number	100	50-200	Maximum results per search query
language	String	"en"	See below	Interface language for localized results
scrapeEmails	Boolean	true	-	Extract emails from business websites
maxScrolls	Number	50	30-100	Scroll attempts to load more results
startUrls	Array	[]	0-20 items	Direct Google Maps URLs (optional)

🌍 Supported Languages

• English (en) - Default
• Traditional Chinese (zh-TW) - Taiwan, Hong Kong

📋 Output Data Structure

Each extracted business includes:

{
    "name": "Blue Bottle Coffee",
    "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4",
    "latitude": 40.7829,
    "longitude": -73.9654,
    "rating": 4.4,
    "reviews": 1205,
    "address": "160 Berry St, Brooklyn, NY 11249",
    "businessType": "Coffee shop",
    "phone": "+1 718-387-4160",
    "website": "https://bluebottlecoffee.com",
    "email": "info@bluebottlecoffee.com",
    "hours": [
        "Monday: 07:00–19:00",
        "Tuesday: 07:00–19:00",
        "Wednesday: 07:00–19:00",
        "Thursday: 07:00–19:00",
        "Friday: 07:00–19:00",
        "Saturday: 08:00–19:00",
        "Sunday: 08:00–18:00"
    ],
    "url": "https://maps.google.com/maps?cid=1234567890",
    "query": "coffee shops Brooklyn",
    "timestamp": "2025-08-17T15:30:00.000Z"
}

💡 Best Practices for Maximum Results

🎯 Search Query Optimization

• Be Specific: "Italian restaurants Brooklyn NYC" > "restaurants"
• Include Location: Always specify city/area for accurate local results
• Use Business Categories: "dentist", "plumber", "coffee shop", "hotel"
• Target Specific Areas: "restaurants near Times Square", "shops in downtown Portland"

📍 Geographic Coverage Strategy

For comprehensive lead generation, use multiple search queries targeting different districts or neighborhoods:

Examples:

{
  "searchQueries": [
    "dentists Manhattan New York",
    "dentists Brooklyn New York", 
    "dentists Queens New York",
    "dentists Bronx New York",
    "dentists Staten Island New York"
  ]
}

Best Practices:

• Divide large cities into districts/neighborhoods for better coverage
• Use 5-10 geographic variations per business type
• Combine business category + specific location for targeted results

⚡ Performance Optimization

{
    "maxResults": 50,        // Sweet spot for speed vs coverage
    "maxScrolls": 50,        // Balance between results and processing time
    "scrapeEmails": true,    // Enable for lead generation (slower but valuable)
    "language": "en"         // Match your target market language
}

🕐 Timeout & Memory Settings

Configuration	Recommended Timeout	Expected Results
50 results, no emails	30 minutes	~45 businesses
100 results, no emails	60 minutes	~95 businesses
50 results, with emails	45 minutes	~40 businesses with emails
100 results, with emails	90 minutes	~80 businesses with emails
200 results, with emails	3 hours	~120 businesses with emails

Memory: 8GB (automatically configured)
Formula: max(1800, queries × maxResults × 15-25 seconds)

🎯 Use Cases & Industries

🏢 B2B Lead Generation

• Sales Teams: Build targeted prospect lists with verified contact information
• Digital Agencies: Find local businesses needing marketing services
• Software Companies: Target businesses by industry and location
• Consultants: Research potential clients in specific markets

📧 Email Marketing

• Local Campaigns: Target businesses in specific geographic areas
• Industry-Specific: Find restaurants, hotels, shops, or service providers
• Event Promotion: Reach local businesses for sponsorship opportunities
• Partnership Outreach: Connect with complementary businesses

📊 Market Research

• Competitor Analysis: Map competitor locations and contact information
• Market Sizing: Count businesses in specific categories and locations
• Location Intelligence: Analyze business density and distribution
• Contact Database Building: Create comprehensive industry directories

🏪 Industry-Specific Applications

• Real Estate: Find property management companies, realtors
• Food & Beverage: Restaurants, cafes, bars, catering services
• Healthcare: Dentists, clinics, medical practices
• Retail: Shops, boutiques, specialty stores
• Professional Services: Law firms, accounting, consulting

🐛 Troubleshooting Guide

❌ Common Issues

1. "No results found"

Causes: Generic search terms, no businesses in area
Solutions: Use specific keywords, include location, try broader search terms

2. "Validation failed"

Causes: Input parameters below minimum requirements
Solutions:

• Ensure maxResults is at least 50 (minimum: 50, maximum: 200)
• Ensure maxScrolls is at least 30 (minimum: 30, maximum: 100)
• Check that language is either "en" or "zh-TW"

3. "Timeout reached"

Causes: Insufficient timeout for large datasets
Solutions: Increase timeout, reduce maxResults, disable email scraping for faster processing

4. "Low email extraction rate"

Causes: Businesses without websites, protected contact pages
Solutions: Expected behavior - not all businesses have extractable emails

5. "Rate limiting detected"

Causes: Too many requests to Google Maps
Solutions: Reduce maxScrolls, add delays, try again later

✅ Optimization Tips

1. Start Small: Test with 50 results before scaling up
2. Use Specific Queries: "coffee shops downtown Seattle" > "coffee"
3. Monitor Logs: Check Apify Console for detailed progress
4. Adjust Timeouts: Use our calculator for optimal settings

⚠️ Important Limitations & Considerations

• Google Maps Limit: Maximum ~120 results per search query
• Email Availability: Not all businesses have extractable email addresses
• Rate Limiting: Respect for platform limits and responsible usage
• Website Accessibility: Some business websites may restrict automated access
• Regional Variations: Results quality varies by geographic location
• Terms Compliance: Users must ensure all usage complies with applicable terms of service and regulations

📞 Support & Documentation

🆘 Getting Help

1. Check Logs: Review Apify Console logs for detailed error messages
2. Verify Parameters: Ensure all input parameters meet minimum requirements
3. Test Small: Start with 1-2 search queries and 50 results
4. Timeout Settings: Use our calculator for optimal configuration

📚 Additional Resources

• Apify Platform Documentation
• Google Maps Search Tips
• Lead Generation Best Practices

🤝 Community

• Share your use cases and success stories
• Report bugs or request features
• Join discussions about data extraction