mapscopex 0.1.4

Search Google Maps listings and extract business website emails.

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.