# PagineGialle Italian Business Directory Scraper

> PagineGialle Italian Business Directory Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-02).

Scrapes structured business listings from PagineGialle (Italian Yellow Pages), returning contact details, hours, reviews, and tax IDs for businesses matching keyword and location searches.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/paginegialle?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/paginegialle-italian-business-directory-scraper-70c72484
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6ola3dn1meakk0DEK6pjV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability paginegialle-italian-business-directory-scraper-70c72484 -d '<json body>'
```

Example prompt: Search PagineGialle for up to 50 Italian restaurants in Rome and Milan, fetch their full profiles including phone numbers, emails, opening hours, and tax IDs — use residential Italian proxies and scrape up to 8 pages per search.

## When to prefer this

Choose this endpoint when you need structured business contact data specifically from the Italian market via PagineGialle. It is the right choice for lead generation, market research, or directory building focused on Italy, especially when you need tax IDs, payment methods, or detailed business profiles not available from generic search engines. It handles anti-bot challenges automatically with residential Italian proxies and only charges for successful runs.

## Known failure modes

- Empty results if search terms or locations yield no PagineGialle matches
- Anti-bot challenges blocking scraping even with residential proxies, returning empty runs (not charged)
- Invalid or inaccessible startUrls returning no data
- maxPages cap of 8 limits total results per query
- Residential proxy unavailability causing session failures
- Rate limiting by PagineGialle for high-volume scrapes

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count and an array of business items, each with fields such as name, phone, fax, email, website, slug, listingId, and (when scrapeDetails is true) full description, tax ID, accepted payment methods, opening hours, images, and public reviews. The product field is set to 'paginegialle'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "proxy": {
   "type": "object",
   "default": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
     "RESIDENTIAL"
    ]
   },
   "description": "Residential Italian proxy is the default because the site challenges many datacenter sessions."
  },
  "maxItems": {
   "type": "integer",
   "default": 50,
   "minimum": 1,
   "description": "Maximum unique businesses across all searches and URLs."
  },
  "maxPages": {
   "type": "integer",
   "default": 8,
   "maximum": 8,
   "minimum": 1,
   "description": "Each search page has up to 25 results. The site currently exposes at most eight pages per query."
  },
  "locations": {
   "type": "array",
   "description": "Italian cities, comuni, or specific districts. Required with searchTerms."
  },
  "startUrls": {
   "type": "array",
   "description": "Direct PagineGialle search or business profile URLs. Can be combined with keyword searches."
  },
  "searchTerms": {
   "type": "array",
   "description": "Business categories or keywords. Each term is searched in every location."
  },
  "scrapeDetails": {
   "type": "boolean",
   "default": true,
   "description": "Fetch each profile for full description, tax ID, payment methods, hours, images, and public reviews. Search results already include many contact fields."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "fax": null,
    "name": null,
    "slug": null,
    "email": null,
    "phone": null,
    "phones": null,
    "website": null,
    "listingId": null
   }
  ],
  "product": "paginegialle"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/paginegialle-italian-business-directory-scraper-70c72484/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)