Google Maps Places Scraper (Fast Asynchronous & Scalable)

This Apify Actor extracts business listings and places from Google Maps with lightning speed. It bypasses Google Maps' limit of displaying a maximum of 120 places per search query by implementing a dynamic viewport coordinate grid search.

Using asynchronous python workers, concurrent HTTP requests, and strict target extraction logic, it guarantees you get the exact number of unique results requested (max_places) without getting blocked.

---

Key Features

• 🚀 Asynchronous Multi-Worker Engine: Powered by curl_cffi's AsyncSession (Chrome 136 impersonation), executing parallel, non-blocking requests to mimic natural browser behaviors.
• 📍 Viewport Grid Search: Generates an 8x8 search grid (up to 64 coordinate points) surrounding the resolved center coordinates, sorted by distance from the center. This expands the search scope dynamically to uncover hundreds of hidden listings.
• 🎯 Strict Target Count: The scraper dynamically consumes coordinate zones and continues scraping pages until your exact requested max_places limit is reached.
• 🛡️ Resilient Exit Protocol: The search only stops early if 15 consecutive requests return 0 new unique results, indicating the entire region has been thoroughly exhausted of places.
• 📊 Real Data Extraction (Fixed Rating/Reviews): Extracts exact reviews counts and ratings (corrected to work with Google Maps' updated list indices: item[37][1] for reviews and item[4][7] for ratings) without relying on expensive official API calls or paid add-ons.
• 🇺🇸 State Resolution: Automatically parses the address string using regular expressions to resolve two-letter state abbreviations dynamically.
• 🔒 In-Memory Deduplication: Maintains a running set of place IDs across all concurrent worker threads to guarantee that only unique records are added to your output dataset.

---

⬇️ Input Parameters

The Actor accepts three standard inputs defined in the schema:

Input Field	Type	Description	Default
term	String (Required)	The search term or category (e.g. plumber, dentist, pizza).	plumbing services
location	String (Required)	The city, state, or general area to search in (e.g. Miami, FL, Dallas, TX).	Miami, FL
max_places	Integer (Optional)	The maximum number of unique places to extract.	50

Input JSON Example

{
  "term": "plumber",
  "location": "New York",
  "max_places": 150
}

---

⬆️ Output Structure

The output is written directly to the default Apify Dataset. Each place is saved as an individual JSON object. When running in the Apify Cloud, the console automatically aggregates these into a single spreadsheet, table, or array for immediate viewing and download (CSV, Excel, JSON, XML).

Output Fields Extracted:

• name: Business name
• phone: Contact phone number
• address: Full address string
• website: Official website URL
• place_id: Google Place ID (for details mapping)
• cid: Google CID unique hash
• latitude / longitude: Exact geographic coordinates
• category: Primary business categories
• rating: Average review rating (e.g. 4.9)
• reviews: Total review count (e.g. 355)
• city: Search location query
• state: Dynamically resolved US state code (e.g. NY, FL)
• search_keyword: Query term used

Output JSON Example

{
  "name": "Miami 24/7 Plumbing - Miami Emergency Plumbers",
  "phone": "(305) 440-0878",
  "address": "Miami 24/7 Plumbing - Miami Emergency Plumbers, 1331 SW 32nd Ave #4, Miami, FL 33145",
  "website": "https://www.miami247plumbing.com/",
  "place_id": "ChIJVaTjegK32YgR2K0jdOLn3Ao",
  "cid": "0x88d9b7027ae3a455:0xadce7e27423add8",
  "latitude": 25.759981099999997,
  "longitude": -80.24667629999999,
  "category": [
    "Plumber"
  ],
  "reviews": 355,
  "rating": 4.9,
  "city": "Miami, FL",
  "state": "FL",
  "search_keyword": "plumber"
}

Good Luck and Start to Scrape the Google Map Packs!