🟡 Paginas Amarillas Scraper

Search Paginas Amarillas across eight Latin American country sites and get back a clean B2B lead list: phone numbers, WhatsApp, email, website, full address and coordinates, social links, real per-day opening hours, and rating. No login, no account, no browser extension.

Point it at a category or keyword in Argentina, Colombia, Peru, Chile, El Salvador, Guatemala, Panama, or Nicaragua, and get export-ready data for sales prospecting, lead generation, market research, and CRM enrichment.

🎯 Who uses it?

📇 Sales & lead-gen teams

Build targeted business lists by category and city, with phone, email, WhatsApp, and website in one export.

📞 Telemarketing & field sales

Filter to businesses that are open right now, checked against their own country's clock, so a call list is never full of closed doors.

📈 Market & territory researchers

Map competitors and suppliers by city and region, with coordinates and every branch a business publishes.

🗂️ CRM and data teams

Match businesses by name, phone, or website and pull social links, hours, and descriptions to enrich existing records.

✨ What it does

• Search: by category or keyword, across eight country sites, optionally narrowed to one city.
• Full profile detail: real per-day opening hours (every shift a business publishes, including a separate lunch and dinner shift on the same day), services, keywords, videos, rating, and the featured review.
• Contact-quality filters: keep only businesses with an email, a phone, a website, or a published WhatsApp number.
• Open-right-now filter: keep only businesses open at the exact moment the run executes, checked in their own country's timezone.
• Minimum-rating filter: keep only businesses at or above a chosen star rating.
• Premium filter: keep only paid-advertiser listings, which tend to be more active and carry richer profiles.
• Paste-a-link shortcut: give a real results page instead of picking a country and term.

Missing source values are returned as null, never invented.

Why this scraper

• An open-right-now filter that gets split shifts right. A restaurant with a lunch shift and a separate dinner shift is correctly marked closed in the gap between them, not open all day just because it opens twice.
• A rating you can actually filter on. The published star rating comes straight from its real source field and can be used as a minimum-rating cutoff.
• Eight country sites, one consistent field set. Argentina, Colombia, Peru, Chile, El Salvador, Guatemala, Panama, and Nicaragua, all normalized the same way.
• Contact-quality filters built in. Every exported row can be a lead you can act on immediately, not a list you still have to clean.
• Full branch coverage. Every branch a business publishes comes back with its own address, phones, and map link.

How it compares

Capability	This actor	Closest full-featured competitor	Other Paginas Amarillas actors
Countries covered	8	9	1 to 3, one actor per country
Per-day opening hours with every shift	yes	flat hours field	rare
Open-right-now filter	yes	no	no
Minimum-rating filter	yes	no	no
Contact-quality filters (email, phone, website, WhatsApp)	yes	yes	rare
Multi-branch addresses with per-branch phones	yes	yes	no
Search and full profile detail in one run	yes	yes	some split into two actors

📦 What data you get

Entity	Useful fields
Business	Name, category, slogan, description, product type, premium flag, logo, gallery images, and the listing and canonical URLs.
Contact	Primary and all phone numbers (display and dialable), WhatsApp number and link, email(s), website, and every social link the business publishes.
Address & branches	Street, city, region, country, coordinates, map link, and every branch with its own address, phones, and map link.
Hours & rating	Per-day opening hours with every shift, an open-right-now flag, the published star rating, and the featured review with its author.
Extras	Services, products, keywords, and video links the business lists.

Every record includes observedAt (UTC). Download your dataset from Apify as CSV, JSON, Excel, or XML.

💡 Use cases

📇 A WhatsApp-ready outreach list

{ "searchTerm": "abogados", "country": "ar", "location": "buenos aires", "onlyWithWhatsapp": true, "maxBusinesses": 200 }

📞 A call list of businesses open right now

{ "searchTerm": "hoteles", "country": "pe", "onlyOpenNow": true, "minRating": "4", "maxBusinesses": 100 }

📈 Map every restaurant in a city

{ "searchTerm": "restaurantes", "country": "co", "location": "medellin", "maxBusinesses": 500 }

⚙️ How the input is organised

Maximum businesses sits at the very top, since it applies no matter what you're doing. Below it, the form is split into three numbered sections:

Section	What it's for
1 · What to search for	A category or keyword plus a country, or a real results URL pasted in directly.
2 · What to include	Whether to fetch each listing's full profile detail.
3 · Filters (optional)	Contact-quality, premium, open-right-now, and minimum-rating filters. Leave them all off to get everything.

Apify Free plan: every run is limited to a fixed 10-row sample. Upgrade your Apify plan to run your own settings.

🛡️ Limits & responsible use

This Actor reads only publicly available Paginas Amarillas listings. It never signs in and never accesses anything gated behind an account.

Business contact details are public directory data, not personal browsing history. Use them in line with Paginas Amarillas' terms and applicable law; prefer B2B outreach and market research over spam.

If a search matches nothing, the run writes a single row with an error field instead of failing silently.

📧 Contact

Need a scraper for a different site, or found something wrong with this one? norm.data.scrapers@gmail.com

Local development

bun install
bun test                # offline: normalization and input parsing, against real fixtures
bun run src/main.ts     # reads storage/key_value_stores/default/INPUT.json