mapscopex

mapscopex searches Google Maps for businesses and attempts to extract email addresses from their websites.

Install

pip install mapscopex

Public API

from mapscopex import collect_searchprobe, searchprobe

• searchprobe(keyword, location, max_items=None) streams cumulative results as they are found.
• collect_searchprobe(keyword, location, max_items=None) waits for the scrape to finish and returns the final list once.

Usage

Streaming search

from mapscopex import searchprobe

for results_so_far in searchprobe(
    keyword="lawyers and law firm",
    location="Houston, TX",
    max_items=None,
):
    print(results_so_far[-1])

searchprobe() yields the cumulative result set each time a new business is found.

max_items=None searches until Google Maps stops yielding new businesses.

Collect final results

from mapscopex import collect_searchprobe

results = collect_searchprobe(
    keyword="lawyers and law firm",
    location="Houston, TX",
    max_items=None,
)

collect_searchprobe() waits for the search to finish and returns the final list once.

Output Shape

Each result is a dictionary with these keys:

{
    "name": str,
    "category": str,
    "address": str,
    "city": str,
    "state": str,
    "zip": str,
    "phone": str,
    "website": str,
    "emails": list[str],
}

searchprobe() yields a list of these dictionaries after each new business is added. collect_searchprobe() returns the final list once the scraper stops.

Release Notes

The current package version is 0.1.4. That is a reasonable initial public release while the API is still settling.