PaginasAmarillas APIpaginasamarillas.com.mx ↗
Access Mexican business listings, categories, contact details, reviews, and blog content from PaginasAmarillas.com.mx via a structured JSON API.
What is the PaginasAmarillas API?
The PaginasAmarillas.com.mx API provides access to Mexico's yellow pages directory across 7 endpoints, returning business profiles, category listings, search results, and blog content. The get_business_detail endpoint alone surfaces contact phones, WhatsApp, email, website, address, services, and customer reviews for individual business profiles.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/cf35e98a-720b-4855-924d-1c11fa09a471/get_homepage' \ -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 paginasamarillas-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.
from parse_apis.paginasamarillas_mx_api import PaginasAmarillas, Category, BusinessSummary, BlogPost
client = PaginasAmarillas()
# Get homepage metadata
homepage = client.homepages.get()
print(homepage.title)
for tag in homepage.popular_tags:
print(tag.name, tag.url)
# List categories and explore one
for cat in client.categories.list():
print(cat.name, cat.status, cat.slug)
# Get businesses in a specific category
security = client.category(slug="seguridad-privada")
for biz in security.businesses():
print(biz.name, biz.rating, biz.address)
detail = biz.details()
print(detail.name, detail.tagline)
print(detail.contact.address, detail.contact.website)
for svc in detail.services:
print(svc.title, svc.description)
# Search businesses
for result in client.businesssummaries.search(query="entretenimiento"):
print(result.name, result.category, result.profile_url)
# Browse blog posts
for post in client.blogposts.list():
print(post.title, post.url)
full = post.read()
print(full.title, full.content)
Fetches homepage metadata including the page title, popular search tags, and featured business categories with their ratings and business counts. The featured categories rotate; the popular tags reflect trending searches.
No input parameters required.
{
"type": "object",
"fields": {
"title": "string - page title of the directory homepage",
"popular_tags": "array of SearchTag objects with name and url",
"featured_categories": "array of FeaturedCategory objects with name, count, rating, and url"
},
"sample": {
"data": {
"title": "Páginas Amarillas México - Directorio de Empresas y Negocios en México",
"popular_tags": [
{
"url": "https://paginasamarillas.mx/restaurantes",
"name": "Restaurantes"
}
],
"featured_categories": [
{
"url": "https://paginasamarillas.mx/categoria/seguridad-privada.html",
"name": "Seguridad Privada",
"count": "4 empresas verificadas",
"rating": "4.8"
}
]
},
"status": "success"
}
}About the PaginasAmarillas API
Business Listings and Categories
The list_categories endpoint returns all directory categories with their slugs and a status field indicating whether a category is active (populated with listings) or upcoming (not yet live). Pass any active slug to get_category to retrieve every business in that category, including each listing's name, rating, review_count, description, address, and profile_url. This makes it straightforward to enumerate the full directory contents programmatically.
Business Profiles
get_business_detail returns the deepest data in the API. You can call it with a full url parameter or with both category and slug together. The response includes contact (an object with phones array, website, whatsapp, email, and address), a services array with each service's title and description, a reviews array with author, text, and rating per entry, and a tagline alongside an extended about text. This covers everything exposed on a public business profile page.
Search and Homepage Signals
search_businesses accepts a query string and matches it against category names and slugs, returning businesses from up to 3 matching categories along with the matched_categories array so you know which categories contributed results. The get_homepage endpoint provides popular_tags (trending search terms with names and URLs) and featured_categories with their count and rating fields — useful for understanding which segments are most active in the directory at a given time.
Blog Content
list_blog_posts returns all blog posts with title and url. Pass any URL from that list to get_blog_post to retrieve the full title and content of the post. The blog covers industry-specific topics tied to the directory's categories and can be used to surface editorial content alongside business data.
The PaginasAmarillas API is a managed, monitored endpoint for paginasamarillas.com.mx — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when paginasamarillas.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 paginasamarillas.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 business finder that lets users browse by category slug and view contact details including WhatsApp numbers.
- Aggregate ratings and review counts across categories to benchmark local market reputation data.
- Populate a CRM with verified Mexican business contact info including phones, email, and website from
get_business_detail. - Track trending search terms and featured categories from
get_homepageto monitor which service sectors are growing in demand. - Display curated industry blog content alongside business listings using
list_blog_postsandget_blog_post. - Identify service gaps in a given market segment by comparing active vs. upcoming categories from
list_categories. - Build a lead generation tool targeting Mexican businesses in specific verticals by iterating through category slugs.
| 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 PaginasAmarillas.com.mx have an official developer API?+
What does `get_business_detail` return that the category listing doesn't?+
get_category returns a summary per business: name, rating, review_count, description, address, and profile_url. get_business_detail adds the full contact object (phones array, website, whatsapp, email), a services array with titles and descriptions, individual reviews with author and text, a tagline, and an extended about text. The two endpoints are complementary — use the category endpoint for discovery, business detail for depth.Does `search_businesses` support filtering by city, state, or location?+
search_businesses matches the query against category names and slugs only and returns up to 3 matching categories worth of results. There is no location filter parameter in the current API. You can fork it on Parse and revise to add a location-based filtering endpoint if your use case requires geographic scoping.Does the API return pagination tokens for large category results?+
get_category returns all businesses for a given slug in a single response. For very large categories, this means the full result set is returned at once. If paginated access is needed, you can fork the API on Parse and revise it to add offset or page parameters.