# Mexico Business Directory Scraper - Phone & Address Leads (`scrapers_lat/mexico-companies-directory-scraper`) Actor

Scrape Mexican business leads by type and city: name, phone, WhatsApp, email, website, category (giro) and full address (street, colonia, city, state, postal code) plus coordinates. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/mexico-companies-directory-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $17.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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/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

## Mexico Business Directory Scraper - Phone, Email & Address Leads

> Turn any Mexican city and business type into a clean spreadsheet of B2B leads: business name, phone, WhatsApp, email, website, category (giro) and full address.

**📥 [Input](https://apify.com/scrapers_lat/mexico-companies-directory-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/mexico-companies-directory-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/mexico-companies-directory-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/mexico-companies-directory-scraper/examples)**

### What you get

For every business found, you get a flat, ready-to-use lead record:

- **Business name** and **category / giro**
- **Phone** and **WhatsApp** number
- **Email** (when the business publishes one)
- **Website**
- **Full address**: street, colonia, city, state and postal code (CP)
- **Coordinates** (latitude / longitude) for mapping
- **Listing URL** so you can verify the source
- The search query and city that produced the record

Give it a list of business types (in Spanish, e.g. `restaurantes`, `hoteles`, `dentistas`, `abogados`) and a list of cities (e.g. `Ciudad de Mexico`, `Guadalajara`, `Monterrey`). One run covers every combination and returns as many businesses as you ask for.

### Who is it for

- Sales and lead-generation teams building B2B contact lists in Mexico
- Local marketing agencies and directory aggregators
- Market researchers mapping suppliers, competitors or partners by city and sector
- Anyone who needs Mexican company contact data in CSV, JSON or Excel

### How to use it

1. Add one or more **business types** (giros) to search.
2. Add one or more **cities**.
3. Set **Max Businesses** and choose whether to fetch the full address and description.
4. Run it, then export the results as JSON, CSV or Excel.

You are never charged for an empty run: you only pay for real business records that are returned.

### FAQ

**Do I need an account or API key for the source?** No. Just provide the business types and cities.

**Which fields are always filled?** Name, phone, category, city and state are almost always present. Email, website and WhatsApp appear when the business publishes them. Street and postal code are added when "Fetch Full Address & Description" is on.

**Can I search multiple cities and categories at once?** Yes. Both inputs are lists and one run covers every combination.

**What format is the output?** A flat table — one row per business — exportable to JSON, CSV or Excel.

<!-- example-tasks -->
<!-- /example-tasks -->

### Related actors

- Paginas Amarillas Business Leads & Phone Scraper
- YellowPages Scraper - Phone, Website & Address Leads (US)
- Yellow Pages Canada Business Leads Scraper

### From scrapers.lat

Built by [scrapers.lat](https://scrapers.lat) — structured data and lead-generation scrapers for Latin America and beyond.

---

*This actor is not affiliated with, endorsed by, or sponsored by any business directory. It collects only publicly available information. Use the data in compliance with applicable laws and the source's terms.*

# Actor input Schema

## `searchQueries` (type: `array`):

One or more business types, categories or keywords to search (in Spanish), for example "restaurantes", "hoteles", "dentistas", "abogados". One run searches every type across every city below.
## `cities` (type: `array`):

One or more Mexican cities or localities to search, for example "Ciudad de Mexico", "Guadalajara", "Monterrey". Accents and capitalization are handled automatically.
## `maxBusinesses` (type: `integer`):

Maximum number of businesses to collect across the whole run. Optional.
## `fetchDetails` (type: `boolean`):

When enabled, opens each business page to add the full street address, postal code (CP) and description. Disable for a faster, listing-only run (name, phone, email, website, colonia, city, state).

## Actor input object example

```json
{
  "searchQueries": [
    "restaurantes"
  ],
  "cities": [
    "Ciudad de Mexico"
  ],
  "maxBusinesses": 40,
  "fetchDetails": true
}
````

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "restaurantes"
    ],
    "cities": [
        "Ciudad de Mexico"
    ],
    "maxBusinesses": 40
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/mexico-companies-directory-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["restaurantes"],
    "cities": ["Ciudad de Mexico"],
    "maxBusinesses": 40,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/mexico-companies-directory-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": [
    "restaurantes"
  ],
  "cities": [
    "Ciudad de Mexico"
  ],
  "maxBusinesses": 40
}' |
apify call scrapers_lat/mexico-companies-directory-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapers_lat/mexico-companies-directory-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Mexico Business Directory Scraper - Phone & Address Leads",
        "description": "Scrape Mexican business leads by type and city: name, phone, WhatsApp, email, website, category (giro) and full address (street, colonia, city, state, postal code) plus coordinates. Export to JSON, CSV or Excel.",
        "version": "0.1",
        "x-build-id": "5nllyhKwowazHb7nP"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapers_lat~mexico-companies-directory-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapers_lat-mexico-companies-directory-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/scrapers_lat~mexico-companies-directory-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapers_lat-mexico-companies-directory-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/scrapers_lat~mexico-companies-directory-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapers_lat-mexico-companies-directory-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",
                "properties": {
                    "searchQueries": {
                        "title": "Business Types / Giros",
                        "type": "array",
                        "description": "One or more business types, categories or keywords to search (in Spanish), for example \"restaurantes\", \"hoteles\", \"dentistas\", \"abogados\". One run searches every type across every city below.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "cities": {
                        "title": "Cities",
                        "type": "array",
                        "description": "One or more Mexican cities or localities to search, for example \"Ciudad de Mexico\", \"Guadalajara\", \"Monterrey\". Accents and capitalization are handled automatically.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxBusinesses": {
                        "title": "Max Businesses To Scrape",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Maximum number of businesses to collect across the whole run. Optional."
                    },
                    "fetchDetails": {
                        "title": "Fetch Full Address & Description",
                        "type": "boolean",
                        "description": "When enabled, opens each business page to add the full street address, postal code (CP) and description. Disable for a faster, listing-only run (name, phone, email, website, colonia, city, state).",
                        "default": 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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```