Páginas Amarillas Spain (Yellow Pages) Business Scraper

Scrape business listings from Páginas Amarillas Spain (paginasamarillas.es), the Spanish yellow pages, and get phone numbers, addresses, postal codes, websites, categories, GPS coordinates, opening hours, ratings, branch locations and more for every company. Type an activity and a city (for example fontaneros in Madrid) or paste a search, category, branch-list or business URL, press Start, and export the Spanish business leads as JSON, CSV or Excel, or call the actor as an API. Repeat runs skip businesses you already scraped, so monitoring new Spanish companies in a sector stays cheap.

Target website: paginasamarillas.es

✨ Features of this Páginas Amarillas business scraper

• Business listing extraction — name, category, activities, description, phone numbers, website, full address, province, coordinates, logo, rating and review count.
• Phone numbers without clicking "Ver teléfono" — the site hides the number behind a button, but it is already in the page data, so the scraper returns it for every result, even with business pages turned off.
• Business page details — opening hours, payment methods, cuisines (restaurants), brands, technical service brands, gallery photos, years advertising on Páginas Amarillas and additional info.
• Branch locations — every other branch of a company with its own page URL, address, coordinates and phone number, or paste a branch-list URL to scrape all branches as separate businesses.
• Search by activity and city — enter activities such as dentistas or abogados and an optional city; leave the city empty to search all of Spain.
• Pagination support — follows the result pages until your limit is reached or the results run out.
• Proxy support — uses Apify datacenter proxy by default, which the site requires.
• New businesses only (cache) — a cache project name skips businesses scraped in earlier runs, so scheduled runs fetch and pay for new ones only.
• No browser required — plain HTTP requests keep runs fast and cheap.

🚀 How to scrape Páginas Amarillas business data in 5 steps

1. Sign up for a free Apify account — includes $5 monthly credit.
2. Open the actor page and click Try for free.
3. Fill in the Input fields (a search term or a start URL is required).
4. Click Start and wait for the run to complete.
5. Download results from the Output tab in JSON, CSV, or Excel format.

You can also run this actor via the Apify API or integrate it directly into your workflows using Zapier, Make, or n8n.

💰 Pricing

This actor uses pay-per-result billing based on the compute units a run consumes.

• New Apify accounts include $5 of free monthly credit.
• It works over plain HTTP requests without a browser, so it costs significantly less to run than browser-based scrapers.
• Set a Cache project name on scheduled runs: businesses you already scraped are skipped and not charged (see below).
• Turning off Scrape business pages makes runs even cheaper (one request per 30 businesses instead of one per business).

🔧 Input configuration

Field	Type	Required	Default	Description
startUrls	array	—	[] (prefilled with a fontaneros in Madrid search)	Search URLs, category pages (/a/fontaneros/), branch lists (/c/name/id/1) or business pages (/f/.../name_id.html).
scrapeDetails	boolean	—	true	Open every business page for all phone numbers, full description, opening hours, brands, photos and other branch locations. Phone numbers and coordinates are returned even when this is off.
maxItems	integer	—	5	Maximum unique businesses saved for each search term or search URL.
cacheProjectName	string	—	—	Same name on each scheduled run returns only new businesses; cached ones are skipped, not charged and not counted. Records get changeType: new.
maxConcurrency	integer	—	5	Maximum number of pages fetched in parallel.
proxyConfiguration	object	—	{ "useApifyProxy": true }	Proxy settings. The site blocks requests without a proxy; datacenter proxy works.
searchTerms	array	—	[]	Business activities to search for, for example fontaneros, dentistas, abogados laboralistas. Each term is searched separately.
location	string	—	—	City or town to search in. Leave empty to search all of Spain. Only used together with search terms; start URLs ignore it.

In the Console, the search terms and location sit in the collapsible Search by keyword and location section. They are optional and only needed when you do not paste URLs; the location applies to the search terms only, never to start URLs.

How the cache saves money:

With Scrape business pages on, every business costs one extra page request on top of the search request. Without a cache, a daily run over the same search opens the same business pages again and pays for each result every time. With a Cache project name:

• The actor remembers every business it has saved in a key-value store named after your project, and keeps it between runs.
• Each run still reads the search result pages, which are cheap and hold about 30 businesses each. Businesses already in the cache are dropped right there, before their page is requested.
• Skipped businesses cost no page request and no result charge, and they do not count towards Max items per search. The limit is spent only on new businesses.
• A business URL you paste is skipped too if it is already cached.

For example, a search with 600 plumbers that gets 15 new ones a week pays for 15 results and 15 business pages on the next run instead of 600 of each.

Use a different project name per search you track, because each name has its own memory. A cached business is not scraped again, so later phone or address changes on it are not picked up.

Supported URL types:

• Search: https://www.paginasamarillas.es/search/fontaneros/all-ma/madrid/all-is/madrid/all-ba/all-pu/all-nc/1
• Category: https://www.paginasamarillas.es/a/fontaneros/ (searched across all of Spain)
• Business page: https://www.paginasamarillas.es/f/madrid/asistencia-hogar-24h_8DdsfCdjkf.html
• Branch list ("Ver más direcciones" of a business): https://www.paginasamarillas.es/c/yavoi-reparaciones/0012400000f1QsUAAU/1?la=40.429167938&lo=-3.678244907

📦 Páginas Amarillas scraper output data

Each business is one JSON record with the fields id, url, name, category, activities, description, about, phone, phones, website, address, streetAddress, postalCode, city, province, latitude, longitude, logoUrl, rating, reviewCount, isAdvertiser, isFeatured, adId, advertiserId, openingHours, paymentMethods, cuisines, additionalInfo, brands, technicalService, images, yearsOnDirectory, otherLocations, position, scrapedAt, searchUrl and, with a cache, changeType. phone and phones come from the data the site already puts in the page behind its "Ver teléfono" button, so they are filled even without opening each business page. otherLocations lists the branches of a chain with their own page URL, address, coordinates and phone, technicalService the brands serviced, images the gallery photos and yearsOnDirectory how many years the business has advertised on Páginas Amarillas. The dataset has 1 view: Overview, a compact table with the id, name, category, phone, website, address, city, province, coordinates, change type and URL.

Output at a glance:

Name	Category	Phone	Postal code	City	Lat, Lng
Yavoi Reparaciones	Multiservicios: empresas	696376485	28001	Madrid	40.429, -3.678
Reparaciones Inmediatas NCL	Multiservicios: empresas	910494507	28028	Madrid	40.422, -3.669
Fcn Funciona Reparaciones	Multiservicios: empresas	686024167	28001	Madrid	40.430, -3.678
Servi OK	Multiservicios: empresas	628781790	28041	Madrid	40.374, -3.719
ASISTENCIA HOGAR 24H	Multiservicios: empresas	910553918	28002	Madrid	40.441, -3.673

Sample output (raw JSON):

{
    "id": "0niALSBbef",
    "url": "https://www.paginasamarillas.es/f/madrid/yavoi-reparaciones_0niALSBbef.html",
    "name": "Yavoi Reparaciones",
    "category": "Multiservicios: empresas",
    "activities": ["Multiservicios: empresas"],
    "description": "Trabajos rápidos 24h/365d. Ahora con descuento especial.Unidades móviles en capital y provincia muy cerca de ti.SABEMOS REPARARLO. 35 años son la mejor garantía.",
    "about": "Información general:\nTrabajos Rápidos 24H/365D. Unidades móviles en capital y provincia muy cerca de ti. SABEMOS REPARARLO. 35 años son la mejor garantía.\n...",
    "phone": "696376485",
    "phones": ["696376485", "913096393"],
    "website": "http://www.yavoi.net/POSNAC/GENERICO/",
    "address": "Calle Gral. Pardiñas, 58, 28001, Madrid",
    "streetAddress": "Calle Gral. Pardiñas, 58",
    "postalCode": "28001",
    "city": "Madrid",
    "province": "Madrid",
    "latitude": 40.429167938,
    "longitude": -3.678244907,
    "logoUrl": "https://multimedia.paginasamarillas.es/adsContentSrv/20455390-0-0niALSBbef/7fc9dae9-1e5d-4ee3-bf56-9ab1925dd403/yavoireparaciones.png",
    "rating": null,
    "reviewCount": null,
    "isAdvertiser": true,
    "isFeatured": true,
    "adId": "S00627932_000",
    "advertiserId": "GReEW2So3FYL",
    "openingHours": null,
    "paymentMethods": null,
    "cuisines": null,
    "additionalInfo": ["Horario continuo: 24 HORAS"],
    "brands": ["ELCO", "SUPERSER"],
    "technicalService": ["EDESA", "FAGOR", "JUNKERS", "MIELE", "TEKA", "ZANUSSI", "BOSCH"],
    "images": ["https://multimedia.paginasamarillas.es/adsContentSrv/20455390-0-0niALSBbef/f29702f8-9151-43f2-8901-47b30414dcac/LOGOLISTA.jpg"],
    "yearsOnDirectory": 20,
    "otherLocations": [
        {
            "id": "DCp1aLxvXr",
            "url": "https://www.paginasamarillas.es/f/puig/yavoi-reparaciones_DCp1aLxvXr.html",
            "name": "Yavoi Reparaciones",
            "address": "Calle Miguel Servet, 92 , 46540 Puig, VALENCIA",
            "phone": "963173320",
            "latitude": 39.591544498,
            "longitude": -0.306588078
        }
    ],
    "position": 2,
    "scrapedAt": "2026-10-15T13:32:57.453Z",
    "searchUrl": "https://www.paginasamarillas.es/search/fontaneros/all-ma/all-pr/all-is/madrid/all-ba/all-pu/all-nc/1"
}

A restaurant page also fills rating (e.g. 4), reviewCount, openingHours (e.g. ["Mo 12:00-00:00", ...]), paymentMethods (e.g. ["Visa", "Paypal"]) and cuisines (e.g. ["Cocina gallega"]).

🐍 How to scrape Páginas Amarillas with Python, JavaScript or the API

Run the actor programmatically with the official Apify clients. Replace <YOUR_API_TOKEN> with the token from your Apify Console.

Python (pip install apify-client):

from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run = client.actor("confidential_gnat/paginasamarillas-business-scraper").call(run_input={
    "searchTerms": ["fontaneros"],
    "location": "Madrid",
    "maxItems": 50,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });

const run = await client.actor('confidential_gnat/paginasamarillas-business-scraper').call({
    searchTerms: ['fontaneros'],
    location: 'Madrid',
    maxItems: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

cURL — start a run and wait for the dataset:

curl -X POST "https://api.apify.com/v2/acts/confidential_gnat~paginasamarillas-business-scraper/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["fontaneros"], "location": "Madrid", "maxItems": 50}'

💡 What you can use Páginas Amarillas business data for

• B2B lead generation: build phone and website lists of Spanish businesses by activity and city.
• Sales territory planning with postal codes, provinces and GPS coordinates.
• Local market research: count and map competitors in a sector or town.
• Enriching a CRM with phone numbers, websites, opening hours and categories.
• Monitoring newly listed businesses in a sector with scheduled, cached runs.

Sales teams, marketing agencies, lead-generation services and market researchers working on the Spanish market use this data in sectors such as home services, legal, healthcare and hospitality.

⚠️ Limitations & known issues

• No email addresses — Páginas Amarillas does not publish business emails; contact goes through an on-site form.
• Phone numbers — the number behind the "Ver teléfono" button is read from the page data. A few results have no map marker and then only get a phone from their business page, so keep Scrape business pages on for the most complete phone lists.
• Sponsored results — the site mixes sponsored businesses from other activities or cities into results; they are kept as the site shows them.
• Proxy required — requests without a proxy are blocked by the website's bot protection.
• Province on business URLs — province is filled from search results; for business URLs given directly it stays null.

❓ Frequently asked questions

Can I scrape Páginas Amarillas legally?

This actor only collects business information that is publicly visible on paginasamarillas.es, with no login or private content. Scraping publicly available data is generally considered lawful (see hiQ Labs v. LinkedIn), but you are responsible for complying with the site's Terms of Service and laws such as GDPR, especially for phone numbers of sole traders.

What data does the Páginas Amarillas scraper return?

Name, category, description, phone numbers, website, street address, postal code, city, province, coordinates, logo, rating and advertiser flags from search results. With Scrape business pages on, you also get all phone numbers, activities, full description, opening hours, payment methods, cuisines, brands, technical service brands, photos, years on the directory and every other branch location with its phone and coordinates.

How many businesses can I scrape from one search?

maxItems limits unique businesses per search term or search URL. The actor follows result pages (about 30 businesses each) until it reaches that limit or the site returns an empty page; a city search such as plumbers in Madrid has several hundred results.

Do I need a proxy to scrape paginasamarillas.es?

Yes. The input defaults to Apify datacenter proxy, which works reliably; requests without a proxy are blocked. Switch to residential proxy only if you see repeated blocking.

How do I scrape Páginas Amarillas with Python?

Use the Python example above: call the actor with searchTerms and location, then iterate over the dataset items.

Can I run this Páginas Amarillas scraper on a schedule?

Yes, with Apify Schedules. Set the same Cache project name on every run: the actor drops businesses it already saved before opening their pages, so each run fetches, returns and charges for only new businesses, marked with changeType: new. See How the cache saves money above.

What output formats are supported?

JSON, CSV, Excel, XML and RSS, either from the Output tab or through the Apify API.

Does the scraper return phone numbers and emails?

Phone numbers, yes: Páginas Amarillas shows them only after a click on "Ver teléfono", but they are already in the page data, so the scraper returns them in phone and phones for every business. Emails are not published on the site (contact goes through a form), so use the website field to find an email on the business's own site.

🔗 Other actors you may find useful

Scraper	Description
🏢 BBB Emails & Info Scraper	Better Business Bureau businesses: phone, address, rating, accreditation, complaints and contacts.
🇩🇪 German Imprint (Impressum) Scraper	Company decision makers, legal name, address, emails and phones from any German Impressum page.
⛪ Church Finder Scraper	Church listings and profiles: name, denomination, address, phone, service times and ratings.
📋 Craigslist Listings Scraper	Craigslist classified listings in any city and category: title, price, location and photos.
🛍️ Mudah.my Classifieds Scraper	Malaysian classified ads: cars, property and marketplace listings with seller phone numbers.

💬 Support & contact

If you encounter any issues or have questions, please open an issue.

You can also find more of our actors on the Actor Flow page.