# Google Maps Mexico Scraper — Email + Leads (`totaka/google-maps-mexico-scraper`) Actor
Extract Mexican business leads from Google Maps — name, address, phone, email, website, rating and GPS. Emails auto-extracted from business websites. Mexico City, Guadalajara leads.
- **URL**: https://apify.com/totaka/google-maps-mexico-scraper.md
- **Developed by:** [Thomas Gharbi](https://apify.com/totaka) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 66.7% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## 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.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 Mexico Business Scraper
### What does Google Maps Mexico Business Scraper do?
Google Maps Mexico Business Scraper lets you extract business listings from Google Maps in Mexico for any search query. For each result you get the business name, full address, phone number, **email address** (automatically extracted from the business website), website URL, star rating, and GPS coordinates — ready to export to CSV or feed directly into your CRM.
This scraper was built because the official Google Places API is expensive ($17 per 1,000 results) and requires an approved project. This Actor gives you the same data — plus emails that Google doesn't provide — at a fraction of the cost, with no API key needed.
The scraper supports:
- **Search by keyword and location** — use any query you would type into Google Maps (e.g. `plomero Ciudad de México`, `electrician Chicago`)
- **Multiple queries in one run** — run 10 or 100 different queries in a single job and get all results merged
- **Email extraction** — for each business that has a website, the scraper visits it and extracts the contact email address
- **GPS coordinates** — latitude and longitude parsed from the Google Maps URL
- **Real-time results** — data is pushed to your dataset as each business is scraped; no need to wait for the full run
- **Export to CSV, JSON, or Excel** — directly from the Apify console
### How much will scraping Google Maps cost you?
This scraper uses a **pay-per-result** pricing model: it costs **$1.00 to scrape 1,000 business listings** ($0.001 per result).
With the **Apify Free plan** ($5 free usage credit every month), you can scrape approximately **4,000–5,000 businesses per month for free**.
Email extraction visits each business website, which adds a few seconds per result. This is included in the price — you're still billed $0.001 per business regardless.
Apify Residential Proxies are used automatically to prevent Google blocks — the cost is included in the per-result price above.
### What does the output look like?
Each scraped business has the following structure:
```json
{
"title": "Best Plumbing NYC",
"category": "Plumber",
"address": "350 5th Ave, New York, NY 10118",
"phone": "+1 212-555-0147",
"email": "hello@bestplumbing.com",
"website": "https://www.bestplumbing.com",
"rating": "4.7",
"latitude": 40.7484,
"longitude": -73.9967,
"searchQuery": "plomero Ciudad de México",
"scrapedAt": "2024-06-15T09:23:11.000Z"
}
````
You can export all results as **CSV**, **JSON**, or **Excel**, or use the [Apify API](https://docs.apify.com/api/v2) to push data directly into your CRM, Google Sheets, or any other tool.
### What can you use this data for?
- **B2B lead generation** — build targeted prospect lists by trade and city, complete with direct contact details
- **Email outreach campaigns** — reach business owners directly by email instead of cold-calling
- **Market research** — map business density, analyze competition, and identify underserved areas
- **CRM enrichment** — fill in missing phone numbers, emails, and addresses on existing contact records
- **Local SEO monitoring** — track competitor ratings and review counts in your niche
### How to use Google Maps Mexico Business Scraper
1. Click **Try for free** to open the scraper
2. Add your search queries — one per line (e.g. `plomero Ciudad de México`, `electrician Chicago`)
3. Set **Max results per query** — the default is 20, the maximum is 100
4. Click **Run** — results start appearing in your dataset within seconds
5. When the run finishes, click **Export** to download CSV, JSON, or Excel
### Limitations and things to keep in mind
Scraping Google Maps is inherently dynamic — Google regularly changes its page structure, and results may vary by location, time of day, and query complexity. We regularly update this scraper to keep it working, but the number of results per run may occasionally fluctuate. The best way to validate for your specific use case is to run a small test first.
**Email extraction**: Not every business has a website listed on Google Maps, and not every website publishes a contact email address. On average you can expect to find an email for **40–60% of businesses**, depending on the industry and region. Professional services (plumbers, lawyers, accountants) tend to have higher email rates than restaurants or retail shops.
**Proxy requirement**: Residential proxies are required to reliably access Google Maps. The scraper uses Apify Residential Proxies by default — do not disable this setting.
### Support and feedback
If you encounter a bug or want to request a new feature, please open an issue on the **Issues tab** in the Apify console. We actively maintain this scraper and respond to all reported issues.
# Actor input Schema
## `searchQueries` (type: `array`):
Enter one search query per line — exactly as you would type it into Google Maps.
Examples: plomero Ciudad de México, restaurant Paris 7ème, dentist New York
## `maxResultsPerQuery` (type: `integer`):
Maximum number of results to scrape per search query.
Default: 20 | Max: 100
⚠️ Higher values mean longer runs and higher costs.
## `extractEmail` (type: `boolean`):
When enabled, the scraper visits each business website to find a contact email address.
📌 Adds ~3 seconds per result. Disable for faster runs when you only need phone numbers.
## `minRating` (type: `number`):
Only save businesses with a rating at or above this value.
Examples: 4 = only businesses rated 4★ or higher | 0 = no filter
## `minReviews` (type: `integer`):
Only save businesses with at least this many reviews.
Examples: 10 = skip businesses with fewer than 10 reviews | 0 = no filter
## `proxyConfiguration` (type: `object`):
Residential proxies are required to access Google Maps reliably. Do not disable — runs without proxies will be blocked immediately.
## Actor input object example
```json
{
"searchQueries": [
"plomero Ciudad de México"
],
"maxResultsPerQuery": 3,
"extractEmail": true,
"minRating": 0,
"minReviews": 0,
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `results` (type: `string`):
Scraped data items 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 = {
"searchQueries": [
"plomero Ciudad de México"
],
"maxResultsPerQuery": 3
};
// Run the Actor and wait for it to finish
const run = await client.actor("totaka/google-maps-mexico-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 = {
"searchQueries": ["plomero Ciudad de México"],
"maxResultsPerQuery": 3,
}
# Run the Actor and wait for it to finish
run = client.actor("totaka/google-maps-mexico-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 '{
"searchQueries": [
"plomero Ciudad de México"
],
"maxResultsPerQuery": 3
}' |
apify call totaka/google-maps-mexico-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=totaka/google-maps-mexico-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Mexico Scraper — Email + Leads",
"description": "Extract Mexican business leads from Google Maps — name, address, phone, email, website, rating and GPS. Emails auto-extracted from business websites. Mexico City, Guadalajara leads.",
"version": "1.0",
"x-build-id": "ZYoWYyK7Cvaz50waT"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/totaka~google-maps-mexico-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-totaka-google-maps-mexico-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/totaka~google-maps-mexico-scraper/runs": {
"post": {
"operationId": "runs-sync-totaka-google-maps-mexico-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/totaka~google-maps-mexico-scraper/run-sync": {
"post": {
"operationId": "run-sync-totaka-google-maps-mexico-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": [
"searchQueries"
],
"properties": {
"searchQueries": {
"title": "🔍 Search queries",
"minItems": 1,
"type": "array",
"description": "Enter one search query per line — exactly as you would type it into Google Maps.
Examples: plomero Ciudad de México, restaurant Paris 7ème, dentist New York",
"items": {
"type": "string"
}
},
"maxResultsPerQuery": {
"title": "📊 Max results per query",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Maximum number of results to scrape per search query.
Default: 20 | Max: 100
⚠️ Higher values mean longer runs and higher costs.",
"default": 20
},
"extractEmail": {
"title": "📧 Extract email addresses",
"type": "boolean",
"description": "When enabled, the scraper visits each business website to find a contact email address.
📌 Adds ~3 seconds per result. Disable for faster runs when you only need phone numbers.",
"default": true
},
"minRating": {
"title": "⭐ Minimum star rating",
"minimum": 0,
"maximum": 5,
"type": "number",
"description": "Only save businesses with a rating at or above this value.
Examples: 4 = only businesses rated 4★ or higher | 0 = no filter",
"default": 0
},
"minReviews": {
"title": "💬 Minimum review count",
"minimum": 0,
"type": "integer",
"description": "Only save businesses with at least this many reviews.
Examples: 10 = skip businesses with fewer than 10 reviews | 0 = no filter",
"default": 0
},
"proxyConfiguration": {
"title": "🌐 Proxy configuration",
"type": "object",
"description": "Residential proxies are required to access Google Maps reliably. Do not disable — runs without proxies will be blocked immediately.",
"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
}
}
}
}
}
}
}
}
}
}
```