Seccionamarilla 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.
What is the Seccionamarilla 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace seccionamarilla-com-mx-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Seccion Amarilla SDK — browse Mexican Yellow Pages programmatically."""
from parse_apis.seccion_amarilla_api import SeccionAmarilla, Business, BusinessNotFound, Query, Location
client = SeccionAmarilla()
# Browse popular categories available on the homepage.
for cat in client.categories.list(limit=5):
print(cat.name, cat.slug)
# Search for restaurants in Mexico City — bounded iteration.
listing = client.listings.search(query=Query.RESTAURANTES, location=Location.CIUDAD_DE_MEXICO, limit=1).first()
if listing:
print(listing.name, listing.address, listing.phone)
# Drill into the full business detail for this listing.
try:
detail = listing.details()
print(detail.name, detail.address, detail.phones)
if detail.coordinates:
print(detail.coordinates.latitude, detail.coordinates.longitude)
except BusinessNotFound as exc:
print(f"Business no longer exists: {exc.url}")
print("exercised: categories.list / listings.search / listing.details")
Search for business listings by keyword and location on Sección Amarilla. Returns paginated results with business name, address, phone, category, and detail URL. Each page returns up to 20 listings. Pagination is page-number based.
| 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', 'monterrey'). 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 category",
"location": "string, the location searched",
"total_pages": "integer, total number of pages available"
},
"sample": {
"data": {
"page": 1,
"query": "restaurantes",
"listings": [
{
"url": "https://www.seccionamarilla.com.mx/informacion/hunan/restaurantes/distrito-federal/miguel-hidalgo/lomas-de-chapultepec-i-seccion/3078452",
"name": "HUNAN",
"phone": "(55)5596-4355",
"address": "AV PASEO DE LA REFORMA 2210, LOMAS DE CHAPULTEPEC I SECCION, MIGUEL HIDALGO, DF, CP 11000",
"category": "Restaurantes-Cocina China"
}
],
"location": "ciudad de mexico",
"total_pages": 6
},
"status": "success"
}
}About the Seccionamarilla API
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.
The Seccionamarilla API is a managed, monitored endpoint for seccionamarilla.com.mx — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when seccionamarilla.com.mx changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official seccionamarilla.com.mx API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.