Google Maps Scraper

Extract Google Maps business leads, emails, reviews, phone numbers, websites, ratings, coordinates, and more with a free open-source CLI, Web UI, REST API, and optional self-hosted platform.

Use it for lead generation, local business research, sales prospecting, data enrichment, or developer automation.

If this project is useful to you, a GitHub star helps others discover it. Sponsorships help fund maintenance and new work.

Sponsored By

This project is made possible by our amazing sponsors

NetNut – Limitless Web Data Collection

Built on a fully owned premium residential proxies network infrastructure powering enterprise-grade Website Unblocker, SERP APIs, LLM scraper, ecommerce data collection, and ready-to-use datasets.

Visit NetNut → | Learn more

Coreclaw - Full-stack web scraping and data extraction platform

Find ready-made workers for public websites, run them instantly, and get structured data you can export or connect anywhere. Get free test for $3 →

G Maps Extractor - No-code Google Maps scraper

Chrome extension that extracts emails, social profiles, phone numbers, reviews & more. Get 1,000 free leads →

Scrap.io - Extract ALL Google Maps listings at country-scale

No keywords needed. No limits. Export millions of businesses in 2 clicks. Try it free →

SerpApi - Google Maps API and 30+ search engine APIs

Fast, reliable, and scalable. Used by Fortune 500 companies. View all APIs →

SearchApi - Google Maps API for SERP scraping

Real-time Google Maps data with a simple integration. Explore the API →

Evomi - Swiss quality proxies for scraping

Swiss quality proxies from $0.49/GB across 150+ countries, with 24/7 support and 99.9% uptime. Visit Evomi →

HasData - No-code Google Maps Scraper & Email Extraction

Extract business leads, emails, addresses, phones, reviews and more. Get 1,000 free credits →

RapidProxy - High-Performance Proxy Solution

Unlock global access with consistent, high-speed connections from $0.65/GB, 90M+ real residential IPs worldwide, and traffic that never expires. Try it free →

TalorData - Fast SERP API for Google Maps and Search Data

Real-time SERP data APIs for Google Maps and search results, with structured JSON / HTML responses and 1,000 free API responses to start. Start using TalorData → | Learn more

Webshare - Premium proxies for scraping at scale

The most affordable premium proxies across 195 countries & 80+ million IPs, plus a FREE plan for new users. Learn more

BirdProxies - Residential and ISP proxies

Hey, we built BirdProxies because proxies shouldn't be complicated or overpriced. Fast residential and ISP proxies in 195+ locations, fair pricing, and real support. Try our FlappyBird game on the landing page for free data!

Visit BirdProxies → | Join Discord

Proxidize - Proxies for Google Maps Scraping

Mobile and residential proxies for Google Maps scraping, local SEO, lead generation, and data collection. Use code gmaps20 for 20% off. Visit Proxidize →

View all sponsors | Become a sponsor

Why Use This Scraper?

What's Next After Scraping?

Once you've collected your data, you'll need to manage, deduplicate, and work with your leads. LeadsDB is a companion tool designed exactly for this:

• Automatic Deduplication - Import from multiple scrapes without worrying about duplicates
• AI Agent Ready - Query and manage leads with natural language via MCP
• Advanced Filtering - Combine filters with AND/OR logic on any field
• Export Anywhere - CSV, JSON, or use the REST API

The scraper has built-in LeadsDB integration - just add your API key and leads flow directly into your database.

Start free with 500 leads

Table of Contents

• Quick Start
• Command Line
• Web UI
• REST API
• SaaS Edition
• AI Agent Skill
• Recipes
• Proxy Sponsors
• Installation
• Features
• Extracted Data Points
• Configuration
• Command Line Options
• Using Proxies
• Email Extraction
• Fast Mode
• Export to LeadsDB
• Advanced Usage
• PostgreSQL Database Provider
• Kubernetes Deployment
• Custom Writer Plugins
• Performance
• Support the Project
• Community
• Contributing
• License

Quick Start

Command Line

mkdir -p gmaps-output

docker run \
  -v gmaps-playwright-cache:/opt \
  -v "$PWD/example-queries.txt:/queries.txt:ro" \
  -v "$PWD/gmaps-output:/out" \
  gosom/google-maps-scraper \
  -input /queries.txt \
  -results /out/results.csv \
  -depth 1 \
  -exit-on-inactivity 3m

Useful options:

-c controls how many scrape jobs run in parallel. Higher concurrency can finish large input files faster, but it also uses more CPU/RAM and can increase blocking or failures, especially without proxies. Start with the default for a first run. For larger jobs on a capable machine, try -c 4, -c 8, or -c 16 and measure the result.

Want to skip CSV files? Send leads directly to LeadsDB:

docker run \
  -v gmaps-playwright-cache:/opt \
  -v "$PWD/example-queries.txt:/queries.txt:ro" \
  gosom/google-maps-scraper \
  -input /queries.txt \
  -depth 1 \
  -leadsdb-api-key "your-api-key" \
  -exit-on-inactivity 3m

Web UI

Start the web interface with a single command:

mkdir -p gmapsdata

docker run \
  -v "$PWD/gmapsdata:/gmapsdata" \
  -p 8080:8080 \
  gosom/google-maps-scraper \
  -data-folder /gmapsdata

Then open http://localhost:8080 in your browser.

Or download the binary release for your platform.

Note: Results take at least 3 minutes to appear (minimum configured runtime).

macOS Users: Docker command may not work. See MacOS Instructions.

REST API

When running the web server, a full REST API is available:

Full OpenAPI 3.0.3 document