seccionamarilla.com.mx APIseccionamarilla.com.mx ↗
Search and retrieve Mexican business listings from Sección Amarilla. Get names, phones, addresses, coordinates, hours, and social links via 3 endpoints.
curl -X GET 'https://api.parse.bot/scraper/d780d98d-3348-4b8e-a76d-948af67304c3/search_businesses?page=1&query=restaurantes&location=ciudad+de+mexico' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for business listings by keyword and location on Sección Amarilla. Returns paginated results with business name, address, phone, and URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| query | string | Search keyword or category (e.g., 'restaurantes', 'hoteles', 'dentistas'). Omitting defaults to 'restaurantes'. |
| location | string | Location to search in (e.g., 'ciudad de mexico', 'guadalajara'). Omitting defaults to 'mexico'. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search query used",
"listings": "array of business listing objects with name, url, address, phone, and optionally category and website",
"location": "string, the location searched",
"total_pages": "integer, total number of pages available"
},
"sample": {
"data": {
"page": 1,
"query": "restaurantes",
"listings": [
{
"url": "http://minisitios.seccionamarilla.com.mx/hunan2?utm_source=SeccionAmarilla&utm_medium=Listado-de-Resultados&utm_campaign=3078452&utm_term=restaurantes",
"name": "HUNAN",
"phone": "(55)5596-4355",
"address": "AV PASEO DE LA REFORMA 2210 , LOMAS DE CHAPULTEPEC I SECCION"
},
{
"url": "https://www.seccionamarilla.com.mx/informacion/nobu/restaurantes/distrito-federal/cuajimalpa-de-morelos/bosques-de-las-lomas/3998255",
"name": "NOBU",
"phone": "(55)5570-7800",
"address": "PASEO DE LOS TAMARINDOS 90 21 A , BOSQUES DE LAS LOMAS"
}
],
"location": "ciudad de mexico",
"total_pages": 6
},
"status": "success"
}
}About the seccionamarilla.com.mx API
The Sección Amarilla API gives developers structured access to Mexico's largest Yellow Pages directory across 3 endpoints. Use search_businesses to query businesses by keyword and city, returning paginated results with names, phone numbers, addresses, and listing URLs. get_business_details goes deeper, resolving a listing URL into coordinates, operating hours, WhatsApp links, and social media profiles.
What the API Covers
This API surfaces data from seccionamarilla.com.mx, Mexico's primary business directory. It covers three operations: searching the directory by keyword and location, retrieving full detail for individual listings, and fetching the homepage's popular category taxonomy. Together, these cover most common use cases for business discovery and contact data enrichment across Mexican cities.
Search and Pagination
The search_businesses endpoint accepts a query string (e.g., 'dentistas', 'hoteles') and a location string (e.g., 'guadalajara', 'ciudad de mexico'). The response includes a listings array where each entry contains name, address, phone, url, and optionally category and website. The total_pages field tells you how many pages exist for a given query/location combination, and the page parameter lets you walk through them.
Business Detail Fields
get_business_details takes the url returned from search results and returns a richer record: phones (an array, since businesses often list multiple numbers), coordinates (latitude/longitude object, or null if not available), operating_hours (an array of day/hours objects), whatsapp, social_links (an array of profile URLs), and website. This endpoint is the primary way to get geocoordinates and structured hours.
Category Discovery
get_popular_categories requires no inputs and returns an array of objects with name (display label) and slug (URL path segment). This is useful for building category-driven browsing interfaces or discovering valid query terms to pass to search_businesses.
- Build a Mexico-focused local business finder using
search_businesseswith city and category inputs - Enrich a CRM with phone numbers, addresses, and websites for Mexican businesses using
get_business_details - Geocode business locations across Mexico by extracting
coordinatesfrom detail records - Aggregate operating hours for restaurants or pharmacies in a specific Mexican city
- Generate a category-browsing interface seeded from
get_popular_categoriesslugs - Monitor WhatsApp contact availability for local service providers in the directory
- Build a lead list of businesses in a vertical (e.g.,
'plomeros'in'monterrey') with phones and URLs
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Sección Amarilla have an official developer API?+
What does `get_business_details` return that `search_businesses` does not?+
search_businesses returns one phone number per listing at most, plus a URL. get_business_details resolves that URL into a full record including a phones array (multiple numbers), coordinates with latitude and longitude, structured operating_hours by day, whatsapp, social_links, and website. If you only need name and a single phone for a large list, search results may be sufficient; for geocoding or hours, you need the detail endpoint.Are business reviews or ratings available?+
How does pagination work in `search_businesses`?+
page (the current page) and total_pages (the total count for that query and location). Pass the page integer parameter to walk through results. There is no cursor or offset mechanism; pages are integer-indexed starting from 1.Does the API cover businesses outside of Mexico?+
location parameter accepts Mexican cities and regions only.