PagineGialle Italy Business Leads Scraper

Here is one real result, with every field the actor returns:

{
  "businessName": "Osteria Macondo",
  "phone": "06 491425",
  "phones": ["06 491425"],
  "whatsapp": "+3906491425",
  "email": null,
  "website": null,
  "address": "Via dei Mille, 10 - 00185 Roma (RM)",
  "street": "Via dei Mille, 10",
  "postalCode": "00185",
  "city": "Roma",
  "province": "RM",
  "category": "ristoranti e trattorie",
  "rating": 3.9,
  "reviewCount": 1113,
  "services": ["Da asporto"],
  "description": "A Roma, Macondo, un angolo di passato nella contemporaneità.",
  "image": "https://wips.plug.it/scips/rsptqL5NLpWMzkM6kDMpSQ/img.italiaonline.it/0WOSX000008hVIT4A2_413936643_122098169636168392_2299361544610594047_n.png?a=rc&w=217&h=270&ssl=1",
  "verified": true,
  "url": "https://www.paginegialle.it/osteria-macondo-roma",
  "source": "PagineGialle",
  "observedAt": "2026-08-10T14:41:59.612Z"
}

The most complete PagineGialle Italy business leads scraper available. It returns every contact and profile field the Italian Yellow Pages exposes for each business, plus a parsed WhatsApp number and a split street/postal-code/province address, so you can build targeted call and outreach lists by category and city.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches PagineGialle (Italy's Yellow Pages) for a keyword or category in a given city, paginates through the results, and writes one normalized record per business to the run's dataset. Each record carries the phone numbers, a parsed WhatsApp number, the full address split into street, postal code, city, and province, plus category, rating, review count, services, description, and image. Missing source values are returned as null, never invented.

Quickstart

Open the actor, paste this into the input, and press Run. It returns 10 restaurants in Rome.

{
  "maxBusinesses": 10,
  "keyword": "ristoranti",
  "city": "roma"
}

Every input field is optional. Use an Italian keyword or category such as idraulici, hotel, avvocati, or parrucchieri, and any Italian city such as milano, napoli, or torino.

Input reference

Field	Type	Required	Default	Description
maxBusinesses	integer	no	10	Maximum businesses to collect (1 to 1000000).
keyword	string	no	ristoranti	What to search for, for example idraulici, hotel, avvocati, parrucchieri.
city	string	no	roma	Italian city or place to search in, for example milano, napoli, torino.

Output reference

One dataset item per business. Types: string, number, boolean, string[], or null when the source value is absent.

Field	Type	Description
businessName	string	Business name.
phone	string	Primary phone number.
phones	string[]	All phone numbers on the listing.
whatsapp	string	WhatsApp number in E.164 form, if published.
email	string	Email address, if published.
website	string	Website URL, if published.
address	string	Full address as displayed.
street	string	Street portion of the address.
postalCode	string	Postal code (CAP).
city	string	City.
province	string	Two-letter Italian province code, for example RM.
category	string	Business category.
rating	number	Average rating, if published.
reviewCount	integer	Number of reviews, if published.
services	string[]	Services or features the business lists.
description	string	Business description.
image	string	Listing image URL.
verified	boolean	true when the listing is a verified business.
url	string	Canonical PagineGialle listing URL.
source	string	Data source. Always PagineGialle.
observedAt	string	ISO 8601 timestamp of when the record was collected.

Example output record

Real record from a live run (input {"keyword": "ristoranti", "city": "roma", "maxBusinesses": 10}):

{
  "businessName": "Trattoria Pizzeria Dar Contadino",
  "phone": "06 9322312",
  "phones": ["06 9322312"],
  "whatsapp": null,
  "email": null,
  "website": null,
  "address": "Via Appia Nuova, 47 - 00041 Albano Laziale (RM)",
  "street": "Via Appia Nuova, 47",
  "postalCode": "00041",
  "city": "Albano Laziale",
  "province": "RM",
  "category": "ristoranti e trattorie",
  "rating": 4,
  "reviewCount": 143,
  "services": ["Parcheggio", "Da asporto", "Tavoli all'aperto"],
  "description": "TRATTORIA PIZZERIA DAL CONTADINO - Locale informale con ampie sale, ampio parcheggio e tavoli all'aperto ad Albano Laziale (RM).",
  "image": "https://wips.plug.it/scips/CX3OfpmowfIAizRE8ciEdg/img.italiaonline.it/0WOSX000008tEov4AE/IOL4YOU_1742295119909.jpg?a=rc&w=217&h=270&ssl=1",
  "verified": true,
  "url": "https://www.paginegialle.it/trattoria-pizzeria-dal-contadino-albano-laziale",
  "source": "PagineGialle",
  "observedAt": "2026-08-10T14:41:59.609Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~paginegialle-italy-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"ristoranti","city":"roma","maxBusinesses":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~paginegialle-italy-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"idraulici","city":"milano","maxBusinesses":100}'

Apify CLI:

apify call scrapers_lat/paginegialle-italy-scraper \
  --input '{"keyword":"avvocati","city":"napoli"}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per business returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 businesses per run. Upgrade for higher maxBusinesses.

FAQ and troubleshooting

A run returned 0 records. Why? The keyword or city matched nothing. Try a broader Italian keyword or a larger city. Zero-result runs are not charged.

Do all businesses have an email and website? No. These fields are filled only when the business has published them. Phone numbers are almost always present.

Which cities and categories can I search? Any Italian city name (roma, milano, napoli, torino, and more) with any Italian business keyword (ristoranti, idraulici, hotel, avvocati, parrucchieri).

What is the whatsapp field? When the listing publishes a WhatsApp contact, the actor normalizes it to E.164 form so you can act on it directly. It is null when none is published.

Is this an official PagineGialle tool? No. This actor is independent and reads only publicly available directory data. Use the results in accordance with the source's terms and applicable laws.

Related scrapers

• Paginas Amarillas Business Leads Scraper: LATAM Yellow Pages business leads.
• Google Maps Business Leads Scraper: Local businesses with contacts by keyword and area.
• Europages Suppliers Scraper: European B2B suppliers and manufacturers.
• Business Leads Scraper by City: Businesses with contacts by category and city.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with PagineGialle. Accesses only publicly available directory data. Use the results in accordance with the source's terms and applicable laws.