Sección Amarilla Mexico Business Scraper

Extract business listings from Sección Amarilla (seccionamarilla.com.mx), Mexico's yellow pages, as clean structured JSON: company name, category, full address split into street, colonia, municipality, state and postal code, GPS coordinates, phone numbers, WhatsApp, website, opening hours, accepted payment methods, product and service tags, branches and the logo image.

Give it one or more categories or keywords and an optional city or state. Pay per result: you only pay for the businesses you receive, and maxResults caps the cost.

What you can use it for

• B2B lead generation: every hardware store, dental clinic, hotel or workshop in a city, with phone, WhatsApp and website.
• Local-market research: how many businesses of a type exist per colonia or municipality, with coordinates for mapping.
• Data enrichment: match your customer list against a public directory to fill in addresses, postal codes and phones.
• Directory and app builders: seed a vertical directory with structured Mexican business data, including opening hours and payment methods.
• AI agents: ask for businesses in natural language through MCP (see below).

Input

Field	Type	Default	Description
searchQueries	string[]	["restaurantes"]	Categories or free keywords as written on the site (restaurantes, ferreterias, hoteles, talleres mecanicos). Each one is a separate search. Give at least one keyword or one startUrls entry.
city	string	ciudad de mexico	City or municipality (guadalajara, monterrey, puebla, cancun). Leave empty to search all of Mexico. Big-city results include the metro area.
state	string	–	Mexican state (jalisco, nuevo leon, estado de mexico). Combine with city for state + city results, or use it alone for a whole state.
strictLocation	boolean	true	Skip businesses whose state is not the requested one (the state given, or the state of the city / metro area). The site pads located searches with businesses from other states; see Limits. Set to false to keep every row the site returns.
startUrls	array	–	Custom results URLs, e.g. https://www.seccionamarilla.com.mx/resultados/dentistas/guadalajara/1, or a text file with one URL per line. Not filtered by city / state.
maxResults	integer	100	Total cap across all queries.
scrapeDetails	boolean	true	Open each business page for description, opening hours, payment methods, tags, extra phone lines, branches, image and official website. One extra request per business that has a page.
onlyWithWebsite	boolean	false	Skip listings without a website (lead generation).
includeIndividuals	boolean	false	Keep professionals listed under a personal name (see Legal notice). They are saved with publisherType: "possible_individual" and without phone, WhatsApp or email.
includeEmail	boolean	false	Add the business email published on the listing (business records only).
proxyConfiguration	object	Apify proxy	Recommended for runs above a few hundred results.
maxConcurrency	integer	3	Keep it low (2–5); the site is a plain directory shared with real users.

Example:

{
    "searchQueries": ["ferreterias", "materiales para construccion"],
    "city": "guadalajara",
    "state": "jalisco",
    "maxResults": 300,
    "scrapeDetails": true,
    "onlyWithWebsite": false
}

Output

One dataset item per business. Example, a real record (openingHours shortened to three days):

{
    "id": "3078452",
    "name": "HUNAN",
    "category": "Restaurantes-Cocina China",
    "description": "LA MEJOR COMIDA CHINA VISITANOS EN REFORMA Y SAN ANGEL",
    "address": "AV PASEO DE LA REFORMA 2210, LOMAS DE CHAPULTEPEC I SECCION, MIGUEL HIDALGO, DF, CP 11000",
    "street": "AV PASEO DE LA REFORMA 2210",
    "neighborhood": "LOMAS DE CHAPULTEPEC I SECCION",
    "city": "MIGUEL HIDALGO",
    "state": "DF",
    "stateName": "Ciudad de México",
    "postalCode": "11000",
    "country": "MX",
    "latitude": 19.406449,
    "longitude": -99.226327,
    "phone": "5555964355",
    "phones": ["5555964355", "5555965011"],
    "whatsapp": null,
    "email": null,
    "website": "http://www.hunan.com.mx",
    "websiteIsMinisite": false,
    "openingHours": [
        { "day": "monday", "opens": "13:30", "closes": "22:00" },
        { "day": "saturday", "opens": "13:30", "closes": "12:00" },
        { "day": "sunday", "opens": "13:30", "closes": "18:00" }
    ],
    "paymentMethods": ["EFECTIVO"],
    "tags": ["COCINA CHINA", "RESTAURANTES CHINOS", "COCINA", "COMIDA", "RESTAURANTES CHINA"],
    "branches": [
        {
            "name": "HUNAN",
            "address": "PEDRO LUIS DE OGAZON 102 DF 01020, GUADALUPE INN, ALVARO OBREGON, DF",
            "phones": ["5555964355"]
        }
    ],
    "imageUrl": "https://graficos.seccionamarilla.com.mx/contentstore/88/2055988_V1-E36182318.gif",
    "listingTier": "DIA",
    "indexingSource": "IAM",
    "publisherType": "business",
    "url": "https://www.seccionamarilla.com.mx/informacion/hunan/restaurantes/distrito-federal/miguel-hidalgo/lomas-de-chapultepec-i-seccion/3078452",
    "mapUrl": "https://www.seccionamarilla.com.mx/mapas/como-llegar/hunan/restaurantes-cocina-china/df/miguel-hidalgo/3078452",
    "searchQuery": "restaurantes",
    "searchLocation": "ciudad de mexico",
    "scrapedAt": "2026-10-26T23:01:47.430Z"
}

Field	Description
id	Sección Amarilla listing id (stable, use it to deduplicate between runs)
name, category, description	Business name and specific category as published; description only from the business page
address, street, neighborhood, city, state, stateName, postalCode, country	Full one-line address and its parts; state is the site's code (DF, JAL, NL), stateName the full name, postalCode the 5-digit CP. city and neighborhood are copied as published: upper case for directory records, mixed case for partner-feed (SINERGIA) records
latitude, longitude	Coordinates as published (null for basic listings without a map pin)
phone, phones, whatsapp	10-digit Mexican national numbers (dial with +52); phones holds every line published, the business page adds extra lines
email	Business email, only when includeEmail is true and the record is a business
website, websiteIsMinisite	Website without tracking parameters; the business's own domain is preferred over a Sección Amarilla-hosted minisite (minisitios.seccionamarilla.com.mx, *.miadn.mx), which websiteIsMinisite flags
openingHours, paymentMethods, tags, branches, imageUrl	Business-page data: hours per weekday (24h), accepted payments as published (EFECTIVO, VISA...), product/service tags, other branches, logo or ad image URL
listingTier, indexingSource	Advertiser tier code shown by the site (DIA, ORO, PLA, SPN, PIP, TMXGMB...) and the record origin flag (IAM, SINERGIA or null)
publisherType	business, or possible_individual for a professional listed under a personal name (only present when includeIndividuals is true)
url, mapUrl	Business page and route/map page on seccionamarilla.com.mx
searchQuery, searchLocation, scrapedAt	Provenance

Fields not published for a business are null. With scrapeDetails: false only listing fields are filled (name, category, address parts, coordinates, main phone, WhatsApp, website, tier), which takes one request per 20 businesses.

Pricing & cost examples

$5.00 per 1,000 businesses (pay per event, charged only for items saved to the dataset; duplicates and errors are never billed). maxResults is a hard cost cap. Examples: 1,000 businesses ≈ $5.00 · a prospect list of 200 restaurants in one city ≈ $1.00 · a weekly run with maxResults: 100 ≈ $0.50/week. Apify platform usage is included in the price.

Use it from an AI agent (MCP)

Every Apify Actor is available as a tool through the Apify MCP server. Add it to Claude, Cursor, VS Code or any MCP client and ask, for example:

"Find hardware stores in Zapopan that have a website and tell me which ones open on Saturdays."

The agent calls this Actor with {"searchQueries":["ferreterias"],"city":"zapopan","state":"jalisco","onlyWithWebsite":true} and reasons over openingHours.

From code, with the Apify API:

curl -X POST "https://api.apify.com/v2/acts/hexadatalabs~seccion-amarilla-business-scraper/run-sync-get-dataset-items?token=<APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["hoteles"],"city":"monterrey","state":"nuevo leon","maxResults":50,"scrapeDetails":false}'

from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("hexadatalabs/seccion-amarilla-business-scraper").call(run_input={
    "searchQueries": ["talleres mecanicos"], "city": "puebla", "maxResults": 200,
})
for biz in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(biz["name"], biz["phone"], biz["website"], biz["postalCode"])

Limits and notes

• Results come from the public search pages in the site's own order, 20 per page. The site publishes no total count; the Actor follows the pagination until the last page or maxResults.
• The first pages hold paying advertisers with full business pages; deeper pages are mostly basic listings (name, category, address, phone, no coordinates, no website). Those are saved from the listing data and cost no detail request. The log reports how many.
• Searches by city, and even by state + city, return the metro area plus some businesses from other states (about 1 in 4 rows in a Monterrey, Nuevo León hotel test, independent hotels included, not only chains). With strictLocation (default) those rows are skipped before they count towards maxResults; the log reports how many. The requested state is the state given, or the state of a known city or metro area (ciudad de mexico covers DF and Estado de México); for a small town it is inferred from the first results page. Municipalities inside the metro area are kept (a guadalajara search includes Zapopan); filter on city in the output if you need one municipality only.
• The same business can appear under two listing ids (for example a legacy record and a newer partner-feed record). The Actor deduplicates by id, not by name.
• Spelling: use the words as written on the site (ferreterias, not ferreterías; accents are stripped automatically). A misspelled keyword gives zero results, not an error. The site answers an unknown or misspelled city with businesses from all over Mexico; the Actor detects that, skips the query with a LOCATION_NOT_RECOGNISED warning and fails the run when nothing else was saved, so you are not charged for random results.
• If the site changes its HTML the run fails with a clear SITE_LAYOUT_CHANGED error instead of returning empty data. Please report it and it will be fixed quickly.
• Keep maxConcurrency low. The Actor uses a session pool and retries transient errors up to 3 times. A business page that still fails is saved from its listing data (the log says how many) so the run reaches maxResults.
• Looking for every registered business in Mexico, including those not advertised in Sección Amarilla? The official INEGI DENUE directory covers 5+ million establishments; see the Mexico Business Directory (DENUE) Actor by the same author.

Legal notice

This Actor collects publicly available business directory information: company names, commercial addresses, business phone numbers and websites, as published by the businesses themselves on seccionamarilla.com.mx. It does not log in, does not bypass access controls and respects the site's robots.txt.

Some categories (dentists, doctors, lawyers, accountants, psychologists...) list independent professionals under their personal name. To stay clear of personal data, the Actor applies a heuristic on the business name and skips records that look like a private individual by default. Set includeIndividuals: true only if you have a legal basis under the Mexican LFPDPPP or the data-protection law that applies to you; those records are then saved without phone, WhatsApp or email. Sole-proprietor shops listed under an owner's name with a commercial category (a hardware store, a bakery) are treated as businesses. Email addresses are off by default (includeEmail). You are responsible for complying with Sección Amarilla's terms of use and with the data-protection and anti-spam laws that apply to your use of the data.

Changelog

• 0.1 (2026-10-27) — First public release.

Support

Found a problem or need another field? Open an issue in the Issues tab of this Actor; we answer within 24 hours and ship confirmed fixes within 48 hours.

---

En español

Extrae negocios de Sección Amarilla (seccionamarilla.com.mx) con nombre, categoría, dirección completa separada en calle, colonia, municipio, estado y código postal, coordenadas GPS, teléfonos, WhatsApp, sitio web, horarios, formas de pago, productos y servicios, sucursales e imagen. Indica la categoría o palabra clave y opcionalmente la ciudad o el estado. Se cobra por resultado; usa maxResults para limitar el costo. Por defecto omite a los profesionistas registrados con su nombre personal (dentistas, médicos, abogados...) y no incluye correos electrónicos. Funciona también como herramienta para agentes de IA mediante el servidor MCP de Apify.