A powerful, free, and open-source Google Maps scraper for extracting business data at scale. Available as CLI, Web UI, REST API, or deployable to Kubernetes/AWS Lambda.
Love this project? A star helps others discover it and motivates continued development. Become a sponsor to directly support new features and maintenance.
This project is made possible by our amazing sponsors
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 →
G Maps Extractor - No-code Google Maps scraper
Chrome extension that extracts emails, social profiles, phone numbers, reviews & more. Get 1,000 free leads →
SerpApi - Google Maps API and 30+ search engine APIs
Fast, reliable, and scalable. Used by Fortune 500 companies. View all APIs →
Decodo - Premium residential proxies with #1 response time
125M+ IPs · 195+ locations · No CAPTCHAs · No IP bans. Start 3-day free trial → | Integration guide
View all sponsors | Become a sponsor
| Completely Free & Open Source | MIT licensed, no hidden costs or usage limits |
| Multiple Interfaces | CLI, Web UI, REST API - use what fits your workflow |
| High Performance | ~120 places/minute with optimized concurrency |
| 33+ Data Points | Business details, reviews, emails, coordinates, and more |
| Production Ready | Scale from a single machine to Kubernetes clusters |
| Flexible Output | CSV, JSON, PostgreSQL, S3, LeadsDB, or custom plugins |
| Proxy Support | Built-in SOCKS5/HTTP/HTTPS proxy rotation |
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.
- Quick Start
- Installation
- Features
- Extracted Data Points
- Configuration
- Advanced Usage
- Performance
- Support the Project
- Sponsors
- Community
- Contributing
- License
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 /gmapsdataThen 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.
touch results.csv && docker run \
-v $PWD/example-queries.txt:/example-queries \
-v $PWD/results.csv:/results.csv \
gosom/google-maps-scraper \
-depth 1 \
-input /example-queries \
-results /results.csv \
-exit-on-inactivity 3mWant emails? Add the -email flag.
Want all reviews (up to ~300)? Add --extra-reviews and use -json output.
When running the web server, a full REST API is available:
| Endpoint | Method | Description |
|---|---|---|
/api/v1/jobs |
POST | Create a new scraping job |
/api/v1/jobs |
GET | List all jobs |
/api/v1/jobs/{id} |
GET | Get job details |
/api/v1/jobs/{id} |
DELETE | Delete a job |
/api/v1/jobs/{id}/download |
GET | Download results as CSV |
Full OpenAPI 3.0.3 documentation available at http://localhost:8080/api/docs
docker pull gosom/google-maps-scraperRequirements: Go 1.25.5+
git clone https://github.com/gosom/google-maps-scraper.git
cd google-maps-scraper
go mod download
go build
./google-maps-scraper -input example-queries.txt -results results.csv -exit-on-inactivity 3mFirst run downloads required Playwright browser libraries.
| Feature | Description |
|---|---|
| 33+ Data Points | Business name, address, phone, website, reviews, coordinates, and more |
| Email Extraction | Optional crawling of business websites for email addresses |
| Multiple Output Formats | CSV, JSON, PostgreSQL, S3, LeadsDB, or custom plugins |
| Proxy Support | SOCKS5, HTTP, HTTPS with authentication |
| Scalable Architecture | Single machine to Kubernetes cluster |
| REST API | Programmatic control for automation |
| Web UI | User-friendly browser interface |
| Fast Mode (Beta) | Quick extraction of up to 21 results per query |
| AWS Lambda | Serverless execution support (experimental) |
Click to expand all 33 data points
| # | Field | Description |
|---|---|---|
| 1 | input_id |
Internal identifier for the input query |
| 2 | link |
Direct URL to the Google Maps listing |
| 3 | title |
Business name |
| 4 | category |
Business type (e.g., Restaurant, Hotel) |
| 5 | address |
Street address |
| 6 | open_hours |
Operating hours |
| 7 | popular_times |
Visitor traffic patterns |
| 8 | website |
Official business website |
| 9 | phone |
Contact phone number |
| 10 | plus_code |
Location shortcode |
| 11 | review_count |
Total number of reviews |
| 12 | review_rating |
Average star rating |
| 13 | reviews_per_rating |
Breakdown by star rating |
| 14 | latitude |
GPS latitude |
| 15 | longitude |
GPS longitude |
| 16 | cid |
Google's unique Customer ID |
| 17 | status |
Business status (open/closed/temporary) |
| 18 | descriptions |
Business description |
| 19 | reviews_link |
Direct link to reviews |
| 20 | thumbnail |
Thumbnail image URL |
| 21 | timezone |
Business timezone |
| 22 | price_range |
Price level ( |
| 23 | data_id |
Internal Google Maps identifier |
| 24 | images |
Associated image URLs |
| 25 | reservations |
Reservation booking link |
| 26 | order_online |
Online ordering link |
| 27 | menu |
Menu link |
| 28 | owner |
Owner-claimed status |
| 29 | complete_address |
Full formatted address |
| 30 | about |
Additional business info |
| 31 | user_reviews |
Customer reviews (text, rating, timestamp) |
| 32 | emails |
Extracted email addresses (requires -email flag) |
| 33 | user_reviews_extended |
Extended reviews up to ~300 (requires -extra-reviews) |
Custom Input IDs: Define your own IDs in the input file:
Matsuhisa Athens #!#MyCustomID
Usage: google-maps-scraper [options]
Core Options:
-input string Path to input file with queries (one per line)
-results string Output file path (default: stdout)
-json Output JSON instead of CSV
-depth int Max scroll depth in results (default: 10)
-c int Concurrency level (default: half of CPU cores)
Email & Reviews:
-email Extract emails from business websites
-extra-reviews Collect extended reviews (up to ~300)
Location Settings:
-lang string Language code, e.g., 'de' for German (default: "en")
-geo string Coordinates for search, e.g., '37.7749,-122.4194'
-zoom int Zoom level 0-21 (default: 15)
-radius float Search radius in meters (default: 10000)
Web Server:
-web Run web server mode
-addr string Server address (default: ":8080")
-data-folder Data folder for web runner (default: "webdata")
Database:
-dsn string PostgreSQL connection string
-produce Produce seed jobs only (requires -dsn)
Proxy:
-proxies string Comma-separated proxy list
Format: protocol://user:pass@host:port
Export:
-leadsdb-api-key Export directly to LeadsDB (get key at getleadsdb.com)
Advanced:
-exit-on-inactivity duration Exit after inactivity (e.g., '5m')
-fast-mode Quick mode with reduced data
-debug Show browser window
-writer string Custom writer plugin (format: 'dir:pluginName')
Run ./google-maps-scraper -h for the complete list.
For larger scraping jobs, proxies help avoid rate limiting. Here's how to configure them:
./google-maps-scraper \
-input queries.txt \
-results results.csv \
-proxies 'socks5://user:pass@host:port,http://host2:port2' \
-depth 1 -c 2Supported protocols: socks5, socks5h, http, https
If you need reliable proxies, these providers support this project as sponsors:
| Provider | Highlight | Offer |
|---|---|---|
| Decodo | #1 response time, 125M+ IPs | 3-day free trial |
| Evomi | Swiss quality, 150+ countries | From $0.49/GB |
Using their services helps fund continued development of this scraper. See the Decodo integration guide for setup instructions.
Email extraction is disabled by default. When enabled, the scraper visits each business website to find email addresses.
./google-maps-scraper -input queries.txt -results results.csv -emailNote: Email extraction increases processing time significantly.
Fast mode returns up to 21 results per query, ordered by distance. Useful for quick data collection with basic fields.
./google-maps-scraper \
-input queries.txt \
-results results.csv \
-fast-mode \
-zoom 15 \
-radius 5000 \
-geo '37.7749,-122.4194'Warning: Fast mode is in Beta. You may experience blocking.
For distributed scraping across multiple machines:
1. Start PostgreSQL:
docker-compose -f docker-compose.dev.yaml up -d2. Seed the jobs:
./google-maps-scraper \
-dsn "postgres://postgres:postgres@localhost:5432/postgres" \
-produce \
-input example-queries.txt \
-lang en3. Run scrapers (on multiple machines):
./google-maps-scraper \
-c 2 \
-depth 1 \
-dsn "postgres://postgres:postgres@localhost:5432/postgres"apiVersion: apps/v1
kind: Deployment
metadata:
name: google-maps-scraper
spec:
replicas: 3 # Adjust based on needs
selector:
matchLabels:
app: google-maps-scraper
template:
metadata:
labels:
app: google-maps-scraper
spec:
containers:
- name: google-maps-scraper
image: gosom/google-maps-scraper:latest
args: ["-c", "1", "-depth", "10", "-dsn", "postgres://user:pass@host:5432/db"]
resources:
requests:
memory: "512Mi"
cpu: "500m"Note: The headless browser requires significant CPU/memory resources.
Create custom output handlers using Go plugins:
1. Write the plugin (see examples/plugins/example_writer.go)
2. Build:
go build -buildmode=plugin -tags=plugin -o myplugin.so myplugin.go3. Run:
./google-maps-scraper -writer ~/plugins:MyWriter -input queries.txtSkip the CSV files and send leads directly to a managed database. LeadsDB handles deduplication, filtering, and provides an API for your applications.
./google-maps-scraper \
-input queries.txt \
-leadsdb-api-key "your-api-key" \
-exit-on-inactivity 3mOr via environment variable:
export LEADSDB_API_KEY="your-api-key"
./google-maps-scraper -input queries.txt -exit-on-inactivity 3mField Mapping
| Google Maps | LeadsDB |
|---|---|
| Title | Name |
| Category | Category |
| Categories | Tags |
| Phone | Phone |
| Website | Website |
| Address | Address, City, State, Country, PostalCode |
| Latitude/Longitude | Coordinates |
| Review Rating | Rating |
| Review Count | ReviewCount |
| Emails | |
| Thumbnail | LogoURL |
| CID | SourceID |
Additional fields (Google Maps link, plus code, price range, etc.) are stored as custom attributes.
Get your API key at getleadsdb.com/settings after signing up.
Expected throughput: ~120 places/minute (with -c 8 -depth 1)
| Keywords | Results/Keyword | Total Jobs | Estimated Time |
|---|---|---|---|
| 100 | 16 | 1,600 | ~13 minutes |
| 1,000 | 16 | 16,000 | ~2.5 hours |
| 10,000 | 16 | 160,000 | ~22 hours |
For large-scale scraping, use the PostgreSQL provider with Kubernetes.
Anonymous usage statistics are collected for improvement purposes. Opt out:
export DISABLE_TELEMETRY=1This project is free and open source, maintained in my spare time. If it's useful to you, here's how you can help it grow:
| Action | Impact |
|---|---|
| Star this repo | Helps others discover the project |
| Sponsor on GitHub | Directly funds development time |
| Share your success | Tweet or blog about how you use it |
| Report bugs & contribute | Help improve the codebase |
When you need proxies, APIs, or cloud services, consider using our sponsors. You get quality tools, and the referral helps fund this project:
- Need proxies? Decodo or Evomi
- Prefer an API? SerpApi or SearchAPI
- No-code solution? Scrap.io or G Maps Extractor
- Cloud hosting? DigitalOcean ($200 credit) or Hetzner (EUR 20 credit)
A huge thank you to the sponsors who make this project possible!
Extract ALL Google Maps listings at country-scale in 2 clicks. No keywords needed. No limits. Export millions of businesses instantly.
No-code Google Maps scraper Chrome extension. Extract emails, social profiles, phone numbers, reviews, images & more with one click.
Get 1,000 free leads → · API docs
Google Maps API and 30+ search engine APIs. Fast, reliable, and scalable. Used by Fortune 500 companies.
Premium residential proxies with #1 response time. 125M+ IPs · 195+ locations · No CAPTCHAs · No IP bans
Start 3-day free trial → · Integration guide
|
Swiss quality proxies from $0.49/GB |
Google Maps API for easy SERP scraping |
Become a sponsor to get your logo here and support open source development.
Join our Discord to:
- Get help with setup and configuration
- Share your use cases and success stories
- Request features and report bugs
- Connect with other users
Contributions are welcome! Please:
- Open an issue to discuss your idea
- Fork the repository
- Create a pull request
See AGENTS.md for development guidelines.
- How to Extract Data from Google Maps Using Golang
- Distributed Google Maps Scraping
- scrapemate - The underlying web crawling framework
- omkarcloud/google-maps-scraper - Inspiration for JS data extraction
This project is licensed under the MIT License.
Please use this scraper responsibly and in accordance with applicable laws and regulations. Unauthorized scraping may violate terms of service.
Banner generated using OpenAI's DALL-E
If this project saved you time, consider starring it or sponsoring its development!