Changelog
All notable changes to Google Maps Lead Extractor Pro will be documented in this file.
The format is based on Keep a Changelog ,
and this project adheres to Semantic Versioning .
[1.0.0] - 2025-10-31
Added
🎉 Initial release of Google Maps Lead Extractor Pro
✅ Multi-query search support for batch processing
✅ Comprehensive business data extraction:
Business name, category, rating, review count
Address, phone number, website
Operating hours and Plus Code
Geolocation coordinates (latitude/longitude)
✅ Review extraction with configurable limits
✅ Email discovery from business websites
✅ Social media profile extraction (Facebook, Instagram, LinkedIn, Twitter)
✅ Photo URL extraction
✅ Multi-language support (9 languages)
✅ Configurable concurrency for performance optimization
✅ Apify proxy integration for reliability
✅ Multiple export formats (JSON, CSV, Excel)
📚 Comprehensive documentation:
README with features and use cases
DEPLOYMENT guide for Apify platform
EXAMPLES with real-world use cases
Utility functions for data processing
🛠️ Utility functions:
Lead scoring algorithm
CRM formatting (Salesforce, HubSpot, Pipedrive)
Data deduplication
Filtering and sorting helpers
Summary statistics generation
🎯 Input schema with validation
🐳 Docker configuration for Apify deployment
📊 Dataset views for result visualization
Technical Details
Built with Apify SDK v3.0
Uses Playwright for browser automation
Crawlee v3.0 for web crawling
Node.js 18+ runtime
Modular architecture for easy maintenance
~50-100 businesses per minute (basic scraping)
~30-50 businesses per minute (with email extraction)
~20-30 businesses per minute (with reviews + emails)
Configurable concurrency (1-20 parallel browsers)
Known Limitations
Email extraction success depends on website accessibility
Some websites may block automated access
Google Maps may rate-limit requests without proxies
Review extraction limited to visible reviews on page
[Unreleased]
Planned Features
Advanced email validation and verification
Phone number formatting and validation
Sentiment analysis for reviews
Automatic lead scoring with ML
Integration with more CRMs (Zoho, Pipedrive API)
Webhook notifications for completed runs
Incremental updates (only scrape new/changed businesses)
Export to additional formats (XML, Parquet)
Business hours parsing and normalization
Duplicate detection across multiple runs
Custom field extraction via CSS selectors
API endpoint for real-time scraping
Dashboard for analytics and insights
Potential Improvements
Optimize memory usage for large datasets
Add retry logic for failed requests
Implement caching for visited websites
Add support for more social media platforms (TikTok, YouTube)
Improve address parsing for international addresses
Add geofencing for location-based filtering
Implement rate limiting controls
Add support for Google Maps categories
Create browser extension for easy configuration
Version History
Version Numbering
Major (X.0.0) : Breaking changes, major new featuresMinor (1.X.0) : New features, backward compatiblePatch (1.0.X) : Bug fixes, minor improvements
Release Schedule
Patch releases : As needed for bug fixesMinor releases : Monthly for new featuresMajor releases : Quarterly for significant updates
Migration Guides
Migrating to v1.0.0
This is the initial release, no migration needed.
Support
For issues, feature requests, or questions:
🐛 Bug Reports : Create an issue in Apify for this actor
💡 Feature Requests : Create an issue in Apify for this actor
Note : This changelog follows the Keep a Changelog format and uses Semantic Versioning .
