# Pagine Bianche Shop List Scraper

Scrape name, address, URL, phone numbers, etc. of the shops on PagineBianche.it with keywords and locations.

- Template page: [https://www.octoparse.com/template/crawler-di-pagine-bianche](https://www.octoparse.com/template/crawler-di-pagine-bianche)
- Categories: Lead Generation
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from search-results pages.

## Output

The current workflow extracts 10 fields, including `Categoria`, `Descrizione`, `Indirizzo`, `Località`, `Nome_azienda`, `Parola_chiave`, `Servizio`, `Telefono1`, `Telefono2`, `URL_azienda`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Urls and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Urls

Required. URLs of search result list. Constraints: minItems=1; maxItems=100000; items.minLength=1; items.maxLength=100000.

## How to Use

# Pagine Bianche Shop List Scraper

Collects name, address, URL, phone numbers, and other listing fields from PagineBianche.it using keywords and locations.

**Source:** [Paginebianche](https://www.paginebianche.it/)

## Input

- **Urls** (required): Enter one or more values, one per line.

## Output Fields

`Parola_chiave`, `Località`, `Categoria`, `Nome_azienda`, `URL_azienda`, `Indirizzo`, `Descrizione`, `Telefono1`, `Telefono2`, `Servizio`

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Complete the input fields.
3. Choose a local or cloud run.
4. Review the output rows and export or process the structured data.

## Limitations

- Collects only the fields listed above from listing pages; does not add data not displayed by Paginebianche.
- `Telefono1`, `Telefono2`, and `Servizio` may be empty when the source record does not provide them.

## Tips

- Start with one or a few inputs and review returned rows before scaling.
- Use the most specific valid Urls to reduce unrelated or duplicate records.
- Use a stable identifier from the output fields (e.g., `URL_azienda`) as a deduplication key when available.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Pagine Gialle Shop List Scraper](https://www.octoparse.com/template/crawler-lista-aziende-paginegialle)
- [Pagine Gialle Shop Detail Scraper](https://www.octoparse.com/template/crawler-dettagli-negozi-paginegialle)
- [Kakao Map Shop List Scraper](https://www.octoparse.com/template/kakao-map-store-list-scraper)
- [Olympic Shop Data Scraper](https://www.octoparse.com/template/olympic-shop-data-scraper)
- [Etsy Shop Products Scraper](https://www.octoparse.com/template/etsy-shop-products-scraper)

## Input Schema

```json
{
  "title": "Pagine Bianche Shop List Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "urls": {
      "title": "Urls",
      "description": "URLs of search result list.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100000
      },
      "minItems": 1,
      "maxItems": 100000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "urls"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "urls": [
    "https://www.paginebianche.it/aziende?qs=agenzia viaggio&dv=Roma",
    "https://www.paginebianche.it/aziende?qs=studio legale&dv=Milano",
    "https://www.paginebianche.it/aziende?qs=ottica&dv=Genova"
  ]
}
```

Example 2

```json
{
  "urls": [
    "https://www.paginebianche.it/aziende?qs=agenzia viaggio&dv=Roma",
    "https://www.paginebianche.it/aziende?qs=studio legale&dv=Milano",
    "https://www.paginebianche.it/aziende?qs=ottica&dv=Genova"
  ]
}
```

Example 3

```json
{
  "urls": [
    "https://www.paginebianche.it/aziende?qs=agenzia viaggio&dv=Roma",
    "https://www.paginebianche.it/aziende?qs=studio legale&dv=Milano",
    "https://www.paginebianche.it/aziende?qs=ottica&dv=Genova"
  ]
}
```

Example 4

```json
{
  "urls": [
    "https://www.paginebianche.it/aziende?qs=agenzia viaggio&dv=Roma",
    "https://www.paginebianche.it/aziende?qs=studio legale&dv=Milano",
    "https://www.paginebianche.it/aziende?qs=ottica&dv=Genova"
  ]
}
```

Example 5

```json
{
  "urls": [
    "https://www.paginebianche.it/aziende?qs=agenzia viaggio&dv=Roma",
    "https://www.paginebianche.it/aziende?qs=studio legale&dv=Milano",
    "https://www.paginebianche.it/aziende?qs=ottica&dv=Genova"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Categoria": {
      "type": "string",
      "description": ""
    },
    "Descrizione": {
      "type": "string",
      "description": ""
    },
    "Indirizzo": {
      "type": "string",
      "description": ""
    },
    "Località": {
      "type": "string",
      "description": ""
    },
    "Nome_azienda": {
      "type": "string",
      "description": ""
    },
    "Parola_chiave": {
      "type": "string",
      "description": ""
    },
    "Servizio": {
      "type": "string",
      "description": ""
    },
    "Telefono1": {
      "type": "string",
      "description": ""
    },
    "Telefono2": {
      "type": "string",
      "description": ""
    },
    "URL_azienda": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Pagine Bianche Shop List Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Categoria": "\n                            Ottica, lenti a contatto ed occhiali\n                        ",
  "Descrizione": "\n            Dal 1970 a Genova, professionalità e competenza in optometria, lenti a contatto specialistiche, occhiali da vista e da sole e ipovisione, in Piazza Giusti 46R\n        ",
  "Indirizzo": "\n            \n                Piazza Giusti, 42/46/R - 16143 Genova (GE)\n            \n        ",
  "Località": "Genova",
  "Nome_azienda": "\n                            \n                                \n                                    \n\n    Ottica Polverini\n\n\n                                \n                            \n                        ",
  "Parola_chiave": "\n\t\t\t\t\n\t\t\t\t\n                    \n                        \n                            Ottica\n                        \n                    \n                \n\t\t\t\t",
  "Servizio": "Consegna a domicilio",
  "Telefono1": "010 514778",
  "Telefono2": "010 5184091",
  "URL_azienda": "https://www.paginebianche.it/scheda/otticapolverini-genova"
}
```

Example 2

```json
{
  "Categoria": "\n                            Agenzie viaggi e turistiche\n                        ",
  "Descrizione": "\n            Shopping Travel Viaggiare360 è Tour Operator specializzato nella vendita di pacchetti viaggio, prenotazioni alberghiere e appartamenti, biglietteria.\n        ",
  "Indirizzo": "\n            \n                Viale di Trastevere, 231/B - 00153 Roma (RM)\n            \n        ",
  "Località": "Roma",
  "Nome_azienda": "\n                            \n                                \n                                    \n\n    Shopping Travel - Viaggiare360\n\n\n                                \n                            \n                        ",
  "Parola_chiave": "\n\t\t\t\t\n\t\t\t\t\n                    \n                        \n                            Agenzia viaggio\n                        \n                    \n                \n\t\t\t\t",
  "Servizio": "Orario continuato",
  "Telefono1": "06 65678303",
  "Telefono2": "335 6360497",
  "URL_azienda": "https://www.paginebianche.it/scheda/mademaservice-roma"
}
```

Example 3

```json
{
  "Categoria": "\n                            Avvocati - studi\n                        ",
  "Descrizione": "\n            Consulenza e assistenza legale per privati e imprese a Novara, con soluzioni concrete e professionali per ogni esigenza. ⚖️\n        ",
  "Indirizzo": "\n            \n                Corso Felice Cavallotti, 40 - 28100 Novara (NO)\n            \n        ",
  "Località": "Milano",
  "Nome_azienda": "\n                            \n                                \n                                    \n\n    Lanzo&Partners Studio Legale\n\n\n                                \n                            \n                        ",
  "Parola_chiave": "\n\t\t\t\t\n\t\t\t\t\n                    \n                        \n                            Studio legale\n                        \n                    \n                \n\t\t\t\t",
  "Servizio": "",
  "Telefono1": "0321 1828030",
  "Telefono2": "335 1315992",
  "URL_azienda": "https://www.paginebianche.it/scheda/lanzopartnersstudiolegale-milano"
}
```

Example 4

```json
{
  "Categoria": "\n                            Agenzie viaggi e turistiche\n                        ",
  "Descrizione": "\n            Mister Holiday si trova a Roma , potete star certi che ogni cliente riceverà un'attenzione personalizzata per garantire la migliore esperienza di viaggio.\n        ",
  "Indirizzo": "\n            \n                Via di Boccea, 635/b - 00166 Roma (RM)\n            \n        ",
  "Località": "Roma",
  "Nome_azienda": "\n                            \n                                \n                                    \n\n    Agenzia Viaggi Mister Holiday Roma Boccea\n\n\n                                \n                            \n                        ",
  "Parola_chiave": "\n\t\t\t\t\n\t\t\t\t\n                    \n                        \n                            Agenzia viaggio\n                        \n                    \n                \n\t\t\t\t",
  "Servizio": "Buoni pasto",
  "Telefono1": "327 8336259",
  "Telefono2": "06 83954626",
  "URL_azienda": "https://www.paginebianche.it/scheda/agenziaviaggimisterholidayboccea"
}
```

Example 5

```json
{
  "Categoria": "\n                            Studio legale\n                        ",
  "Descrizione": "\n            Lo Studio Notarile Varsallona, a Milano in Viale Caldara, offre servizi di notariato ed autentificazione di particolare qualità ed affidabilità.\n        ",
  "Indirizzo": "\n            \n                Viale Emilio Caldara, 24 - 20122 Milano (MI)\n            \n        ",
  "Località": "Milano",
  "Nome_azienda": "\n                            \n                                \n                                    \n\n    Studio Notaio Avv. Anita Varsallona\n\n\n                                \n                            \n                        ",
  "Parola_chiave": "\n\t\t\t\t\n\t\t\t\t\n                    \n                        \n                            Studio legale\n                        \n                    \n                \n\t\t\t\t",
  "Servizio": "",
  "Telefono1": "02 5511078",
  "Telefono2": "02 5511153",
  "URL_azienda": "https://www.paginebianche.it/scheda/studionotaioavvanitavarsallona-milano"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "crawler-di-pagine-bianche",
  "taskName": "Pagine Bianche Shop List Scraper",
  "parameters": "{\"urls\":[\"https://www.paginebianche.it/aziende?qs=agenzia viaggio&dv=Roma\",\"https://www.paginebianche.it/aziende?qs=studio legale&dv=Milano\",\"https://www.paginebianche.it/aziende?qs=ottica&dv=Genova\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"urls\":[\"https://www.paginebianche.it/aziende?qs=agenzia viaggio&dv=Roma\",\"https://www.paginebianche.it/aziende?qs=studio legale&dv=Milano\",\"https://www.paginebianche.it/aziende?qs=ottica&dv=Genova\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "crawler-di-pagine-bianche",
        "taskName": "Pagine Bianche Shop List Scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "crawler-di-pagine-bianche",
  "taskName": "Pagine Bianche Shop List Scraper",
  "parameters": "{\"urls\":[\"https://www.paginebianche.it/aziende?qs=agenzia viaggio&dv=Roma\",\"https://www.paginebianche.it/aziende?qs=studio legale&dv=Milano\",\"https://www.paginebianche.it/aziende?qs=ottica&dv=Genova\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `crawler-di-pagine-bianche`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/crawler-di-pagine-bianche.json)
- [Manifest](https://www.octoparse.com/templates/crawler-di-pagine-bianche-manifest.json)