Pagine Gialle Scraper (Pay Per Result)

🇬🇧 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. | ## ⚙️ 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. ## 🛠 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. | ## ⚙️ 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. - 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