Google Maps Scraper - Extract Business Data, Contacts & Reviews

Professional Google Maps scraper that extracts comprehensive business information including contact details, reviews, ratings, opening hours, social media links, and more. Perfect for lead generation, market research, and business intelligence.

LICENSE

🚀 Why Choose This Google Maps Scraper?

Extract everything you need from Google Maps in one go:

• ✅ Complete Contact Information: Phone numbers, emails, addresses, websites
• ✅ Business Intelligence: Ratings, reviews, opening hours, price levels
• ✅ Social Media Discovery: Automatically finds Facebook, Instagram, LinkedIn, Twitter profiles
• ✅ Image Extraction: Download business photos and images
• ✅ GPS Coordinates: Precise location data for mapping and analysis
• ✅ Anti-Detection: Advanced stealth techniques to avoid blocks
• ✅ Reliable & Fast: Built on Playwright with robust error handling

Perfect for:

• 📊 Lead generation and prospecting
• 🔍 Market research and competitive analysis
• 📧 Email marketing campaigns
• 📱 Social media outreach
• 🗺️ Location-based business intelligence
• 📈 Data enrichment and CRM updates

📋 What Data Can You Extract?

Core Business Information

• Business name and category
• Full address with postal code
• GPS coordinates (latitude/longitude)
• Google Maps URL

Contact Details

• Phone numbers (multiple formats)
• Email addresses
• Website URLs
• Social media profiles (Facebook, Instagram, LinkedIn, Twitter/X, YouTube, TikTok)

Reviews & Ratings

• Average rating (0-5 stars)
• Total number of reviews
• Individual review details (rating, author, text, date)

Additional Data

• Opening hours
• Price level indicators ($, $$, $$$, $$$$)
• Business images
• Permanent closure status

🎯 Quick Start

Basic Example - Find Restaurants in Paris

{
  "searchStringsArray": ["restaurant"],
  "locationQuery": "Paris, France"
}

Advanced Example - Extract All Data

{
  "searchStringsArray": ["restaurant", "cafe", "hotel"],
  "locationQuery": "New York, USA",
  "scrapePlaceDetailPage": true,
  "scrapeReviews": true,
  "scrapeContacts": true,
  "scrapeImages": true,
  "maxImages": 10,
  "scrapeSocialMediaProfiles": true
}

Lead Generation Example - Healthcare Professionals

{
  "searchStringsArray": ["infirmière", "médecin", "pharmacie"],
  "locationQuery": "Vaucluse, France",
  "language": "fr",
  "scrapeContacts": true,
  "scrapeSocialMediaProfiles": true,
  "skipClosedPlaces": true
}

⚙️ Configuration Options

Search Parameters

Parameter	Type	Default	Description
searchStringsArray	Array	["restaurant"]	Search terms (e.g., ["restaurant", "cafe"])
locationQuery	String	"New York, USA"	Location to search (city, region, or country)
maxCrawledPlacesPerSearch	Integer	500	Maximum places per search term (1-1000)
language	String	"en"	Language code ("en", "fr", "es", etc.)

Data Extraction Options

Parameter	Type	Default	Description
scrapePlaceDetailPage	Boolean	true	Extract detailed information from place pages
scrapeReviews	Boolean	true	Extract reviews and ratings
scrapeContacts	Boolean	true	Scrape contact info from business websites
scrapeOpeningHours	Boolean	true	Extract opening hours
scrapePriceLevel	Boolean	true	Extract price level information
scrapeImages	Boolean	false	Extract images from places
maxImages	Integer	0	Maximum images per place (0 = disabled)
scrapeSocialMediaProfiles	Boolean	true	Extract social media profiles
skipClosedPlaces	Boolean	false	Skip permanently closed places

📊 Output Data Structure

Each result includes:

{
  "nom": "Restaurant Le Jardin",
  "lieu": "Paris, France",
  "telephone": "+33 1 23 45 67 89",
  "email": "contact@restaurant-lejardin.fr",
  "adresse": "123 Rue de la Paix, 75001 Paris, France",
  "website": "https://www.restaurant-lejardin.fr",
  "googleMapsUrl": "https://www.google.com/maps/place/...",
  "rating": 4.5,
  "reviewsCount": 125,
  "category": "Restaurant",
  "coordinates": {
    "lat": 48.8566,
    "lng": 2.3522
  },
  "reviews": [...],
  "openingHours": "Mon-Fri: 9am-5pm",
  "priceLevel": "$$",
  "images": [...],
  "socialMediaLinks": {
    "facebook": ["https://facebook.com/..."],
    "instagram": ["https://instagram.com/..."]
  },
  "source": "google_maps",
  "scrapedAt": "2025-12-11T20:52:23.498Z"
}

🔧 How It Works

1. Geolocation: Automatically geolocates your location query using OpenStreetMap
2. Map Segmentation: Splits the area into segments for comprehensive coverage
3. Search Execution: Searches Google Maps with GPS coordinates for each segment
4. Data Extraction: Extracts place listings from search results
5. Detail Scraping: Optionally scrapes individual place pages for complete data
6. Website Scraping: Automatically scrapes business websites for additional contacts
7. Deduplication: Removes duplicate entries using place IDs

💡 Use Cases

1. Lead Generation

Extract contact information for businesses in your target market. Perfect for B2B sales teams and marketing agencies.

2. Market Research

Analyze competitors, pricing, and market trends by extracting data from multiple locations.

3. Email Marketing

Build targeted email lists with verified business contacts and email addresses.

4. Social Media Outreach

Find and connect with businesses on social media platforms automatically.

5. Location Intelligence

Map business locations, analyze geographic distribution, and identify market gaps.

6. Data Enrichment

Enhance your CRM or database with up-to-date business information from Google Maps.

🛡️ Technical Features

• Playwright-Based: Handles JavaScript-rendered content reliably
• Anti-Detection: Realistic browser fingerprinting and stealth techniques
• Robust Error Handling: Automatic retries and timeout management
• Efficient Crawling: Optimized concurrency and request handling
• Data Quality: Automatic deduplication and data validation

📈 Performance

• Speed: Processes hundreds of places per hour
• Reliability: Robust error handling ensures data is always saved
• Coverage: Map segmentation ensures comprehensive area coverage
• Scalability: Handles large-scale scraping operations

⚠️ Important Notes

• Rate Limiting: The scraper implements delays to respect Google Maps' terms of service
• Data Availability: Some fields may not be available for all places
• Website Scraping: Contact extraction from websites depends on site structure
• Legal Compliance: Ensure your use case complies with applicable data protection laws

🐛 Troubleshooting

No Results Found

• Verify your locationQuery is correct and can be geolocated
• Try different or more specific search terms
• Check that the location has businesses matching your search

Missing Contact Information

• Enable scrapePlaceDetailPage and scrapeContacts for maximum data
• Some businesses may not have public contact information
• Website scraping may require additional time

Timeout Errors

• The scraper includes robust timeout handling
• Very slow pages may still timeout occasionally
• Try reducing maxCrawledPlacesPerSearch if issues persist

📚 Examples & Tutorials

Example 1: Find All Restaurants in a City

{
  "searchStringsArray": ["restaurant", "bistro", "cafe"],
  "locationQuery": "San Francisco, CA",
  "scrapeReviews": true,
  "scrapeContacts": true
}

Example 2: Extract Healthcare Providers

{
  "searchStringsArray": ["doctor", "clinic", "hospital"],
  "locationQuery": "London, UK",
  "scrapePlaceDetailPage": true,
  "scrapeSocialMediaProfiles": true
}

Example 3: Market Research - Competitor Analysis

{
  "searchStringsArray": ["coffee shop"],
  "locationQuery": "Seattle, WA",
  "scrapeReviews": true,
  "scrapePriceLevel": true,
  "scrapeImages": true,
  "maxImages": 5
}

🔗 Related Actors

• Similar to compass/crawler-google-places with enhanced features
• Compatible with other Apify Actors for data processing
• Can be integrated with Zapier, Make, and other automation tools

📞 Support

For issues, questions, or feature requests:

• Check the Actor's page on Apify Console
• Review the logs for error details
• Contact the maintainer through Apify

📝 Changelog

Version 1.3.77

• ✅ Fixed data output issues - all results now properly saved
• ✅ Improved Dockerfile with modern npm commands
• ✅ Enhanced error handling and data persistence
• ✅ Better timeout recovery mechanisms

Version 1.3.76

• ✅ Fixed missing data in output
• ✅ Improved fallback data saving
• ✅ Enhanced logging for debugging

Version 1.3.75

• ✅ Added comprehensive README
• ✅ Added OUTPUT_SCHEMA.json
• ✅ Improved documentation

---

Ready to extract Google Maps data? Start using this Actor now and get comprehensive business information in minutes!

Keywords: Google Maps scraper, business data extraction, contact scraping, lead generation, Google Places API alternative, business intelligence, market research, email scraping, social media extraction, location data