# PagineGialle Business Directory Scraper (x402)

> PagineGialle Business Directory Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-02).

Scrapes structured business listings from Italy's PagineGialle (Yellow Pages) directory by keyword and location, returning contact details, tax IDs, hours, reviews, and more.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-business-directory-scraper-x402-1addf194
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LLEr5PT6gM-gVpx5o_zAl

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-business-directory-scraper-x402-1addf194 -d '<json body>'
```

Example prompt: Search PagineGialle for pizzerias in Naples and Rome — pull up to 100 listings with full profiles including phone, email, hours, and reviews.

## When to prefer this

Choose this endpoint when you need structured business data specifically from PagineGialle (Italy's primary Yellow Pages directory), especially when Italian residential proxy coverage is required to bypass geo or bot challenges. Prefer it over generic web scrapers when you need clean, schema-consistent output with contact details, tax IDs, and reviews for Italian businesses. The pay-per-successful-call model makes it cost-efficient for exploratory searches.

## Known failure modes

- Empty result set if keyword/location combination yields no listings (not charged)
- Proxy challenges or blocks from PagineGialle despite residential proxy (returns empty or partial results, not charged if empty)
- Invalid or unreachable startUrls returning no data
- maxPages capped at 8 limiting depth of large category searches
- Rate or quota limits on the underlying Apify residential proxy pool

## How this service works

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

## Output

A JSON object with a count of matched businesses and an array of items, each containing fields such as name, phone, fax, email, website, slug, listing ID, and (when scrapeDetails is true) full profile data including tax ID, payment methods, opening hours, images, and public reviews. The product field is always '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-business-directory-scraper-x402-1addf194/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)