Google Maps Scraper

🚀 Extract Business Data, Contact Info, Ratings & Reviews from Google Maps

✨ Key Features

• 📊 Complete Business Data: Extract names, addresses, phone numbers, websites, ratings, and reviews
• 🔄 Duplicate Filtering: Intelligent duplicate detection for unique results only
• 🌐 Proxy & Session Management: Built-in proxy rotation and session management
• ⚡ High Performance: Optimized with Playwright and Crawlee for reliable scraping
• 💾 Structured Output: Clean, normalized data in JSON format with metadata
• 🎯 Lead Generation: Perfect for sales leads and business intelligence

🆕 What's New - Individual Page Scraping

The improved version (v2.1) introduces Individual Business Page Scraping for maximum data accuracy:

Enhanced Features in Improved Version

• 📍 Individual Page Scraping: Each business page is visited directly for complete data extraction
• 📞 Phone Numbers: Accurate phone extraction from individual business pages
• 🏠 Full Addresses: Complete address information including street, city, state, and ZIP
• 🌐 Website URLs: Direct business websites extracted from Google Maps pages
• ⏰ Business Hours: Operating hours when available
• 🏷️ Business Categories: Exact category classifications

New Usage Commands

# Run improved version
npm run start:improved

# Development mode with debug output
npm run start:dev:improved

# Run test with improved version
npm run test:improved

Input Configuration for Improved Version

{
  "searchQuery": "restaurants in austin",
  "maxResults": 25,
  "headless": false,
  "timeout": 180,
  "useApifyProxy": true,
  "proxyGroups": ["RESIDENTIAL"]
}

🚀 Quick Start

On Apify Platform

1. Visit the Actor: Go to the Google Maps Scraper on Apify Store
2. Configure Input: Set your search query and desired parameters
3. Run the Actor: Click "Start" and wait for results
4. Download Data: Export your data in preferred format

Input Configuration

Parameter	Type	Description	Default
searchQuery	String	Search term (e.g., "restaurants in New York")	"coffee shops san francisco"
maxResults	Integer	Maximum number of unique listings to scrape	50
headless	Boolean	Run browser in headless mode	true
timeout	Integer	Maximum execution time in seconds	120
proxyConfiguration	Object	Proxy configuration settings	Residential proxies

Example Input

{
  "searchQuery": "coffee shops new york",
  "maxResults": 100,
  "headless": true,
  "timeout": 180
}

📊 Output Data Structure

The actor returns structured business data with comprehensive metadata:

{
  "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "storeName": "Blue Bottle Coffee",
  "address": "450 Lexington Ave, New York, NY 10017",
  "phone": "212-555-0123",
  "googleUrl": "https://maps.google.com/place/...",
  "website": "https://bluebottlecoffee.com",
  "stars": 4.5,
  "numberOfReviews": 247,
  "ratingText": "4.5 stars 247 Reviews",
  "searchQuery": "coffee shops new york",
  "scrapedAt": "2025-09-09T10:30:00.000Z",
  "sourceUrl": "https://maps.google.com/search/...",
  "sessionId": "session_abc123",
  "proxyInfo": {
    "hostname": "proxy.apify.com",
    "port": 8000
  }
}

🎯 Use Cases

Lead Generation & Sales

• Extract potential clients for targeted outreach
• Build comprehensive business directories
• Identify new market opportunities

Market Research & Analysis

• Competitor location mapping
• Pricing and service analysis
• Market saturation studies

Local SEO & Digital Marketing

• Business directory data collection
• Review monitoring and sentiment analysis
• Local search presence tracking

Data Analytics

• Geographic distribution analysis
• Customer review trends
• Business category analysis

⚙️ Configuration Options

Proxy Configuration

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Session Management

{
  "sessionPoolOptions": {
    "maxPoolSize": 10,
    "sessionOptions": {
      "maxUsageCount": 15,
      "maxAgeSecs": 1800
    }
  }
}

📋 Best Practices

For Optimal Results

1. Use Residential Proxies: Better success rates with Google's anti-bot measures
2. Reasonable Timeouts: Set 120-180 seconds for reliable page loading
3. Rate Limiting: Respect Google's terms with appropriate delays

Data Quality

• Results are automatically deduplicated
• Data is cleaned and normalized for consistency
• Failed requests are automatically retried with session rotation

⚠️ Legal & Compliance

Important Considerations

• This tool only scrapes publicly available business information
• Users must comply with Google's Terms of Service
• Respect rate limits and avoid aggressive scraping
• Comply with local data protection regulations (GDPR, CCPA, etc.)
• Use data responsibly and ethically

Recommended Usage

• Market research and analysis
• Lead generation for legitimate business purposes
• Academic research projects
• Competitive analysis (within legal boundaries)

📞 Support & Resources

• Documentation: Apify Documentation
• Community: Apify Discord Community
• Issues: GitHub Issues
• Updates: Check CHANGELOG.md for latest updates

🔄 Version Information

• Current Version: 2.0.0
• Last Updated: September 2025
• Compatibility: Node.js 18+, Apify Platform

---

Disclaimer: This tool is intended for legitimate business, research, and educational purposes. Users are responsible for complying with all applicable laws, regulations, and terms of service. Always respect website terms and scrape responsibly.