🇬🇧 For English version, scroll below.
🇮🇹 Per la versione italiana, continua a leggere.

Web Scraper di Pagine Gialle 🇮🇹

Estrai dati strutturati da PagineGialle.it — la principale directory italiana online per aziende, professionisti e fornitori di servizi.
Perfetto per lead generation, SEO locale, analisi di mercato e outreach B2B nel mercato italiano.

Questo scraper supera il limite di 200 risultati, supporta la paginazione automatica, la ricerca per CAP, input flessibili e l’uso di proxy per un'estrazione affidabile e scalabile.

🌍 A chi è rivolto?

A chiunque abbia bisogno di accedere a dati strutturati di aziende italiane.

Che tu sia uno sviluppatore, un analista, un marketer o un imprenditore, questo strumento ti aiuta a estrarre e organizzare le informazioni da una delle fonti più affidabili in Italia.

Esempi di utilizzo:

• Lead generation e creazione di database clienti in Italia
• Analisi di mercato o studio della concorrenza per città/regioni
• SEO locale con schede attività verificate da PagineGialle.it
• Arricchimento dati con contatti, indirizzi e link social
• Scraping etico a fini professionali, accademici o commerciali

🚀 Caratteristiche principali

• Modalità di ricerca flessibili – Cerca per categoria + città, categoria + CAP, oppure incolla direttamente gli URL di ricerca personalizzati.
• Supera il limite dei 200 risultati – Utilizza una lista di CAP per suddividere le ricerche e accedere a tutti i risultati disponibili.
• Paginazione intelligente – Esegue la paginazione automaticamente e può essere configurato per limitare il numero di pagine per ricerca o i risultati totali di ogni esecuzione.
• Output strutturato – Dati ricchi e strutturati, esportabili in JSON, CSV, Excel, XML, RSS, HTML, ecc.
• Alta affidabilità – Supporto per i proxy di Apify, proxy di terze parti e gestione automatica dei blocchi.

📥 Configurazione Input

Campo	Tipo	Descrizione
mode	string	(Obbligatorio) Metodo di ricerca: auto, searchUrl, categoryCity, categoryPostcode. Vedi suggerimenti sotto.
searchUrls	array	Uno o più URL copiati da ricerche effettuate manualmente su PagineGialle.it. Usato con mode: searchUrl o auto.
categories	array	Categorie in italiano (es. "ristoranti", "avvocati"). Usato con categoryCity, categoryPostcode, o auto.
cities	array	Nomi delle città italiane (es. "Milano", "Roma"). Usato con categoryCity o auto.
postcodes	array	CAP italiani (es. "20121"). Utile per suddividere le ricerche e superare il limite di risultati. Usato con categoryPostcode o auto.
maxItems	integer	Numero massimo di risultati da estrarre. Imposta a 0 per nessun limite.
maxPagesPerQuery	integer	Numero massimo di pagine da analizzare per ogni query. Valore predefinito 0 = nessun limite.
proxySettings	object	Configura proxy Apify o personalizzati per evitare blocchi.

⚙️ Come si usa

1. Scegli il mode e compila i campi categories, cities, postcodes e/o searchUrls a seconda delle necessità.
2. Avvia lo scraper tramite Apify Console o API.
3. Scarica i dati aziendali puliti e strutturati in formato JSON, Excel o nel formato che preferisci.

📤 Output

Ogni risultato contiene:

• Nome azienda, categoria, descrizione
• Email, telefono, WhatsApp
• Indirizzo, CAP, città, provincia, regione
• Coordinate GPS, rating, link al profilo
• Sito web, logo, social media
• URL di ricerca, metadati e dati aggiuntivi

💡 Suggerimenti

• Usa mode: auto se hai più input e vuoi che il sistema decida automaticamente.
• Preferisci la ricerca per categoria + CAP se vuoi ottenere più di 200 risultati.
• In alternativa, puoi cercare manualmente su PagineGialle.it (usando la barra di ricerca e i filtri) e incollare l’URL della ricerca in searchUrls.
• Imposta maxItems per evitare sprechi e testare su campioni più piccoli.
• Abilita i proxy per una raccolta dati più stabile e continua.

🛠 Supporto

Hai bisogno di aiuto o personalizzazioni?

• 📬 Contatta lo sviluppatore
• 🐞 Segnala un bug
• ✨ Suggerisci funzionalità

---

🇮🇹 Italian version above.
🇬🇧 English version below.

Pagine Gialle Scraper - Italian Yellow Pages Scraper 🇮🇹

Scrape structured business data from PagineGialle.it — Italy’s Yellow Pages, the top directory for local companies, professionals, and service providers. Ideal for lead generation, local SEO, market intelligence, and B2B outreach in the Italian market. This actor bypasses the platform’s 200-result limit and supports smart pagination, postcode-level targeting, flexible input modes, and proxy rotation for smooth, scalable data extraction.

🌍 Who is this for?

This actor is for anyone who needs structured access to Italian business data.
Whether you're a developer, analyst, marketer, entrepreneur, or data provider, this tool helps you extract and organize information from one of the most widely used business directories in Italy.

Use cases include:

• Lead generation and contact list building for companies in Italy
• Market research or competitor analysis focused on Italian regions or cities
• Local SEO projects that require verified listings from PagineGialle.it
• Data enrichment with contact details, addresses, and online presence
• Scraping Italian websites for professional, academic, or commercial use

No matter your background or goals, if you're working with Italian business information—this scraper is built for you.

🚀 Key Features

• Flexible Input Modes – Search by category + city, category + postcode, or paste your own filtered search URLs from the PagineGialle site.
• Bypass Result Limits – PagineGialle displays a maximum of 200 results per search, even if more exist. This scraper can use postcode-level queries to bypass that restriction and access the full dataset.
• Accurate Pagination – Automatically handles pagination and supports page/item limits.
• Structured Data Output – Get phone numbers, websites, emails, addresses, ratings, geo-coordinates, social links, and more — delivered in your preferred format: JSON, CSV, Excel, XML, HTML table and more.
• High Reliability – Proxy rotation and blocking mitigation built-in.

📥 Input Configuration

Field	Type	Description
mode	string	(Required) Defines the search method: auto (all modes combined based on your input), searchUrl (use custom PagineGialle search URLs), categoryCity (search by category and city), categoryPostcode (search by category and postal codes). See Tips for guidance.
searchUrls	array	One or more URLs copied directly from PagineGialle.it after performing a manual search. Used when mode is set to searchUrl or auto.
categories	array	List of business categories in italian (e.g., "ristoranti", "avvocati", "hotel"). Used when mode is set to categoryCity, categoryPostcode, or auto.
cities	array	List of city names in italian (e.g., "Milano", "Roma", "Napoli"). Used when mode is set to categoryCity or auto.
postcodes	array	List of Italian postal codes (CAP) (e.g., "20121", "00185"). Helps bypass 200-result limit and refine searches Used when mode is set to categoryPostcode or auto.
maxItems	integer	Maximum number of results to scrape. Use to control budget or test small runs. Default is 0 which means no limit.
maxPagesPerQuery	integer	Maximum number of pages to scrape per search query. Default is 0 which means no limit.
proxySettings	object	Proxy configuration for Apify Proxy or custom proxies. Improves scraping reliability and reduces blocks.

⚙️ How to Use

1. Choose your mode, and fill out categories, cities, postcodes, or searchUrls as needed.
2. Run the scraper via Apify Console or API.
3. Download clean, structured business data in JSON, Excel, or your preferred format.

📤 Output Format

Each result includes:

Field	Type	Description
company_name	string	Name of the business.
business_category	string	Category under which the business is listed.
description	string	Description or promotional text of the business.
website	string	URL to the business’s website.
email	string	Primary email contact.
phone	string	Primary phone number.
secondary_phone	string	Additional phone number if available.
whatsapp	string	WhatsApp contact number.
location.address	string	Street address.
location.postcode	string	Postal code.
location.city	string	City name.
location.province	string	Province abbreviation.
location.region	string	Region name.
location.latitude	number	Latitude coordinate.
location.longitude	number	Longitude coordinate.
ratings.average	number	Average rating (1–5).
ratings.count	number	Total number of ratings.
profile_url	string	Link to the business’s PagineGialle profile.
search_url	string	URL of the search that led to this listing.
logo_url	string	URL to the business logo image.
social_links.facebook	string	Link to the business's Facebook page.
social_links.instagram	string	Link to the business's Instagram page.
meta	object	Contains technical metadata about each result
additional_data	object	Contains supplementary information collected from the listing

💡 Tips

• Choose the right mode based on your input: use auto to let the scraper decide based on your inputs. Use categoryCity or categoryPostcode for structured searches based on business category and location, or searchUrl if you’re pasting full URLs from the PagineGialle website.
• You can combine multiple categories and locations in one run.
• To extract more than 200 results per search, prefer using multiple postcodes input.
• For full control over your search, run a query directly on the PagineGialle website and copy the URL from your browser’s address bar into the searchUrls field.
• Enable Apify Proxy to reduce blocking and improve scraping stability.
• Use maxItems to keep your runs within budget or to sample data before scaling.

🛠 Maintenance & Support

This actor is maintained and updated regularly.

Have a suggestion, found a bug, or need a customization?

• 📬 Contact the developer
• 🐞 Report a bug or issue
• ✨ Suggest a feature or custom scraper

Keywords: italy, italian business scraper, paginegialle.it, lead generation, scraper Italia, aziende italiane, elenco attività, contatti commerciali, scraping directory