Paginas Amarillas Scraper

Scrape Spanish business listings from paginasamarillas.es by category, keyword, city, or a saved directory URL. Export paginasamarillas.es data to JSON, CSV, or Excel-compatible files, and use the structured dataset as a paginasamarillas.es API alternative for lead research, local market analysis, and directory monitoring.

The actor returns one flat row per unique listing. Search pages provide business names, public phone numbers, addresses, categories, descriptions, websites, profile links, and paid-placement signals; optional profile requests add fields such as opening hours, rating, review count, coordinates, email, logo, and social links when the profile publishes them.

What data can you extract from Paginas Amarillas?

The directory publishes different fields for different businesses. Search-card data is collected first. When scrapeDetails is enabled, the actor opens the associated public business profile to look for additional details. Empty values mean the page did not expose that field in the returned markup; they do not indicate that the business has no such information.

Field	Description	Example
listingId	Stable identifier derived from the profile URL.	195495346
slug	Business profile slug.	la-daniela-cuchilleros
name	Display name of the business.	La Daniela Cuchilleros
paginasAmarillasUrl	Public directory profile URL.	https://www.paginasamarillas.es/f/madrid/la-daniela-cuchilleros_195495346_000000002.html
isPremium	Whether the directory marks the result as a paid placement.	true
phone	First public phone number found.	913662018
phones	All phone numbers found on the listing and profile.	[ "913662018" ]
fax	Public fax number, when present.	null
email	Public email address, when present.	null
website	External business website.	http://www.tabernadeladaniela.com
social	Social profile URLs found on the page; directory-owned links can also appear.	[ "https://facebook.com/LADANIELACUCHILLEROS" ]
address	Formatted address as shown on the directory.	Calle de los Cuchilleros, 9 , 28005 , Madrid
street	Street name and number.	Calle de los Cuchilleros, 9
postalCode	Postal code.	28005
city	Locality shown in the address.	Madrid
region	Province or region, when present.	Madrid
country	Country associated with these Spain-only results.	Spain
latitude	Latitude from profile map data.	40.414341585
longitude	Longitude from profile map data.	-3.70799292
category	Main category shown on the search card.	`Cocina madrileña Cocina castellana
categories	List of directory categories associated with the result.	[ `"Cocina madrileña Cocina castellana
rating	Published rating, if the profile has one.	4
reviewCount	Published rating or review count.	1
hours	Opening hours grouped by weekday.	{"Monday":["12:30-17:00"]}
description	Public business description.	Especialista en cocido madrileño y besugo.
images	Public business image URLs found on the profile.	[ "https://multimedia.paginasamarillas.es/adsContentSrv/195495346-2-Gup2MMbbRj/5551a66d-884b-4e5d-aab0-d81dfad1c880/la-daniela-logo.jpg" ]
logo	Business logo URL, when published.	https://multimedia.paginasamarillas.es/adsContentSrv/195495346-2-Gup2MMbbRj/5551a66d-884b-4e5d-aab0-d81dfad1c880/la-daniela-logo.jpg
reviews	Review text excerpts present in profile markup.	[]
searchTerm	Keyword or start URL that generated the row.	restaurantes
scrapedAt	UTC timestamp for this collection.	2026-10-25T12:00:00Z

How to scrape Paginas Amarillas

1. Enter one or more Spanish business categories or keywords, such as restaurantes, fontaneros, or abogados.
2. Add one or more Spanish cities or provinces. Every term is searched in every location. Leave locations empty to run the category across Spain.
3. Set the maximum number of businesses and pages. Keep profile enrichment enabled to collect rating, hours, coordinates, and any extra public contact details.
4. Start the run. The actor reads directory result pages, opens profiles when requested, removes duplicate listings, and writes business rows to the dataset.
5. Download the dataset as JSON or CSV, or connect it to a scheduled data workflow.

You can also provide a paginasamarillas.es search URL or an individual business profile URL in startUrls. A search URL is paged from its current page; a profile URL creates one enriched business row. URLs on other hosts are rejected before any request is made.

Input

Name	Type	Default	Description
searchTerms	Array of strings	[ "restaurantes" ]	Categories or terms to search. The terms are combined with every location.
locations	Array of strings	[ "Madrid" ]	Spanish cities or provinces. An empty list means nationwide results.
startUrls	Array of URLs	None	Directory search or business profile URLs on paginasamarillas.es.
maxItems	Integer	50	Maximum unique businesses across the entire run.
scrapeDetails	Boolean	true	Open each profile to collect available rating, hours, coordinates, contact, and image data.
maxPages	Integer	20	Maximum pages to read per search. Each result page contains about 30 businesses.
maxConcurrency	Integer	5	Maximum concurrent network requests. Accepted values are 1 through 20.
proxy	Object	Platform proxy	Optional proxy configuration for cloud runs. Requests rotate sessions and can escalate to residential routing when blocked.

Example input

{
  "searchTerms": ["restaurantes", "cafeterias"],
  "locations": ["Madrid", "Barcelona"],
  "maxItems": 100,
  "maxPages": 5,
  "maxConcurrency": 5,
  "scrapeDetails": true
}

This example starts four searches: two terms across two locations. The actor stops after 100 unique listings even if the searches have more pages available. For a nationwide search, set locations to an empty array. For a quick run that only needs phone and address data, turn off scrapeDetails to skip profile requests.

Output example

This example is one row from the verified Madrid restaurant run. The sample is shortened only where the full field is not needed to show the output structure.

{
  "listingId": "195495346",
  "slug": "la-daniela-cuchilleros",
  "name": "La Daniela Cuchilleros",
  "paginasAmarillasUrl": "https://www.paginasamarillas.es/f/madrid/la-daniela-cuchilleros_195495346_000000002.html",
  "isPremium": true,
  "phone": "913662018",
  "phones": ["913662018"],
  "fax": null,
  "email": null,
  "website": "http://www.tabernadeladaniela.com?utm_campaign=paginasamarillas&utm_source=paginasamarillas&utm_medium=referral",
  "social": [
    "https://facebook.com/LADANIELACUCHILLEROS",
    "https://www.facebook.com/paginasamarillases/"
  ],
  "address": "Calle de los Cuchilleros, 9 , 28005 , Madrid",
  "street": "Calle de los Cuchilleros, 9",
  "postalCode": "28005",
  "city": "Madrid",
  "region": "Madrid",
  "country": "Spain",
  "latitude": 40.414341585,
  "longitude": -3.70799292,
  "category": "Cocina madrileña Cocina castellana | Restaurante",
  "categories": ["Cocina madrileña Cocina castellana | Restaurante"],
  "rating": 4,
  "reviewCount": 1,
  "hours": {
    "Monday": ["12:30-17:00", "20:30-00:00"],
    "Tuesday": ["12:30-17:00", "20:30-00:00"],
    "Wednesday": ["12:30-17:00", "20:30-00:00"],
    "Thursday": ["12:30-17:00", "20:30-00:00"],
    "Friday": ["12:30-17:00", "20:30-00:00"],
    "Saturday": ["13:00-17:30", "20:30-00:00"],
    "Sunday": ["13:00-17:30", "20:30-00:00"]
  },
  "description": "Especialista en cocido madrileño y besugo. Cerveza tirada al estilo antiguo. Vermut de barril. Imprescindible hacer reservas.",
  "images": [
    "https://multimedia.paginasamarillas.es/adsContentSrv/195495346-2-Gup2MMbbRj/5551a66d-884b-4e5d-aab0-d81dfad1c880/la-daniela-logo.jpg"
  ],
  "logo": "https://multimedia.paginasamarillas.es/adsContentSrv/195495346-2-Gup2MMbbRj/5551a66d-884b-4e5d-aab0-d81dfad1c880/la-daniela-logo.jpg",
  "reviews": [],
  "searchTerm": "restaurantes",
  "scrapedAt": "2026-10-25T16:54:56Z"
}

Use cases

• Sales teams can build a starting list of local businesses by category and city, then prioritize rows with a public phone number or website.
• Agencies can compare business coverage across multiple Spanish cities and trades using one consistent set of columns.
• Local search consultants can map directory categories, paid placements, public ratings, and business websites within a service area.
• Market researchers can estimate how many listed providers appear for a category and compare addresses, categories, and profile completeness.
• Franchise and location teams can collect nearby businesses for territory research, partner discovery, or site planning.
• Data operations teams can refresh public business directory rows on a schedule and compare later exports for changes.

Use the data to support research and prioritization. A directory listing is not proof that a business is currently open, accepts new customers, or has verified every published detail; confirm important facts with the business before relying on them.

How much does it cost to scrape Paginas Amarillas?

Estimate listing collection at $5 per 1,000 unique businesses. This rate is aligned with the prevailing price for comparable directory data. At that rate, 1,000 listings cost about $5, 5,000 cost about $25, and 10,000 cost about $50. These examples scale linearly with the number of unique rows returned.

The estimate covers the listing event and standard platform usage for a typical run. Your actual total can vary if the run uses more memory, takes longer, or escalates to a billed residential proxy. Profile enrichment makes additional requests but does not create extra dataset rows; set scrapeDetails to false when you only need the search-card fields. The actor stops at maxItems, which lets you choose a predictable result ceiling before a run starts.

For a small test, use maxItems: 50 and one search term with one city. At the same reference rate, 50 rows correspond to roughly $0.25 in listing events. A broader study can use several locations and a larger ceiling; reduce the cap if the combined term-by-location searches would otherwise return more data than you need. Check the run's usage and billing details for the final charge.

Tips for best results

• Use the category wording people would enter in the directory. Spanish terms such as fontaneros, electricistas, and restaurantes are useful starting points.
• Search a city and province using the spelling most commonly used locally. Accents are accepted in inputs and normalized for the directory URL.
• Keep maxItems at or below the number of records you plan to review. The cap applies across every search and prevents unexpectedly large exports.
• Increase maxPages when a category has enough results to reach beyond the first page. Pages are read in sequence from each search URL, and the actor stops when the page has no new records.
• Leave scrapeDetails enabled when opening hours, coordinates, rating, email, social links, or profile images matter. Disable it when a quick name-phone-address list is enough.
• Use a lower maxConcurrency if the site responds slowly or if the run is collecting many profiles. Raise it gradually for larger runs; the default of five is suitable for a typical search.
• Use startUrls when you already have an exact directory search or a list of profile pages. For a search URL, paging begins at the page number in that URL.
• The actor deduplicates by listing identifier across pages and search terms. A listing that matches two terms appears once, with the term that first produced it recorded in searchTerm.
• For a repeatable city comparison, keep the same terms, page limit, enrichment setting, and result ceiling across runs.

Limits

Search pages expose about 30 listings at a time. The actor follows numbered result pages up to maxPages, whose maximum is 400, and also stops when maxItems is reached. A category may have fewer results than the cap or may end before the requested page limit.

Paginas Amarillas returns server-rendered directory markup. Search cards contain the most consistent identity, phone, website, description, category, and address details. Rating, hours, coordinates, email, social profiles, images, logo, fax, and review text depend on what each business profile publishes. Some profile pages also render the directory's own social links; check account ownership before treating a social URL as belonging to the listed business. Missing email or review text is common and is returned as null or an empty list rather than guessed.

The current extraction is for the Spain domain paginasamarillas.es. It does not accept Latin American directory domains or unrelated directory sites. Search URL patterns, profile markup, pagination, and anti-bot behavior can change over time; if the site changes its page structure, some fields may become sparse until extraction is updated.

Profile enrichment requests one profile page per listing and therefore takes longer than search-card-only collection. A slow profile or temporary request failure does not discard a valid search-card row. A run that returns no business rows fails with a message asking you to check the term, city, or URL, so an empty successful dataset is not treated as a useful result.

Use with AI agents (MCP)

Add this actor to any MCP client (Claude, Cursor, VS Code, n8n and others) with one URL:

https://mcp.apify.com?tools=mlg14/paginasamarillas-scraper

Returns one dataset item per business with name, phone, address, website, opening hours, rating and coordinates when the profile publishes them. Keep results bounded with maxItems.

Prompt 1: "Find 30 restaurants in Madrid with phone numbers and addresses."

{
  "searchTerms": [
    "restaurantes"
  ],
  "locations": [
    "Madrid"
  ],
  "maxItems": 30,
  "scrapeDetails": false
}

Prompt 2: "Collect up to 50 plumbers in Valencia with full profile details."

{
  "searchTerms": [
    "fontaneros"
  ],
  "locations": [
    "Valencia"
  ],
  "maxItems": 50,
  "scrapeDetails": true
}

Prompt 3: "Get the full profile of this business on Paginas Amarillas."

{
  "startUrls": [
    {
      "url": "https://www.paginasamarillas.es/f/madrid/la-daniela-cuchilleros_195495346_000000002.html"
    }
  ],
  "maxItems": 1
}

FAQ

Is it legal to collect these listings? The actor reads public business directory pages. You are responsible for following the site's terms, applicable privacy and data-protection law, and the rules that apply to your use. Use public business information only for a lawful purpose, avoid personal-data misuse, and do not treat a public contact field as consent for unsolicited outreach.

Do I need a proxy? Cloud runs may need proxy routing if the directory challenges or blocks a request. The actor uses rotating request sessions and can escalate to residential routing after a block. A proxy does not guarantee access; very large jobs should be run with sensible page, item, and concurrency limits.

How fast is a run? A search-only run reads result pages and is usually quicker than an enriched run. With scrapeDetails on, profile pages are fetched concurrently, up to the maxConcurrency setting. Response times and the number of records determine the actual duration, so begin with a small cap when estimating a larger job.

Can I schedule or monitor a scrape? Yes. Schedule the actor through your automation environment and use run status, dataset links, and webhooks to monitor completion. Keep the input stable between runs when you want to compare coverage over time.

Can I export the results to a spreadsheet? Download the dataset as CSV or JSON. CSV can be opened by common spreadsheet applications, and JSON is useful for scripts and data pipelines. The hours, phones, social, categories, images, and reviews fields are arrays or objects; choose JSON if you need to preserve those nested values without flattening them.

Why is an email or rating empty? The directory does not publish every field for every business. The actor returns null for unavailable scalar fields and an empty array for lists with no public values. Profile enrichment can expose additional details, but it cannot fill information the page does not provide.

Can I scrape one business profile? Yes. Add the public profile URL to startUrls, leave the search settings at their defaults or clear them, and keep scrapeDetails enabled. The result uses the same flat output shape as a business found through search.

Does it support non-Spain sites? No. This actor accepts search and profile URLs on paginasamarillas.es. It does not target country-specific domains in Latin America or other yellow-page directories.

Integrations

Run the actor through its API, connect completion webhooks to your pipeline, or pass the dataset to a workflow automation service. CSV exports can feed spreadsheet applications; JSON can feed databases, dashboards, and custom applications. Schedule recurring runs for the categories and locations you monitor, and compare each completed dataset with the prior run to identify newly listed businesses or changed public details.

Support

Open an issue on the Issues tab; we reply within 24h and add fields on request. Include the input, the affected profile or search URL, and the field that needs attention. Do not include private credentials or personal information in an issue.