# Changelog of PagineGialle Scraper (`emastra/pagine-gialle-scraper`) Actor

- **URL**: https://apify.com/emastra/pagine-gialle-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/emastra/pagine-gialle-scraper.md

## Changelog

### 2.1 (2026-10-29)

#### New fields

- `vat_number` — the Italian VAT number (partita IVA), 11 digits.
- `business_category_code` — PagineGialle's code for the business category.
- `phone_e164` — the primary phone in international format (for example `+39065812270`).
- `mobile_phone` — the first Italian mobile number found among the phones and WhatsApp numbers.
- `whatsapp_url` — a click-to-chat link (`https://wa.me/…`) for the first WhatsApp number.
- `opening_hours` — weekly opening hours in one text field, Monday to Sunday (for example
  `Mon 09:00-13:00, 14:00-18:00; …; Sun closed`).

#### Breaking changes

If you read the dataset through an integration, update it for these changes:

- **Removed fields:**
  - `has_email`, `has_phone`, `has_mobile_phone`, `has_whatsapp`, `has_website`, `has_social`:
    check whether the matching field is empty instead, or use `contact_channels`. `has_mobile_phone`
    is replaced by `mobile_phone`.
  - `secondary_phone`: use `phones[1]`.
  - `query_strategy`: it was an exact copy of `query_input_type`.
- **New field order:** fields, and the columns of CSV/Excel exports, are now grouped as identity,
  contacts, online presence, location, details, lead summary, then query and source. `profile_url`
  is near the top; `profile_id` is near the end.
- **Output tab:** the dataset is now called "Results" and shows all fields; the partial views
  (Overview, Leads, Location, Query attribution) were removed.

#### Improvements

- `business_category` and `description` no longer contain HTML (PagineGialle highlights the search
  term, e.g. `<strong>RISTORANTI</strong>`); an all-capitals category becomes "Ristoranti e
  trattorie".
- `website_domain` is now filled for websites published without `https://`.
- Phone numbers that differ only in spacing (`3791 056837` / `379 1056837`) are no longer listed twice.
- Lower price: $2.50 per 1,000 records ($2.25 on Bronze, $2.00 on Silver and higher).
- No more free-plan result limits.

#### Fixes

- `searchUrls` accept only `paginegialle.it` and its subdomains. Lookalike hosts are rejected.
- A search URL with a different `output` parameter (for example `output=html`) no longer fails.
- If none of the search URLs is valid and there are no categories/locations, the run now fails with a
  clear "No valid searches" error instead of finishing with an empty dataset.