paginasamarillas.com.pe APIwww.paginasamarillas.com.pe ↗
Search and retrieve Peruvian business listings from paginasamarillas.com.pe. Get phones, emails, WhatsApp, addresses, hours, and reviews via 2 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/dcf1b77e-5ec4-4897-beef-c9c7cd494019/search_businesses?page=0&size=3&query=restaurantes&location=lima' \ -H 'X-API-Key: $PARSE_API_KEY'
Search businesses by keyword and location with pagination. Returns a paginated list of businesses with contact information, social media links, and addresses.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| size | integer | Results per page |
| queryrequired | string | Search keyword (e.g., 'inmobiliarias', 'restaurantes', 'abogados') |
| location | string | Location/city to search in |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"size": "integer - page size",
"total": "integer - total matching businesses",
"businesses": "array of business objects with id, name, product_type, slogan, description, detail_info, address, locality, latitude, longitude, phones, emails, whatsapp, website, facebook, instagram, youtube, messenger, logo_url, detail_url, all_addresses",
"total_pages": "integer - total pages available",
"results_count": "integer - number of results on this page"
},
"sample": {
"data": {
"page": 0,
"size": 3,
"total": 407,
"businesses": [
{
"id": "598429",
"name": "RESTAURANT HUANCHACO",
"emails": [
"[email protected]"
],
"phones": [
{
"number": "+1 (555) 012-3456",
"description": "Contáctenos",
"international": "+1 (555) 012-3456"
}
],
"slogan": "Restaurantes pescados y mariscos, comida norteña.",
"address": "Calle Rodolfo Beltrán 197",
"website": "https://www.restauranthuanchaco.com/",
"youtube": null,
"facebook": "https://www.facebook.com/restauranthuanchaco/",
"latitude": "-12.0876",
"locality": "La Victoria - Lima",
"logo_url": "https://www.paginasamarillas.com.pe/imagenes/pe/images/ad_id_4636/logo.gif",
"whatsapp": "https://wa.me/1555012-3456",
"instagram": null,
"longitude": "-77.0114",
"messenger": "https://www.facebook.com/messages/t/721070127928168",
"detail_url": "https://www.paginasamarillas.com.pe/empresas/restaurant-huanchaco/la-victoria-598429",
"description": "RESTAURANT HUANCHACO: La auténtica comida trujillana.",
"detail_info": "La auténtica comida trujillana.",
"product_type": "PREMIUM",
"all_addresses": null
}
],
"total_pages": 136,
"results_count": 3
},
"status": "success"
}
}About the paginasamarillas.com.pe API
The Páginas Amarillas Peru API provides access to business directory data from paginasamarillas.com.pe through 2 endpoints. Use search_businesses to query businesses by keyword and location, returning fields like address, locality, latitude, longitude, and contact links. Use get_business_detail to retrieve full records including phone arrays, email lists, rating, reviews, website, Facebook, and YouTube for any specific listing.
Endpoints and Data Coverage
The API exposes two endpoints. search_businesses accepts a required query string (e.g., 'restaurantes', 'abogados', 'inmobiliarias') and an optional location parameter to narrow results to a specific city or region. Results are paginated via page (0-indexed) and size parameters, and the response includes total, total_pages, and results_count fields so you can iterate through large result sets. Each business object in the businesses array carries an id, name, product_type, slogan, description, detail_info, address, locality, latitude, longitude, and a detail_url path used as input to the second endpoint.
Business Detail Fields
get_business_detail takes the url_path from a search_businesses result and returns the full record for that business. The response includes emails (array of strings), phones (array of objects each with number, international, and description), rating, reviews (with comments and rating sub-fields), website, facebook, youtube, and slogan. This makes it straightforward to build enriched contact sheets or CRM imports from Peruvian business data without stitching multiple sources together.
Geographic and Language Scope
All data is sourced from paginasamarillas.com.pe, which covers businesses operating in Peru. Queries and business names are in Spanish, consistent with the source directory. Location filtering targets Peruvian cities and localities, so queries like location='Lima' or location='Arequipa' narrow results to those areas.
- Build a lead generation tool for Peruvian B2B sales teams using phone and email fields from get_business_detail
- Geocode business locations in Lima or other Peruvian cities using latitude and longitude from search_businesses
- Aggregate and monitor ratings and reviews for local competitors in a specific industry vertical
- Populate a CRM with structured contact data including WhatsApp-linked phone numbers for Peruvian markets
- Map restaurant or hotel density across Peruvian districts by querying search_businesses with category keywords
- Cross-reference Facebook and website fields to identify businesses with active social media presence
- Build a sector directory by iterating search_businesses with industry keywords like 'abogados' or 'contadores'
| 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.pe offer an official developer API?+
What does the phones array in get_business_detail actually contain?+
phones array includes three fields: number (the local format), international (the E.164-style or international-dialing format), and description (a label such as 'móvil' or 'oficina'). A business may have multiple phone objects if it lists more than one contact number.Does search_businesses return opening hours?+
search_businesses. They are available in get_business_detail, which returns the full business record including hours alongside reviews, emails, and social media links. You call get_business_detail using the detail_url from a search result.Does the API cover business categories or industry taxonomy beyond the search keyword?+
query parameter in search_businesses. You can fork this API on Parse and revise it to add a category-listing endpoint if your use case requires browsing by predefined industry segments.How does pagination work in search_businesses, and are there limits on how deep you can page?+
page parameter and a size parameter. The response returns total, total_pages, and results_count so you can calculate the full range. Very deep pagination (high page numbers on broad queries) may return fewer results or empty pages depending on what the source directory indexes for that query.