Google Maps Scraper

📍 What is Google Maps Scraper?

Google Maps Scraper turns public Google Maps pages into structured business data for lead generation, competitor tracking, local market research, and enrichment workflows. Enter search terms plus a location, choose the details you need, and export clean records without opening every place page by hand.

• Build qualified lead lists: collect business names, websites, public emails, phone numbers, and social profiles for sales outreach
• Track competitors by market: compare where competitors operate, how they are rated, and how much review activity they receive
• Analyze local demand: spot market saturation, service gaps, and high-visibility businesses by category, rating, and location
• Find partnership targets: identify top-rated or high-volume locations for outreach and collaboration
• Keep research repeatable: replace one-off manual searches with workflows that produce consistent, export-ready results.

Instead of stopping at one visible map screen, the scraper resolves your base location and chooses a collection strategy for the requested scope: paginated list search, country hotspot search, bounds/grid search, or a center-point fallback. This gives you broader but controlled coverage while keeping the search terms, enrichment switches, and output fields explicit.

What data does Google Maps Scraper extract?

For maximum usefulness, Google Maps Scraper focuses on data you can act on:

• Place and contact data: names, addresses, websites, phone numbers, ratings, review counts, categories, images, opening hours, menus, and popular times
• Location-aware search: scrape with search terms anchored to a city, state, postal code, region, or country
• Broader coverage when available: use resolved bounds, country hotspots, or paginated list search when the location and requested volume support it
• Export-ready structure: send results to spreadsheets, databases, CRMs, BI tools, or internal workflows in 8 export formats: CSV, JSON, JSONL, XLS, XLSX, HTML, XML, and RSS
• Optional enrichment: add website contacts, public emails, social profiles, reviews, place details, reservation data, online ordering, and web results only when you need them.

Why run it on CoreClaw?

• Ready-made Worker: start from a maintained Google Maps Worker instead of building and hosting your own scraper
• No code required: configure search terms, location, result volume, and enrichment options from the CoreClaw interface
• Pay for successful results: keep pricing tied to usable output rather than raw runtime
• API-friendly: run the scraper from the UI or CoreClaw REST API, then export structured data for downstream automation
• Controlled enrichment: turn heavier enrichment steps on only when the extra fields are worth the runtime.

⬇️ Input

Start with one or more search terms and a required base_location. You can then enable additional details such as reviews, website contact data, social profiles, amenities, reservation providers, online ordering, and web results. Set up the input in the CoreClaw interface or pass the same fields programmatically.

Search terms

Multiple similar search terms can uncover a few extra places, but they also make the run slower and may create more overlap. Use terms that are distinct or only lightly overlapping. A long list of duplicates usually increases runtime without adding many useful records.

Example of a good list of search terms: [dentist, orthodontist, oral surgeon, pediatric dentist, teeth whitening, emergency dentist]

Example of a bad list of search terms: [dentist, dentists, dental clinic, dental office, dentist near me, best dentist, local dentist]

Google Maps search results often include nearby categories. For example, dentist might also capture dental clinics or cosmetic dentistry providers, but you will usually get cleaner coverage by using clearly distinct terms separately.

In the CoreClaw interface, use the keyword string-list field for search terms. In lower-level runtime payloads, the active keyword may be passed as string.

Categories and field filtering

Search terms can sometimes include irrelevant places. Use category names as search terms when you need category-like targeting, such as cosmetic dentist, emergency dentist, or teeth whitening service.

The scraper returns Google Maps category fields such as primary_category, category_2, category_3, category_4, and all_categories. In the CoreClaw table view and exports, you can filter or select fields by business info, contact and outreach data, social media URLs, social profile enrichment, ratings and reviews, and business details.

For this reason, we recommend using fewer, clearer search terms first, then refining the exported results with the returned category and field groups.

Search without geolocation

The public input schema requires base_location, and we recommend using it for every run. Put the geography in base_location, not inside the keyword field.

Rather than searching only for a phrase like dentists in austin, use:

{
  "keyword": [{ "string": "dentist" }],
  "base_location": "Austin, Texas, USA"
}

Precise locations usually produce more stable results. Very broad or vague locations can return fewer rows than requested, less predictable ordering, or results concentrated around major cities.

Specific places or brand lists

If you already know the places or brands you want to research, use their names as search terms and provide the most precise base_location available. For example, combine a brand name with a city, state, or country to find matching Google Maps places and enrich the returned records with contact details, reviews, place attributes, social profiles, and other enabled fields.

Input fields

Example input

{
  "keyword": [
    { "string": "dentist" },
    { "string": "teeth whitening" }
  ],
  "base_location": "Austin, Texas, USA",
  "lang": "en",
  "max_results": 100,
  "fetch_social_info": true,
  "email_verification": true,
  "instagram": true,
  "facebook": true,
  "fetch_place_details": true,
  "fetch_reservation_data": true,
  "fetch_online_order": true,
  "fetch_web_result": true,
  "fetch_reviews": true,
  "max_reviews_per_place": 10,
  "review_sort_by": "newest",
  "include_reviewer_info": true
}

⬆️ Output

Every run returns a structured dataset that can be reviewed in a table, filtered by business workflow, or exported in 8 formats: CSV, JSON, JSONL, XLS, XLSX, HTML, XML, and RSS. Table view is best for checking, sorting, and filtering results before export. JSON and JSONL preserve nested fields such as reviews, attributes, reservation_data, web_results, and people_also_search; spreadsheet formats are better for CRM imports, lead review, and market analysis.

CoreClaw organizes output into focused field groups so you can work with the data by use case instead of reading every column at once. These views are subsets of the same run result, so you can start with a commercial summary view and still export the full JSON record when you need every field.

Reviews are stored in the reviews array. For easier table processing, the first three reviews are also expanded into fields such as reviews/0/name, reviews/0/rating, reviews/0/text, reviews/1/*, and reviews/2/*.

🧭 Business Info

Use this view to qualify places, map territory coverage, remove duplicates, and segment markets by category or location. It gives you the business identity, category stack, address, status, and map URL needed for local market analysis.

[
  {
    "title": "Example Dental Studio",
    "data_id": "0xexample001:0xbusiness001",
    "cid": "1000000000000000001",
    "primary_category": "Dentist",
    "category_2": "Cosmetic dentist",
    "category_3": "Emergency dental service",
    "category_4": "Teeth whitening service",
    "all_categories": "Dentist, Cosmetic dentist, Emergency dental service, Teeth whitening service",
    "status": "Open · Closes 5 PM",
    "description": "Family dental clinic in central Austin.",
    "thumbnail": "https://example.test/images/example-dental-studio.jpg",
    "url": "https://www.google.com/maps/place/example-dental-studio",
    "address": "100 Example Ave, Austin, TX 78701",
    "street": "100 Example Ave",
    "city": "Austin",
    "postal_code": "78701",
    "state": "Texas",
    "country": "US",
    "plus_code": "77X7+42 Austin, Texas"
  }
]

🏢 Contact & Outreach

Use this view to build outreach lists for sales, partnerships, and local business development. It keeps the fields most teams need first: website, phone, public email, and category context for personalization.

[
  {
    "title": "Example Dental Studio",
    "all_emails": "hello@example-dental.test",
    "website": "https://example-dental.test/",
    "all_categories": "Dentist, Cosmetic dentist, Emergency dental service, Teeth whitening service",
    "phone": "+1 512-555-0101"
  }
]

🔗 Social media

Use this view to find where each business is active online. Social URLs help marketing and sales teams verify brand presence, enrich CRM records, and choose the right outreach channel.

[
  {
    "title": "Example Dental Studio",
    "website": "https://example-dental.test/",
    "linkedin_url_1": "https://www.linkedin.com/company/example-dental-studio",
    "linkedin_url_2": "",
    "facebook_url_1": "https://www.facebook.com/exampledentalstudio",
    "facebook_url_2": "",
    "instagram_url_1": "https://www.instagram.com/exampledentalstudio/",
    "instagram_url_2": "",
    "twitter_url": "https://x.com/exampledental",
    "youtube_url_1": "https://www.youtube.com/@exampledentalstudio",
    "youtube_url_2": ""
  }
]

📱 Social profiles

Use this view when you need more than URLs. Enriched profile metrics such as followers, verification, company size, post counts, and business account status help prioritize accounts by reach and credibility.

[
  {
    "title": "Example Dental Studio",
    "website": "https://example-dental.test/",
    "linkedin_url_1": "https://www.linkedin.com/company/example-dental-studio",
    "linkedin_verified": true,
    "linkedin_company_name": "Example Dental Studio",
    "linkedin_industry": "Health, Wellness & Fitness",
    "linkedin_company_size": "11-50",
    "linkedin_followers_count": 840,
    "facebook_url_1": "https://www.facebook.com/exampledentalstudio",
    "facebook_verified": false,
    "facebook_username": "exampledentalstudio",
    "facebook_followers_count": 3200,
    "instagram_url_1": "https://www.instagram.com/exampledentalstudio/",
    "instagram_verified": false,
    "instagram_followers_count": 5400,
    "instagram_posts_count": 286,
    "instagram_is_business_account": true,
    "twitter_url": "https://x.com/exampledental",
    "youtube_url_1": "https://www.youtube.com/@exampledentalstudio",
    "youtube_subscribers_count": 1200,
    "tiktok_url_1": "https://www.tiktok.com/@exampledentalstudio",
    "tiktok_followers_count": 2500,
    "tiktok_videos_count": 64
  }
]

⭐ Ratings & Reviews

Use this view to benchmark reputation, spot strong or weak competitors, and identify businesses with recent customer activity. Rating distribution, popular times, review metadata, and review text can support local market research, lead scoring, and service-gap analysis.

[
  {
    "title": "Example Dental Studio",
    "review_rating": 4.8,
    "review_count": 214,
    "reviews_link": "https://search.google.com/local/reviews?placeid=example-dental-studio",
    "rating_1_count": "4",
    "rating_2_count": "2",
    "rating_3_count": "5",
    "rating_4_count": "21",
    "rating_5_count": "182",
    "popular_times_live_percent": 36,
    "popular_times_live_text": "Usually not too busy",
    "popular_times/peak_day": "Tuesday",
    "popular_times/peak_hour": 10,
    "popular_times/peak_value": 100,
    "reviews": [
      {
        "title": "Example Dental Studio",
        "rating": 5,
        "text": "Friendly team and clear explanations throughout the visit.",
        "published_at_date": "2026-06-10",
        "publish_at_time": "14:15:00",
        "likes_count": 2,
        "reviewer_name": "Example Reviewer",
        "reviewer_photo_count": "12",
        "reviewer_review_count": "8",
        "response_from_owner_date": "2026-06-11",
        "reviewer_profile_url": "https://www.google.com/maps/contrib/example-reviewer",
        "reviewer_profile_id": "100000000000000000001",
        "reviewer_avatar_url": "https://example.test/images/reviewer-avatar.jpg",
        "review_url": "https://www.google.com/maps/place/example-dental-studio?reviewId=example-review-001",
        "review_origin": "Google Maps",
        "review_image_urls": [],
        "images": null,
        "visited_in": "2 days ago"
      }
    ]
  }
]

🧾 Business details

Use this view to understand operating context: opening hours, booking or appointment links, owner data, images, nearby alternatives, and related places. It is useful for field sales planning, local SEO research, and partnership qualification.

[
  {
    "title": "Example Dental Studio",
    "opening_hours/0/day": "Monday",
    "opening_hours/0/hours": "8 AM-5 PM",
    "opening_hours/1/day": "Tuesday",
    "opening_hours/1/hours": "8 AM-5 PM",
    "opening_hours/2/day": "Wednesday",
    "opening_hours/2/hours": "8 AM-5 PM",
    "opening_hours/3/day": "Thursday",
    "opening_hours/3/hours": "8 AM-5 PM",
    "opening_hours/4/day": "Friday",
    "opening_hours/4/hours": "8 AM-3 PM",
    "opening_hours/5/day": "Saturday",
    "opening_hours/5/hours": "Closed",
    "opening_hours/6/day": "Sunday",
    "opening_hours/6/hours": "Closed",
    "images_count": 6,
    "reservations/0/source": "example-dental.test",
    "reservations/0/link": "https://example-dental.test/appointments",
    "order_online_platform": "",
    "order_online_url": "",
    "menu_link": "",
    "menu_source": "",
    "online_order_available": false,
    "reservation_data": "",
    "online_order_methods": "",
    "owner_id": "100000000000000000002",
    "owner_name": "Example Dental Studio (Owner)",
    "owner_link": "https://www.google.com/maps/contrib/example-owner",
    "people_also_search": [
      { "title": "North Austin Dental Group", "review_count": 185, "total_score": 4.7 },
      { "title": "River City Orthodontics", "review_count": 96, "total_score": 4.9 }
    ]
  }
]

🧩 Full JSON record

Use the full JSON record when you need every field from a run, including nested arrays and raw detail fields. The example below shows the shape of a single scraped dental office in Austin with email_verification enabled. Email verification status values are valid, invalid, disposable, catch_all, unknown, verification failed, and not_checked; empty email slots return empty strings for the matching status and business-email fields.

[
  {
    "source_keyword": "dentist",
    "source_location": "Austin, Texas, USA",
    "search_query": "dentist Austin, Texas, USA",
    "scraped_at": "2026-05-28 00:00:00",
    "search_rank": 1,
    "title": "Example Dental Studio",
    "data_id": "0x123:0x456",
    "cid": "1234567890",
    "address": "100 Example Ave, Austin, TX 78701, USA",
    "street": "100 Example Ave",
    "city": "Austin",
    "postal_code": "78701",
    "state": "Texas",
    "country": "United States",
    "primary_category": "Dentist",
    "all_categories": "Dentist, Cosmetic dentist, Teeth whitening service",
    "latitude": 30.2672,
    "longitude": -97.7431,
    "website": "https://example-dental.test/",
    "all_emails": "hello@example-dental.test",
    "email_1": "hello@example-dental.test",
    "email_1_status": "valid",
    "email_1_is_business_email": true,
    "email_2": "",
    "email_2_status": "",
    "email_2_is_business_email": "",
    "email_3": "",
    "email_3_status": "",
    "email_3_is_business_email": "",
    "email_4": "",
    "email_4_status": "",
    "email_4_is_business_email": "",
    "facebook_url_1": "https://www.facebook.com/exampledentalstudio",
    "facebook_followers_count": 12000,
    "instagram_url_1": "https://www.instagram.com/exampledentalstudio/",
    "instagram_followers_count": "34500",
    "phone": "+1 512-555-0101",
    "plus_code": "77X7+42 Austin, Texas",
    "review_rating": 4.6,
    "review_count": "842",
    "rating_5_count": "612",
    "rating_4_count": "140",
    "reviews_link": "https://search.google.com/local/reviews?placeid=example",
    "reviews": [
      {
        "title": "Example Dental Studio",
        "rating": 5,
        "text": "Friendly team and clear explanations throughout the visit.",
        "published_at_date": "2026-05-22",
        "publish_at_time": "18:29:53",
        "likes_count": 2,
        "reviewer_name": "Example Reviewer",
        "reviewer_profile_url": "https://www.google.com/maps/contrib/105978294072623409799",
        "reviewer_profile_id": "105978294072623409799",
        "reviewer_avatar_url": "https://lh3.googleusercontent.com/example=s120",
        "review_url": "https://www.google.com/maps/place/example-dental-studio?reviewId=example-review-001",
        "review_origin": "Google Maps",
        "review_image_urls": [],
        "images": null,
        "visited_in": "a week ago"
      }
    ],
    "reviews/0/name": "Example Reviewer",
    "reviews/0/rating": 5,
    "reviews/0/text": "Friendly team and clear explanations throughout the visit.",
    "status": "Open now",
    "description": "Family dental clinic in central Austin.",
    "timezone": "America/Chicago",
    "price_range": "$$",
    "price_range/min": null,
    "price_range/max": null,
    "price_range/currency": "$",
    "opening_hours/0/day": "Monday",
    "opening_hours/0/hours": "8 AM-5 PM",
    "open_now": true,
    "popular_times_live_percent": 42,
    "popular_times_live_text": "Usually not too busy",
    "popular_times/peak_day": "Saturday",
    "popular_times/peak_hour": 18,
    "popular_times/peak_value": 100,
    "images_count": 2,
    "images/0/title": "Storefront",
    "images/0/image": "https://lh3.googleusercontent.com/place-image-1",
    "menu_link": "",
    "reservation_data": {
      "reservation_available": true,
      "reservation_provider_count": 2,
      "reservation_provider_names": ["Resy", "OpenTable"],
      "reservation_provider_urls": ["https://example.test/resy", "https://example.test/opentable"]
    },
    "online_order_available": true,
    "online_order_methods": "Delivery, Pickup",
    "attributes": [
      {
        "name": "Service options",
        "options": [
          { "name": "Delivery", "enabled": true },
          { "name": "Takeaway", "enabled": true },
          { "name": "Dine-in", "enabled": true }
        ]
      }
    ],
    "web_results": [
      {
        "title": "Example Dental Studio - Official Website",
        "url": "https://example-dental.test/",
        "displayed_url": "example-dental.test",
        "description": "Official website and merchant information for Example Dental Studio."
      }
    ],
    "owner_id": "1122334455",
    "owner_name": "Example Dental Studio",
    "owner_link": "https://www.google.com/maps/contrib/1122334455",
    "people_also_search": [
      { "title": "North Austin Dental Group", "review_count": 185, "total_score": 4.7 }
    ],
    "url": "https://www.google.com/maps/place/example"
  }
]

📍📌 Using geolocation for pinpoint accuracy

Location, country, state, county, city, and postal code

Entering a country or region in the Base Location field is usually sufficient to start scraping. For more precise targeting, you can use a city + country or state + country.

Google Maps Scraper resolves locations into coordinates and bounds when available. For country-only searches, it can use configured hotspot cities to improve national coverage. For larger requests where bounds are available, the scraper can use a grid search strategy to cover the area more thoroughly.

Recommended examples:

• New York, USA
• Los Angeles, California, USA
• Berlin, Germany
• United Kingdom

How high-volume searches are handled

The scraper chooses its collection strategy based on the resolved location and requested result count:

• Paginated list search: used for ordinary city or point searches
• Country hotspot search: used for country-level locations when hotspot data is available
• Bounds/grid search: used for larger result requests when bounds are available
• Approximate center bounds: used as a fallback when a center point is available but explicit bounds are not

Very broad locations and very high max_results values take longer and may still return fewer rows than requested if Google Maps exposes fewer matching places for the query.

❤️ FAQ

How does Google Maps Scraper work?

Google Maps Scraper works in a similar way to manually opening Google Maps, entering a location and search keyword, then viewing and copying business information one by one. The difference is that the script automates the entire process, making it much faster and more suitable for large-scale data collection.

When the script runs, it first uses the base_location you provide to locate the specified country, city, or region. It then enters your search keyword into the Google Maps search bar. After that, the script continuously scrolls through the search results until it reaches the end of the results, the system crawling limit, or the number set in Max Results.

During the scraping process, each place is processed as a separate result. The script collects visible business information from each place page, such as business name, address, phone number, website, rating, review count, opening hours, category, coordinates, images, social media links, and emails. The collected data is then organized into structured results, making it easy to download, filter, analyze, or use for lead generation.

To better understand the process, you can open Google Maps in your browser and search using the same location and keyword. The script performs almost the same actions, but it automates the repetitive steps and completes them much faster.

What are the disadvantages of the Google Maps API?

The official Google Places API is useful for application features that need supported Google APIs. For bulk market research, local lead generation, and review analysis, it can be restrictive because pricing, quotas, and result pagination are tied to API product limits. A scraper can provide a more flexible collection of public Google Maps page data, but you should still evaluate Google's Terms of Use for your use case.

Can I scrape places from multiple locations?

The public input schema accepts one base_location per active run. To collect multiple locations, start separate runs or create a CoreClaw workflow that executes the scraper for each location and merges the exports downstream.

How can I increase the speed of the scraper?

Use a precise base_location, reduce max_results, keep fetch_reviews disabled unless you need reviews, lower max_reviews_per_place, and enable website, social, or place-detail enrichment only when those fields are required.

Can I use Google Maps Scraper to extract Google reviews?

Yes. Enable fetch_reviews, then set max_reviews_per_place, review_sort_by, review_keyword, and include_reviewer_info as needed.

How can I get one review per row in the output?

The scraper returns reviews as a nested reviews array and also flattens the first three reviews into reviews/0/*, reviews/1/*, and reviews/2/* fields. If you need every review as a separate row, export JSON and transform the reviews array in your downstream processing.

Can I integrate Google Maps Scraper with other apps?

Yes. Export data from CoreClaw in CSV, JSON, JSONL, XLS, XLSX, HTML, XML, or RSS, then import it into spreadsheets, databases, CRMs, BI tools, or automation workflows. You can also use the CoreClaw REST API, MCP server, n8n node, or your own automation layer to start scraper runs, check run status, retrieve paginated results, or export results in the format your workflow expects.

Can I use Google Maps Scraper as its own API?

Yes. You can use the CoreClaw REST API to run Google Maps Scraper programmatically. CoreClaw API requests use the api-key header and the base URL https://openapi.coreclaw.com.

A typical API workflow is:

1. Get the scraper details from /api/scraper and use the returned version and custom parameter schema.
2. Start a run with /api/v1/scraper/run, passing scraper_slug, version, is_async, and the scraper input under input.parameters.custom.
3. Save the returned run_slug.
4. Check run status with /api/v1/run/detail.
5. Fetch results with /api/v1/run/result/list, or export a file with /api/v1/run/result/export.

Is it legal to scrape Google Maps data?

Many web scraping use cases involve publicly available data, but legality depends on the data, jurisdiction, purpose, and how you process personal information. Respect personal data and intellectual property rules, scrape only when you have a legitimate reason to do so, and review Google's Terms of Use for your use case.

Your feedback

We're always working on improving the performance and coverage of this scraper. If you find a bug or notice missing fields, share the input settings, enabled enrichment options, approximate run time, and a small output sample so the behavior can be reproduced.