GMapsScraper - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #react #go #linux #docker #nodejs #macos #awesome #vue #pytorch #security #ios #openai

GMapsScraper

(★ 68)

Fast multi-threaded Google Maps scraper in Python — extract leads, emails, phones, websites, ratings & reviews to CSV/Excel/JSON. No API key.

File Explorer

Download Latest Version (.zip)

- finger_print_defender.crx
- additional_scrape.png
- sponsor.jpg
- ss_google_maps.png
- google_maps_scraper.py
- output_files_formats.py
- pprints.py
- random_users.py
- threading_controller.py
- web_site_scraper.py
.gitignore
commandline.txt
LICENSE
maps.py
queries.txt
README.md
requirements.txt

# Installation Guide

1. Get the code

git clone https://github.com/Anonym0usWork1221/GMapsScraper

Downloads the entire project code from GitHub to your computer.

cd GMapsScraper

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install -r requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">

<a href="https://www.coreclaw.com/?utm_source=github&utm_medium=referral&utm_campaign=Anony&utm_term=&utm_id=Anony">
  <img src="README_ASSETS/sponsor.jpg" alt="CoreClaw — Turn Google Maps Data Into Real Business Leads" width="100%" />
</a>

<h2>🚀 Sponsored by <a href="https://www.coreclaw.com/?utm_source=github&utm_medium=referral&utm_campaign=Anony&utm_term=&utm_id=Anony">CoreClaw</a></h2>

<p><strong>Turn Google Maps Data Into Real Business Leads</strong><br/>
Find websites, emails, and business contacts from Google Maps — in minutes, not hours.</p>

<a href="https://www.coreclaw.com/?utm_source=github&utm_medium=referral&utm_campaign=Anony&utm_term=&utm_id=Anony">
  <img src="https://img.shields.io/badge/Get%201%2C000%20Free%20Leads%20%E2%86%92-2563EB?style=for-the-badge&labelColor=0B1F4D" alt="Get 1,000 free leads" />
</a>

<br/>
<sub>Sponsored placement · CoreClaw is an independent product</sub>

</div>

<hr/>

# GMapsScraper — Google Maps Scraper in Python 🗺️

<p align="center">
  <a href="https://github.com/Anonym0usWork1221/GMapsScraper/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/Anonym0usWork1221/GMapsScraper?style=flat-square&color=2563EB"></a>
  <a href="https://github.com/Anonym0usWork1221/GMapsScraper/network/members"><img alt="GitHub forks" src="https://img.shields.io/github/forks/Anonym0usWork1221/GMapsScraper?style=flat-square"></a>
  <a href="https://github.com/Anonym0usWork1221/GMapsScraper/issues"><img alt="GitHub issues" src="https://img.shields.io/github/issues/Anonym0usWork1221/GMapsScraper?style=flat-square"></a>
  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/github/license/Anonym0usWork1221/GMapsScraper?style=flat-square"></a>
  <img alt="Python 3.7+" src="https://img.shields.io/badge/python-3.7%2B-blue?style=flat-square&logo=python&logoColor=white">
  <img alt="Last commit" src="https://img.shields.io/github/last-commit/Anonym0usWork1221/GMapsScraper?style=flat-square">
  <img alt="Platforms" src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey?style=flat-square">
</p>

**GMapsScraper** is a fast, multi-threaded **Google Maps scraper** written in **Python** — with **no API key required**. It extracts **business leads** from Google Maps search results: **name, category, rating, reviews, price level, address, opening hours, phone number, website, menu link, photos, and GPS coordinates (latitude/longitude)** — and can crawl each business's website for **emails and social media links** (Facebook, Instagram, X/Twitter, YouTube, LinkedIn). Export everything to **CSV, Excel (XLSX), or JSON**.

> Also useful as a: google maps data extractor · google maps lead generation tool · google maps email & phone number scraper · google maps business scraper · Selenium / undetected-chromedriver scraping example.

## ✨ Features

- 🔑 **No API key, no billing** — drives a real browser via `undetected-chromedriver` for stealthy, anti-bot scraping.
- ⚡ **Multi-threaded** — scrape many queries in parallel (`-w`).
- 🧾 **15+ fields per place** — title, rating, reviews, price, category, address, hours, phone, website, menu, photos, latitude/longitude, about.
- 📧 **Contact & social enrichment** — optionally crawl each business website for emails + Facebook/Instagram/Twitter/YouTube/LinkedIn (`-se`).
- 💾 **Export to CSV, Excel, or JSON** (`-of`).
- 🖥️ **Headless or windowed**, runs on **Windows, macOS, and Linux** (including headless servers).
- 🎯 **Configurable** result limit, scroll time, and wait times.

If you find any bug or a function that stopped working, feel free to open an issue or contact me.

*  Launch Date   : 2023/08/16
 *  Updated Date   : 2024/02/05
 *  Author : **__Abdul Moez__**
 *  Version : 0.3b
 *  Repository  : https://github.com/Anonym0usWork1221/GMapsScraper
 *  [Documentation](https://github.com/Anonym0usWork1221/GMapsScraper#gmapsscraper-documentation)

MIT License

Copyright (c) 2025 Abdul Moez

----------
# Version 0.3b

````
-----------------------------------------CHANGE LOGS--------------------------------------------------

1. Added support for newer Python versions (3.12+). Fixed the `No module named 'distutils'`
 error by depending on `setuptools`, which provides the distutils compatibility shim
 (distutils was removed from the standard library in Python 3.12 / PEP 632).
2. Wired the `-of`/`--output-format` flag through so EXCEL and JSON outputs work
 (previously it was parsed but ignored, so output was always CSV).
3. Fixed worker query distribution: queries are no longer dropped when the query count
 isn't evenly divisible by the number of threads.
4. Updated all scrapers to the current Google Maps layout. Google reworked the Maps DOM,
 which broke the search box and every detail-field selector (search now used `name="q"`
 instead of `id="searchboxinput"`, and the old `#QA0Szd` container was removed). Re-mapped
 search, title, rating, category, address, phone, website, menu, working hours, cover image,
 related images, and about/description to the new DOM (using stable `data-item-id`/`aria`
 hooks where possible).
5. Auto-detect the installed Chrome version and download a matching driver, fixing
 `This version of ChromeDriver only supports Chrome version N` mismatches.
6. Fixed `FileExistsError` race when multiple threads created the output folder at once.
7. Result limit (`-l`) now returns exactly N results (was returning N+1), and scrolling
 stops reliably when no new results load even if the end-of-list marker changes.
8. Added the missing `lxml` dependency and made HTML parsing fall back to the standard
 library parser, fixing `Couldn't find a tree builder with the features you requested: lxml`
 in the website (`-se`) scraper.
9. Hardened scraping: a single bad result no longer aborts the whole query (it is skipped
 and logged), the Maps UI is pinned to English (`hl=en`) so the layout-based selectors stay
 stable across regions, and the title now waits for non-empty text before being read.
````

# Version 0.2b

````
-----------------------------------------CHANGE LOGS--------------------------------------------------

1. Removed manual driver path (the driver will now be downloaded automatically).
2. Added advanced security patches to make the driver more undetectable.
3. Cleaned the code for better readability.
4. Fixed link detection in the query file.
5. Removed the dictionary cleaner code.
6. Set verbose mode to `True` by default; use `-nv` to disable it.
7. Added support for multiple output formats. You can set the output format using
 `-of CSV`. Available formats: [CSV, EXCEL, JSON].
8. Added a maximum scroll wait time for reaching the end of Google Maps results. 
 You can set the scroll wait time using `-sm`. Example: for 6 minutes, use `-sm 6`.
9. Changed the license from GNU to MIT.
````

-----------

## Requirements
* Python 3.7 or newer (tested up to 3.12; `setuptools` is installed automatically to keep `undetected-chromedriver` working on 3.12+)
* Google Chrome Stable
* Requirements file (as mentioned in installation section in documentation)

## Supported Platform
* Linux
* Windows
* Mac
* Linux Servers (doesn't support `windowed browser`)

## Simple Usage
For just simple execution you don't even need any parameters as all the parameters have default values. Just type (highly recommend to use `-v` tag for verbose. It will only change status tag which keep you up-to-date):
```bash
python3 maps.py
```
After all the parameters here it looks like.
```bash
python maps.py -q ./queries.txt -w 2 -l -1 -u "Not Available" -bw 15 -se contacts -se about -o ./CSV_FILES -of "CSV" -wb -sm 6
```

## What this script Scrapes?
1. `Latitude` (lat): The latitude coordinate of a specific place, usually represented as a decimal number. It indicates the north-south position on the Earth's surface.
2. `Longitude` (long): The longitude coordinate of a specific place, also represented as a decimal number. It indicates the east-west position on the Earth's surface.
3. `Map Link` (map_link): A link to the Google Maps page for the specific place. This link can be used to view the location on the map and gather more information.
4. `Cover Image` (cover_image): The URL or source of the cover image associated with the place. This could be an image that represents the establishment, such as its storefront or a logo.
5. `Card Title` (card_title): The title or name of the place, often used as the primary identifier for the establishment.
6. `Rating` (card_rating): The rating of the place, typically represented as a numerical value or a fraction. This indicates the overall customer satisfaction or quality of the establishment.
7. `Privacy Price` (privacy_price): A representation of the price level of the place, indicating how expensive or budget-friendly it is. This might be presented as dollar signs or other symbols.
8. `Category` (card_category): The category or type of the place, which describes what kind of establishment it is (e.g., restaurant, cafe, museum, etc.).
9. `Address` (card_address): The physical address of the place, which includes street name, city, state, and postal code. It helps users locate the establishment.
10. `Working Hours` (card_hours): The operating hours of the place, often provided as a schedule for each day of the week. It specifies when the establishment is open to the public.
11. `Menu Link` (card_menu_link): A link to the menu of the place, if available. This can provide details about the food and drinks offered at a restaurant or cafe.
12. `Website Link` (card_website_link): A link to the official website of the place. This allows users to access more information directly from the establishment's site.
13. `Phone Number` (card_phone_number): The contact phone number for the place. It provides a way for customers to get in touch with the establishment.
14. `Related Images` (card_related_images): A list of URLs or sources for images related to the place. These images might showcase the interior, exterior, or various aspects of the establishment.
15. `About Description` (card_about): A description or summary of the place, often including information about its history, services, offerings, and any unique features.
### Advance Scraping (What this script Scrapes?)
The script is designed to brute force the URLs based on a provided command line parameter (e.g., `-se about`) that appends "about" to the base website URL (https://www.site.com/about). It then navigates to that "about" page and extracts the specified data attributes.

The extracted attributes help gather contact and social media information about the website or establishment. This information is commonly found on the "about" or "contact" pages of websites and can be useful for users who want to connect with the website's social media presence or reach out via email. The script uses Selenium to automate this process and collect the data for further analysis or storage.

Additionally, it scrapes these attributes (if `-se` tag is used in `CLI`):

1. `Site Email` (site_email): The email address associated with the website's contact or support. This could be used for users to reach out with inquiries or feedback.
2. `Facebook Links` (facebook_links): Links to the official Facebook page or profile of the website or establishment. These links can help users connect with the website's social media presence on Facebook.
3. `Twitter Links` (twitter_links): Links to the official Twitter account of the website or establishment. These links enable users to follow the website's updates and announcements on Twitter.
4. `Instagram Links` (instagram_links): Links to the official Instagram account of the website or establishment. These links allow users to access visual content and engage with the website on Instagram.
5. `YouTube Links` (youtube_links): Links to the official YouTube channel of the website or establishment. Users can find videos, tutorials, or other multimedia content related to the website.
6. `LinkedIn Links` (linkedin_links): Links to the official LinkedIn profile or page of the website or establishment. This provides a professional networking platform and business-related updates.

## Visualization
1. **_Script execution_**
  <img src = "README_ASSETS/ss_google_maps.png"/>

2. **_Visualization of few points of data script scrapes_**.  
<img src = "README_ASSETS/additional_scrape.png"/>

-----

## GMapsScraper Documentation
This command-line tool is designed to scrape data from Google Maps search results using multiple threads and efficient search algorithms. This documentation will provide you with an extensive overview of the tool's features and how to use them effectively.

## Table of Contents

- [Introduction](#introduction)
- [Installation](#installation)
- [Usage](#usage)
   - [Command Line Arguments](#command-line-arguments)
   - [Help for Specific Options](#help-for-specific-options)
- [Input File Format](#input-file-format)
- [Output](#output)
- [Advanced Usage](#advanced-usage)
- [Troubleshooting](#troubleshooting)
- [Conclusion](#conclusion)

## 1. Introduction <a name="introduction"></a>
The `GMapsScraper` tool is a Python script that leverages the power of multiple threads and efficient search algorithms to scrape data from Google Maps search results. It is particularly useful for extracting business or location details for a given set of search queries. This tool aims to provide a user-friendly experience while maximizing scraping efficiency.

## 2. Installation <a name="installation"></a>
To use the `GMapsScraper`, you need to have Python installed on your system. Additionally, you need to install Google Chrome and the required dependencies using the following command:
````
    pip install -r requirements.txt
````

## 3. Usage <a name="usage"></a>
To use the `GMapsScraper`, follow these steps:

Prepare a text file containing the search queries. Each query should be on a separate line in the file.
Open a terminal and navigate to the directory containing the `maps.py` script.
Run the script with the desired command-line arguments.

### Command Line Arguments <a name="command-line-arguments"></a>
The `GMapsScraper` script supports the following command-line arguments:

* `-q` or `--query-file`: Path to the query file. Default: `./queries.txt`
* `-w` or `--threads`: Number of threads to use. Default: `1`
* `-l` or `--limit`: Number of results to scrape. Use `-1` for all results. Default: `-1`
* `-u` or `--unavailable-text`: Replacement text for unavailable information. Default: `Not Available`
* `-bw` or `--browser-wait`: Browser waiting time in seconds. Default: `15`
* `-se` or `--suggested-ext`: Suggested URL extensions to try. Can be specified multiple times.
* `-wb` or `--windowed-browser`: Disable headless mode (display browser window). Default: Headless mode
* `-nv` or `--disable-verbose`: Disable verbose mode (disable additional console output).
* `-o` or `--output-folder`: Output folder to store CSV details. Default: `./CSV_FILES`
* `-of` or `--output-format`: Output format to store scraped data. Available formats [CSV, EXCEL, JSON] default: `CSV`.
* `-sm` or `--scroll-minutes`: Maximum minutes to wait for end of results the waiting time in minutes.
  (Will terminate the scrolling event if scrolling checker is not working) Default: `1`.

### Help for Specific Options <a name="help-for-specific-options"></a>
You can use the following command-line options to get help for specific topics:

* `--help-query-file`: Get help for specifying the query file format.
* `--help-limit`: Get help for specifying the result limit.
* `--help-driver-path`: Get help for specifying the Chrome driver path.

## 4. Input File Format <a name="input-file-format"></a>
The query file should contain a list of search queries, with each query on a separate line. For example:

````
Pizza restaurants
Coffee shops
Gas stations
````

## 5. Output <a name="output"></a>
The scraped data is saved in the specified output folder. **_All results from every query are appended to a single file_** named `google_maps_data.<ext>` (for example `google_maps_data.csv`), where the extension matches the `-of` output format you choose (CSV/EXCEL/JSON).

## 6. Advanced Usage <a name="advanced-usage"></a>
For advanced users, the script provides options to customize various parameters such as the `number of threads`, `result limit`, `browser behavior`, and more. These options can be adjusted to optimize the scraping process based on your requirements.

## 7. Troubleshooting <a name="troubleshooting"></a>
If you encounter any issues while using the `GMapsScraper` tool, consider the following tips:

* Ensure that you have the required dependencies installed.
* Double-check the path to the query file and ensure it is correct.
*  If you encounter driver-related issues, make sure Google Chrome (stable) is installed — the matching driver is downloaded automatically.

## 8. Conclusion <a name="conclusion"></a>
The `GMapsScraper` tool offers a convenient way to extract data from Google Maps search results using efficient algorithms and multiple threads. By following the instructions in this documentation, you can harness the power of this tool to gather valuable location-based information for your projects.

For additional assistance or inquiries, feel free to reach out to the tool's author, **_Abdul Moez_**.

Thank you for using the `GMapsScraper` tool!

-----------

# Contributor

<a href = "https://github.com/Anonym0usWork1221/GMapsScraper/graphs/contributors">
  <img src = "https://contrib.rocks/image?repo=Anonym0usWork1221/GMapsScraper"/>
</a>

-----------

Assistance
----------
If you need assistance, you can ask for help on my mailing list:

* Email      : abdulmoez123456789@gmail.com

-----------

Buy Me a coffee
--------------
If you would like to support me, you can buy me coffee.

Payoneer: ``abdulmoez123456789@gmail.com``