Google Maps Scraper

The Google Maps Scraper is a fast, affordable, and powerful tool to extract detailed business information from Google Maps. Designed for both experienced developers and beginners, this tool helps you collect and structure local business data with ease.

---

Table of Contents

• Key Features
• How It Works
• Data Fields Returned
• Example Use Cases
• Integration & Automation
• Getting Started
• License

---

Key Features

• 🚀 Lightning-Fast Scraping:
  Fetch hundreds or even thousands of listings in minutes, Get 200 results for free in < 20 seconds.

• 🚫 No More 120-Result Limit: Get over the limitation of Google Maps of showing no more than 120 places per map.

• 💸 Cost-Effective:
  Enjoy a straightforward pricing model – approximately $3 per 1,000 results, with up to 1600 free results per month using Apify’s free credits.

• 📊 Comprehensive Data Extraction:
  Retrieve rich details for every listing including business name, address, coordinates, contact info, ratings, opening hours, and additional details like amenities and accessibility features.

• 🧑‍💻 User-Friendly:
  Perfect for beginners with an easy-to-use web interface, yet powerful enough for experienced developers needing advanced options.

• 🔌 Integration Ready:
  Easily integrate the scraper into your existing workflow via the Apify API, webhooks, and scheduled tasks.

---

How It Works

1. Input Your Search:
   Provide a keyword, category, or a location filter (e.g., "coffee shops in New York").

2. Run the Scraper:
   Start the actor on the Apify platform. The scraper navigates Google Maps, handles pagination and anti-scraping measures, and collects all the relevant business data (Upto 200 results per run).

3. Retrieve and Export Data:
   Once the run completes, the structured data is available for download in formats like JSON, CSV, Excel, HTML, or XML. Use this data directly in your applications or for further analysis.

---

Here’s your updated README.md section rewritten using the real JSON examples from your scraper. I cleaned up formatting, corrected inconsistencies, and ensured all fields use actual values from the JSON you provided:

---

📍 Example of a Scraped Data Result from New York

1{
2   "count": 20,
3   "query": "Restaurants in New York",
4   "results": [
5      {
6         "name": "Carmine's - Time Square",
7         "rank": 1,
8         "status": "Open",
9         "isClaimed": "Yes",
10         "rating": 4.5,
11         "photoCount": 18178,
12         "reviewCount": 17231,
13         "neighborhood": "Manhattan",
14         "street": "200 W 44th St",
15         "city": "New York",
16         "zip": "10036",
17         "state": "New York",
18         "country": "US",
19         "phone": "(212) 221-3800",
20         "phoneIsd": "+1 212-221-3800",
21         "website": "carminesnyc.com",
22         "priceRange": "$$",
23         "priceRangeText": "Moderately expensive",
24         "address": "200 W 44th St, New York, NY 10036",
25         "longitude": -73.986654,
26         "latitude": 40.757498,
27         "cid": "1155783591561813087",
28         "gid": "0x89c25854faa8d447:0x100a2b0d8c445c5f",
29         "placeId": "RxDxZ7qzJNbi7_UPuOvG4QM",
30         "providerId": "/g/1td59jdq",
31         "searchLocation": "New York",
32         "searchCategory": "Restaurants",
33         "categories": [
34            "Italian restaurant",
35            "Caterer",
36            "Delivery service",
37            "Family restaurant",
38            "Restaurant"
39         ],
40         "shortDescription": "Family-friendly Italian option",
41         "longDescription": "Relaxed, family-friendly restaurant serving a menu of homestyle Southern Italian meals.",
42         "openingHours": [
43            { "day": "Saturday", "hours": "11:30 AM-12 AM" },
44            { "day": "Sunday", "hours": "11:30 AM-11 PM" },
45            { "day": "Monday", "hours": "11:30 AM-11 PM" },
46            { "day": "Tuesday", "hours": "11:30 AM-11 PM" },
47            { "day": "Wednesday", "hours": "11:30 AM-11 PM" },
48            { "day": "Thursday", "hours": "11:30 AM-12 AM" },
49            { "day": "Friday", "hours": "11:30 AM-12 AM" }
50         ],
51         "additionalInfo": {
52            "info": {
53               "Accessibility": [
54                  "Wheelchair accessible restroom",
55                  "Wheelchair accessible seating",
56                  "Wheelchair accessible parking lot",
57                  "Wheelchair accessible entrance"
58               ],
59               "Amenities": ["Wi-Fi", "Restroom", "Bar onsite"],
60               "Atmosphere": ["Historic", "Romantic", "Cozy", "Casual", "Trendy"],
61               "Children": ["Good for kids", "High chairs", "Kids' menu"],
62               "Crowd": ["Family-friendly", "Transgender safespace", "Tourists", "LGBTQ+ friendly", "Groups"],
63               "Dining options": ["Lunch", "Catering", "Dessert", "Seating", "Dinner", "Brunch"],
64               "Highlights": ["Great dessert", "Great wine list", "Great coffee", "Great cocktails", "Fast service", "Great beer selection"],
65               "Offerings": ["Coffee", "Comfort food", "Wine", "Happy hour drinks", "Private dining room", "Food", "Alcohol", "Late-night food", "Cocktails", "Hard liquor", "Beer"],
66               "Parking": ["Paid street parking", "Parking", "Paid parking garage"],
67               "Payments": ["Debit cards", "Credit cards", "NFC mobile payments"],
68               "Planning": ["Usually a wait", "Lunch reservations recommended", "Dinner reservations recommended", "Reservations required", "Accepts reservations"],
69               "Popular for": ["Lunch", "Dinner"],
70               "Service options": ["Delivery", "Onsite services", "Takeout", "Dine-in", "Curbside pickup", "No-contact delivery", "Outdoor seating"]
71            }
72         },
73         "reservationWebsites": [
74            {
75               "website": "https://carminesnyc.com/bookings"
76            }
77         ],
78         "timestamp": "2025-04-05 13:13:13.002273",
79         "url": "https://www.google.com/maps?cid=1155783591561813087"
80      }
81   ]
82}

---

🧾 Data Fields Returned

This scraper collects a wide array of information per business. Below are key fields with example values based on real-world results:

1. Name & Categories

• Description: Business name and its associated categories.
• Example:

1"name": "Carmine's - Time Square",
2"categories": [
3  "Italian restaurant",
4  "Caterer",
5  "Delivery service",
6  "Family restaurant",
7  "Restaurant"
8]

2. Address

• Description: Full address as a string, along with structured location details.
• Example:

1"address": "200 W 44th St, New York, NY 10036",
2"street": "200 W 44th St",
3"city": "New York",
4"state": "New York",
5"zip": "10036",
6"country": "US",
7"neighborhood": "Manhattan"

3. Coordinates

• Description: Latitude and longitude for mapping.
• Example:

1"latitude": 40.757498,
2"longitude": -73.986654

4. Contact Info

• Description: Local and international phone formats and business website.
• Example:

1"phone": "(212) 221-3800",
2"phoneIsd": "+1 212-221-3800",
3"website": "carminesnyc.com"

5. Google Maps Links & Identifiers

• Description: Direct link to Google Maps, place IDs, and other identifiers.
• Example:

1"url": "https://www.google.com/maps?cid=1155783591561813087",
2"placeId": "RxDxZ7qzJNbi7_UPuOvG4QM",
3"cid": "1155783591561813087",
4"gid": "0x89c25854faa8d447:0x100a2b0d8c445c5f"

6. Ratings & Reviews

• Description: Average user rating and total number of reviews.
• Example:

1"rating": 4.5,
2"reviewCount": 17231

7. Opening Hours

• Description: Day-by-day business hours.
• Example:

1"openingHours": [
2  { "day": "Saturday", "hours": "11:30 AM-12 AM" },
3  { "day": "Sunday", "hours": "11:30 AM-11 PM" }
4]

8. Additional Info

• Description: Accessibility, amenities, crowd, service options, and more.
• Example:

1"additionalInfo": {
2  "info": {
3    "Accessibility": [
4      "Wheelchair accessible restroom",
5      "Wheelchair accessible seating"
6    ],
7    "Amenities": [
8      "Wi-Fi",
9      "Restroom"
10    ],
11    "Service options": [
12      "Takeout",
13      "Dine-in",
14      "Curbside pickup"
15    ]
16  }
17}

9. Price Range & Claimed Status

• Example:

1"priceRange": "$$",
2"priceRangeText": "Moderately expensive",
3"isClaimed": "Yes"

10. Reservation Links

• Description: Direct reservation or booking URLs if available.
• Example:

1"reservationWebsites": [
2  {
3    "website": "https://carminesnyc.com/bookings"
4  }
5]

Here’s a clean and professional README.md layout with proper headings, formatting, and consistent structure. It uses bullet points, bold labels, and spacing to enhance readability:

---

🚀 Example Use Cases

🔹 Lead Generation & Sales

Build targeted lists of local businesses (e.g., dentists in New York) for outreach and marketing campaigns.

🔹 Market Research

Analyze local business trends by scraping and comparing data across regions to understand market behavior.

🔹 Local Directories & Applications

Populate your app or website with fresh and accurate listings of businesses like restaurants, cafes, and retail shops.

🔹 Academic & Data Analysis

Gather geographic and commercial data for research on market density, accessibility, or urban development.

---

🔁 Integration & Automation

This scraper is designed to fit seamlessly into your existing workflow:

• 🔗 API Access
  Trigger the scraper programmatically using the Apify API with official client libraries (Node.js, Python, etc.).

• 📩 Webhooks
  Receive notifications once a run is complete and automate downstream processes.

• ⏱️ Scheduling
  Use Apify’s built-in scheduler to run scrapes automatically (e.g., daily, weekly).

• 📤 Data Export
  Export results in multiple formats: JSON, CSV, Excel, HTML, or XML.

---

🛠️ Getting Started

1. 📝 Sign Up
   Create a free account on Apify.

2. ▶️ Run the Actor
   Open the Google Maps Scraper actor, enter your search term and filters, then click Start.

3. 📁 Retrieve Data
   Once the run is complete, access your dataset and export it in your desired format.

4. 🔄 Integrate & Automate
   Leverage the API, webhooks, or scheduling features to plug this tool into your end-to-end process.

---