PagineGialle Italy Local Business Directory Scraper

Scrapes PagineGialle — Italy's incumbent yellow pages and the country's primary SMB contact directory — and returns a structured dataset of Italian business listings by category and comune (city/town), enriched with each listing's detail page: partita IVA, email, website, servizi (services offered), and accepted payment methods.

What you get

Field	Type	Description
listing_id	string	Unique listing id
name	string	Business name
category	string	Primary category as shown on the listing
categories_all	array	All categories/tags associated with the listing
street	string	Street address
postal_code	string	Postal (CAP) code
comune	string	Comune (city/town)
provincia	string	Province sigla (e.g. RM, MI)
region	string	Italian region
latitude	number	Latitude
longitude	number	Longitude
phone	string	Landline phone number(s), semicolon-separated if multiple
mobile	string	Mobile phone number(s), semicolon-separated if multiple
email	string	Email address (when published)
website	string	Business website (when published)
piva	string	Partita IVA — Italian VAT/business registration number
opening_hours	object	Opening hours by day of week
rating_avg	number	Average rating (0–5, when the listing has reviews)
rating_count	integer	Number of ratings
services	array	Services offered ("Servizi", when published)
payment_methods	array	Accepted payment methods (when published)
description	string	Listing description/tagline
is_paid_listing	boolean	Whether the listing is a paid/advertised placement
has_quote_cta	boolean	Whether a "request quote" call-to-action is present
listing_url	string	Canonical detail-page URL
source_query_category	string	The category search term used to reach this listing
source_query_comune	string	The comune search term used to reach this listing
scraped_at	string	Timestamp this record was collected

How it works

The actor searches PagineGialle by category × comune pairs (e.g. "idraulici" in "roma"), collects the listing cards from the results (paging through additional result pages when available), and follows each listing to its detail page for the fields the results page doesn't carry (partita IVA, email, website, servizi, payment methods).

Leave categories and comuni empty to run a broad default sweep across common Italian trade and professional categories and provincial-capital comuni covering all 20 regions. Supply your own categories / comuni to search specific business types and locations, or regions to scope the default comuni list to particular regions.

Input

Parameter	Type	Default	Description
categories	array of strings	— (broad default set)	PagineGialle category/business-type search terms (e.g. "idraulici", "avvocati", "ristoranti")
comuni	array of strings	— (broad default set)	Italian comune (city/town) names to search (e.g. "roma", "milano")
regions	array (select)	— (all regions)	Restrict the built-in comuni default to these Italian regions. Ignored if comuni is set
maxPagesPerQuery	integer	5	Cap on additional result pages followed per category × comune search
maxItems	integer	10	Maximum number of records to scrape

Example input

{
  "categories": ["idraulici"],
  "comuni": ["roma"],
  "maxItems": 200
}

Example output

{
  "listing_id": "88be49d2-a7da-449a-8757-08f7e42db359",
  "name": "Wave Impianti",
  "category": "Impianti idraulici e termoidraulici",
  "categories_all": ["Impianti idraulici e termoidraulici"],
  "street": "Via Tiburtina, 1072",
  "postal_code": "00156",
  "comune": "Roma",
  "provincia": "RM",
  "region": "Lazio",
  "latitude": 41.93232,
  "longitude": 12.5868,
  "phone": "06 33221417",
  "mobile": "376 2961468",
  "email": "info@waveimpianti.it",
  "website": "https://waveimpianti.it/",
  "piva": "15343341002",
  "opening_hours": {
    "Lunedì": ["08:30 - 18:30"],
    "Martedì": ["08:30 - 18:30"],
    "Mercoledì": ["08:30 - 18:30"],
    "Giovedì": ["08:30 - 18:30"],
    "Venerdì": ["08:30 - 18:30"]
  },
  "rating_avg": null,
  "rating_count": null,
  "services": ["Manutenzione impianti industriali", "Manutenzione impianti idraulici"],
  "payment_methods": [],
  "description": "Wave Impianti realizza impianti industriali e civili: elettrici, meccanici e termoidraulici, con soluzioni complete e ad alta efficienza.",
  "is_paid_listing": true,
  "has_quote_cta": false,
  "listing_url": "https://www.paginegialle.it/waveimpiantiesistemi-roma",
  "source_query_category": "idraulici",
  "source_query_comune": "roma",
  "scraped_at": "2026-09-01T15:43:11.438Z"
}

Notes

• email, website, piva, services, and payment_methods come from each listing's detail page and are only as complete as what the business has published there — not every listing lists all of them.
• rating_avg/rating_count are only present for listings that have reviews.
• Records per run: PagineGialle covers roughly 2.5 million Italian business listings across ~1,900 categories × ~8,000 comuni. A single run only needs a fraction of that (bounded by maxItems); pass a resumeCursor from a previous run's output to continue a large crawl where it left off, without recrawling records already collected.