Google Maps Business Scraper with Email Extraction

Extracts complete business listings from Google Maps, including contact details, ratings, and operating hours. Optionally visits business websites to find and validate email addresses. Useful for lead generation, market research, and business intelligence.

Key Features

• Business Data: Extracts name, address, coordinates, phone number, website, Google Place ID, direct link, business category, star rating, review count, and detailed weekly hours.
• Email Discovery: Automatically visits business websites from the listings and extracts email addresses from the page content. Emails are validated and cleaned.
• Flexible Input: Search by queries (e.g., "Taipei coffee shops") or provide direct Google Maps URLs.
• Structured Output: Returns a consistent JSON object for each business, including the source query and a timestamp.

How to Use

Configure the actor with input parameters. You must provide either searchQueries or startUrls.

Basic Configuration

{
  "searchQueries": ["Taipei coffee shops"],
  "maxResults": 100,
  "language": "en",
  "scrapeEmails": true
}

Multiple Search Queries

{
  "searchQueries": [
    "Kaohsiung dental clinics",
    "Taichung Italian restaurants",
    "Taipei Xinyi District hotels"
  ],
  "maxResults": 100,
  "scrapeEmails": true
}

Using Direct Google Maps URLs

{
  "startUrls": [
    {"url": "https://www.google.com/maps/search/Taipei+coffee+shops"}
  ],
  "maxResults": 100,
  "scrapeEmails": true
}

Input Parameters

*You must provide either searchQueries or startUrls.

Language Options: "en" (English, default) or "zh-TW" (Traditional Chinese for Taiwan/Hong Kong).

Output Format

Each business is returned as a JSON object with the following structure:

{
  "name": "Blue Bottle Coffee",
  "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "latitude": 25.0330,
  "longitude": 121.5654,
  "rating": 4.4,
  "reviews": 1205,
  "address": "No. 7, Section 5, Xinyi Road, Xinyi District, Taipei City",
  "businessType": "Coffee shop",
  "phone": "+886 2 2345 6789",
  "website": "https://example.com",
  "email": "info@example.com",
  "emailList": ["info@example.com"],
  "hours": ["Monday: 07:00–19:00", "Tuesday: 07:00–19:00", ...],
  "url": "https://www.google.com/maps/place/...",
  "query": "Taipei coffee shops",
  "timestamp": "2025-11-03T10:30:00.000Z"
}

Performance & Best Practices

• Speed: ~6-10 seconds per business without email scraping; ~15-25 seconds with email scraping.
• Email Success Rate: Typically 20-40% of businesses have discoverable emails.
• Effective Queries: Be specific. Use formats like "[City/Area] [Business Type]" (e.g., "Taipei Xinyi District Italian restaurant"). Avoid overly broad terms like just "restaurant".
• Resource Management: Start with 50-100 results. Enable scrapeEmails only when contact info is needed. Use multiple specific queries instead of one broad query.

Limitations & Compliance

• Limitations: Only finds publicly listed emails. Some websites may have anti-scraping measures. Data is limited to what Google Maps search results provide.
• Compliance: This tool extracts publicly available information. You are responsible for complying with Google Maps Terms of Service, local data protection laws (GDPR, CCPA), and email marketing regulations (CAN-SPAM, GDPR). Use for legitimate business research, lead generation, or analysis. Do not use for spam, violating terms of service, or excessive crawling.

Disclaimer: This tool is for informational and research purposes only. Users are solely responsible for ensuring their use complies with all applicable laws and terms.