# Google Maps With Email Scraper (`hyderdev/google-maps-with-email-scraper`) Actor Extract business leads from Google Maps with verified emails. Search by keyword and location to get names, phones, websites, ratings, and emails scraped from websites or Facebook pages. Perfect for sales prospecting and market research. Exports to JSON, CSV, and Excel. - **URL**: https://apify.com/hyderdev/google-maps-with-email-scraper.md - **Developed by:** [Hyder Khan](https://apify.com/hyderdev) (community) - **Categories:** Lead generation, Automation, Social media - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Maps Scraper Scrapes business listings from Google Maps for a given entity type and location, enriches each result with an email address (from the business website or Facebook page), and exports everything to a CSV file. ### What it collects For each listing found on Google Maps: | Field | Source | |---|---| | Name | Google Maps detail panel | | Category | Google Maps detail panel | | Rating | Google Maps detail panel | | Reviews | Google Maps detail panel | | Phone | Google Maps detail panel | | Address | Google Maps detail panel | | Hours | Google Maps detail panel | | Website | Google Maps detail panel | | Plus Code | Google Maps detail panel | | Email | Business website → Facebook page via DuckDuckGo (fallback) | | City | User input | | Country | User input | | Type | User input | ### Requirements - Python 3.10+ - Playwright (Chromium) ### Setup ```bash python -m venv .venv source .venv/bin/activate pip install -r requirements.txt playwright install chromium ```` ### Usage ```bash python main.py ``` You will be prompted for three inputs: ``` Entity type (e.g. Dental Clinic): Dental Clinic City (e.g. Doha): Doha Country (e.g. Qatar): Qatar ``` Results are saved to `results.csv` in the project root. ### How it works 1. Opens Google Maps and searches ` `. 2. Scrolls the results feed until no new listings load. 3. Clicks each listing, reads the detail panel, and extracts structured data. 4. Visits the business website and scrapes it for an email address. 5. If no email is found on the website, searches DuckDuckGo (`site:facebook.com `) for the business's Facebook page and scrapes that instead. 6. Paginates through all Google Maps result pages and repeats. 7. Writes the collected records to `results.csv`. ### Project structure ``` google_scraper/ ├── main.py # Entry point — prompts for input, runs scraper, writes CSV └── scraper/ ├── maps.py # GoogleMapsScraper — orchestrates the scrape and email enrichment ├── parser.py # Extracts structured fields from a Maps detail panel ├── email.py # Fetches a page and extracts the first email address ├── scroll.py # Scrolls the results feed until all listings are loaded ├── stealth.py # Anti-bot browser fingerprint patches for every context ├── selectors.py # CSS selectors for Google Maps DOM elements └── utils/ └── build_url.py # Builds Google Maps / DuckDuckGo query URLs ``` ### Anti-bot measures Every Playwright context is created via `new_stealth_context` (`scraper/stealth.py`), which randomizes a realistic macOS Chrome user agent, sets matching client-hint headers, and injects JS patches before page scripts run — hiding the `webdriver` flag, restoring the `chrome` runtime object, faking plugins/mimeTypes, and removing Playwright-specific globals — to reduce the chance of being blocked. # Actor input Schema ## `entityType` (type: `string`): The kind of business to search for on Google Maps. ## `city` (type: `string`): City to search within. ## `country` (type: `string`): Country to search within. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Enabling proxy is recommended to reduce the chance of being blocked by Google. ## Actor input object example ```json { "entityType": "Dental Clinic", "city": "Doha", "country": "Qatar", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `businesses` (type: `string`): Structured business records stored in the default dataset. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "entityType": "Dental Clinic", "city": "Doha", "country": "Qatar", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("hyderdev/google-maps-with-email-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "entityType": "Dental Clinic", "city": "Doha", "country": "Qatar", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("hyderdev/google-maps-with-email-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "entityType": "Dental Clinic", "city": "Doha", "country": "Qatar", "proxyConfiguration": { "useApifyProxy": true } }' | apify call hyderdev/google-maps-with-email-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=hyderdev/google-maps-with-email-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps With Email Scraper", "description": "Extract business leads from Google Maps with verified emails. Search by keyword and location to get names, phones, websites, ratings, and emails scraped from websites or Facebook pages. Perfect for sales prospecting and market research. Exports to JSON, CSV, and Excel.", "version": "0.1", "x-build-id": "9OJeZpGh0p0p8fwaX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hyderdev~google-maps-with-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hyderdev-google-maps-with-email-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/hyderdev~google-maps-with-email-scraper/runs": { "post": { "operationId": "runs-sync-hyderdev-google-maps-with-email-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/hyderdev~google-maps-with-email-scraper/run-sync": { "post": { "operationId": "run-sync-hyderdev-google-maps-with-email-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "entityType", "city", "country" ], "properties": { "entityType": { "title": "Entity type", "type": "string", "description": "The kind of business to search for on Google Maps." }, "city": { "title": "City", "type": "string", "description": "City to search within." }, "country": { "title": "Country", "type": "string", "description": "Country to search within." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Enabling proxy is recommended to reduce the chance of being blocked by Google.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```