paginasamarillas.com.mx APIpaginasamarillas.com.mx ↗
Access Mexican business listings, categories, contact details, reviews, and blog content from PaginasAmarillas.com.mx via a structured JSON API.
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'
Fetches the homepage metadata including the page title, popular search tags, and featured business categories with their ratings and business counts.
No input parameters required.
{
"type": "object",
"fields": {
"title": "string - page title of the directory homepage",
"popular_tags": "array of objects with name and url for trending search terms",
"featured_categories": "array of objects with name, count, rating, and url for highlighted categories"
},
"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"
},
{
"url": "https://paginasamarillas.mx/hoteles",
"name": "Hoteles"
}
],
"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.com.mx 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.
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.
- 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 | 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 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.