# Pagine Gialle Shop Detail Scraper

Scrape information (indirizzo, valutazione, telefono, etc.) of the shops from PagineGialle.it using the shop pages URLs.

- Template page: [https://www.octoparse.com/template/crawler-dettagli-negozi-paginegialle](https://www.octoparse.com/template/crawler-dettagli-negozi-paginegialle)
- Categories: Directories, 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 detail pages.

## Output

The current workflow extracts 19 fields, including `Astratto`, `Caratteristiche_e_servizi`, `Categorie`, `Codice_fiscale`, `Descrizione`, `Indirizzo`, `Nome_negozio`, `Numero_telefono`, `Orari_di_apertura`, `P_IVA`, `Prodotti`, `Recensioni_totali`, `Servizio1`, `Servizio2`, `Servizio3`, `URL_Sito_Web`, `URL_immagine`, `URL_negozio`, `Valutazione`.

## 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 Detail pages URLs (up tp 10) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Detail pages URLs (up tp 10)

Required. the URLs of the company detail pages on paginagialle.it Constraints: minItems=1; maxItems=1000; items.minLength=1; items.maxLength=5000.

## How to Use

# Pagine Gialle Shop Detail Scraper – Usage Guide

## Overview
This template collects shop details (address, rating, phone, etc.) from PagineGialle.it using shop page URLs. Data source: [Paginegialle](https://www.paginegialle.it/).

## Pricing
Currently no per-line charge. Octoparse plan or resource limits may still apply.

## Input
- **Detail pages URLs (up tp 10)** (required): Enter one or more values, one per line.

## How to Use
1. Open the template and select **Try it** or **Start**.
2. Complete the required **Detail pages URLs (up tp 10)** field.
3. Choose a local or cloud run.
4. Review the returned rows, then export or process the structured data.

## Output
The scraper returns a structured row for each source URL, using the template’s Italian-labeled detail-page fields (e.g., shop name, address, phone, description, services, opening hours, tax IDs, categories, rating, image URL, website URL). Fields that the source page does not provide are left empty.

## Automation and Export
- Schedule recurring runs locally or in the cloud and export rows to CSV, Excel, JSON, databases, or cloud storage.
- Use Octoparse OpenAPI or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates) for reporting or AI workflows.
- Scheduling and API access may require a paid Octoparse plan.
- For local scheduled runs, keep your computer and Octoparse open.

## Limitations
- The scraper collects only the detail-page fields shown in the template output; it does not add data that Paginegialle does not display.
- Fields such as `Recensioni_totali`, `URL_immagine`, and `URL_Sito_Web` can be empty when the source record does not provide them.

## Tips
- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid Detail page URLs to reduce unrelated or duplicate records.
- Use a stable URL or identifier from the returned record as the deduplication key when available.

## Notes

Se il modello non funziona bene, non esitare di informarci dei parametri che hai inserito all'indirizzo email template@octoparse.com

## 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 Bianche Shop List Scraper](https://www.octoparse.com/template/crawler-di-pagine-bianche)
- [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 Gialle Shop Detail Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "detail_pages_URLs": {
      "title": "Detail pages URLs (up tp 10)",
      "description": "the URLs of the company detail pages on paginagialle.it",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "detail_pages_URLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "detail_pages_URLs": [
    "https://www.paginegialle.it/osteriagigino"
  ]
}
```

Example 2

```json
{
  "detail_pages_URLs": [
    "https://www.paginegialle.it/osteriagigino"
  ]
}
```

Example 3

```json
{
  "detail_pages_URLs": [
    "https://www.paginegialle.it/osteriagigino"
  ]
}
```

Example 4

```json
{
  "detail_pages_URLs": [
    "https://www.paginegialle.it/osteriagigino"
  ]
}
```

Example 5

```json
{
  "detail_pages_URLs": [
    "https://www.paginegialle.it/osteriagigino"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Astratto": {
      "type": "string",
      "description": ""
    },
    "Caratteristiche_e_servizi": {
      "type": "string",
      "description": ""
    },
    "Categorie": {
      "type": "string",
      "description": ""
    },
    "Codice_fiscale": {
      "type": "string",
      "description": ""
    },
    "Descrizione": {
      "type": "string",
      "description": ""
    },
    "Indirizzo": {
      "type": "string",
      "description": ""
    },
    "Nome_negozio": {
      "type": "string",
      "description": ""
    },
    "Numero_telefono": {
      "type": "string",
      "description": ""
    },
    "Orari_di_apertura": {
      "type": "string",
      "description": ""
    },
    "P_IVA": {
      "type": "string",
      "description": ""
    },
    "Prodotti": {
      "type": "string",
      "description": ""
    },
    "Recensioni_totali": {
      "type": "string",
      "description": ""
    },
    "Servizio1": {
      "type": "string",
      "description": ""
    },
    "Servizio2": {
      "type": "string",
      "description": ""
    },
    "Servizio3": {
      "type": "string",
      "description": ""
    },
    "URL_Sito_Web": {
      "type": "string",
      "description": ""
    },
    "URL_immagine": {
      "type": "string",
      "description": ""
    },
    "URL_negozio": {
      "type": "string",
      "description": ""
    },
    "Valutazione": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Pagine Gialle Shop Detail 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
{
  "Astratto": "",
  "Caratteristiche_e_servizi": "",
  "Categorie": "",
  "Codice_fiscale": "",
  "Descrizione": "",
  "Indirizzo": "",
  "Nome_negozio": "403 ERROR",
  "Numero_telefono": "",
  "Orari_di_apertura": "",
  "P_IVA": "",
  "Prodotti": "",
  "Recensioni_totali": "",
  "Servizio1": "",
  "Servizio2": "",
  "Servizio3": "",
  "URL_Sito_Web": "",
  "URL_immagine": "",
  "URL_negozio": "https://www.paginegialle.it/osteriagigino",
  "Valutazione": ""
}
```

Example 2

```json
{
  "Astratto": "Osteria Gigino di Genova in 27/R, v. Romana della Castagna con le pareti piene di quadri con cui i pittori d'epoca, ambiente sobrio e rustico allo stesso tempo.",
  "Caratteristiche_e_servizi": "",
  "Categorie": "",
  "Codice_fiscale": "",
  "Descrizione": "Osteria Gigino di Genova in 27/R, v. Romana della Castagna con le pareti piene di quadri con cui i pittori d'epoca, ambiente sobrio e rustico allo stesso tempo.\n\t\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\tDescrivendo un po' il locale, entrando si nota subito la tipologia: osteria classica con le pareti piene di quadri con cui i pittori dell’epoca a volte pagavano i loro pranzi, ambiente sobrio e rustico allo stesso tempo... L’osteria si divide in tre sale. La prima subito come si entra(quando non si entra direttamente dal portone del caseggiato) dove una volta era posizionato il bancone della mescita vini, non molto grande ma accogliente per ospitare riunioni di lavoro o di famiglia. La seconda un po’ più grande(dove si giocava a carte e biliardo) adatta per piccoli ricevimenti, dove sono in mostra le fotografie con i personaggi famosi dell’epoca del “Gigino”. La terza(la più intima), piccolina dove, salendo 3 gradini, si è a contatto con l’oste. Ah, dimenticavo, per entrare in osteria occorre suonare il campanello. Il menu ricco e ricercato offre patanegra, jamon serrano, cotto al tartufo, ecc., passando da una cucina tradizionale ligure ad una toscana: chiaramente il pesto, il tocco e lo stocche(su ordinazione) non mancano mai sulle nostre tavole.",
  "Indirizzo": "Via Romana della Castagna, 27/R - \n16148\n\nGenova (GE)",
  "Nome_negozio": "Osteria Gigino",
  "Numero_telefono": "+39 339 8732013",
  "Orari_di_apertura": "[\"Su 12:30 - 15:30, 20:00 - 23:59\",\"Mo 20:00 - 23:59\",\"Tu 20:00 - 23:59\",\"We 20:00 - 23:59\",\"Th 20:00 - 23:59\",\"Fr 20:00 - 23:59\",\"Sa 12:30 - 15:30, 20:00 - 23:59\"]",
  "P_IVA": "03475630103",
  "Prodotti": "",
  "Recensioni_totali": "\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t153\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\trecensioni\n\t\t\t\t\t\t",
  "Servizio1": "",
  "Servizio2": "",
  "Servizio3": "",
  "URL_Sito_Web": "https://www.osteriagigino.com/",
  "URL_immagine": "",
  "URL_negozio": "https://www.paginegialle.it/osteriagigino",
  "Valutazione": "4.1"
}
```

Example 3

```json
{
  "Astratto": "Osteria Gigino di Genova in 27/R, v. Romana della Castagna con le pareti piene di quadri con cui i pittori d'epoca, ambiente sobrio e rustico allo stesso tempo.",
  "Caratteristiche_e_servizi": "",
  "Categorie": "",
  "Codice_fiscale": "",
  "Descrizione": "Osteria Gigino di Genova in 27/R, v. Romana della Castagna con le pareti piene di quadri con cui i pittori d'epoca, ambiente sobrio e rustico allo stesso tempo.\n\t\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\tDescrivendo un po' il locale, entrando si nota subito la tipologia: osteria classica con le pareti piene di quadri con cui i pittori dell’epoca a volte pagavano i loro pranzi, ambiente sobrio e rustico allo stesso tempo... L’osteria si divide in tre sale. La prima subito come si entra(quando non si entra direttamente dal portone del caseggiato) dove una volta era posizionato il bancone della mescita vini, non molto grande ma accogliente per ospitare riunioni di lavoro o di famiglia. La seconda un po’ più grande(dove si giocava a carte e biliardo) adatta per piccoli ricevimenti, dove sono in mostra le fotografie con i personaggi famosi dell’epoca del “Gigino”. La terza(la più intima), piccolina dove, salendo 3 gradini, si è a contatto con l’oste. Ah, dimenticavo, per entrare in osteria occorre suonare il campanello. Il menu ricco e ricercato offre patanegra, jamon serrano, cotto al tartufo, ecc., passando da una cucina tradizionale ligure ad una toscana: chiaramente il pesto, il tocco e lo stocche(su ordinazione) non mancano mai sulle nostre tavole.",
  "Indirizzo": "Via Romana della Castagna, 27/R - \n16148\n\nGenova (GE)",
  "Nome_negozio": "Osteria Gigino",
  "Numero_telefono": "+39 339 8732013",
  "Orari_di_apertura": "[\"Su 12:30 - 15:30, 20:00 - 23:59\",\"Mo 20:00 - 23:59\",\"Tu 20:00 - 23:59\",\"We 20:00 - 23:59\",\"Th 20:00 - 23:59\",\"Fr 20:00 - 23:59\",\"Sa 12:30 - 15:30, 20:00 - 23:59\"]",
  "P_IVA": "03475630103",
  "Prodotti": "",
  "Recensioni_totali": "\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t152\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\trecensioni\n\t\t\t\t\t\t",
  "Servizio1": "",
  "Servizio2": "",
  "Servizio3": "",
  "URL_Sito_Web": "https://www.osteriagigino.com/",
  "URL_immagine": "",
  "URL_negozio": "https://www.paginegialle.it/osteriagigino",
  "Valutazione": "4.2"
}
```

Example 4

```json
{
  "Astratto": "Osteria Gigino di Genova in 27/R, v. Romana della Castagna con le pareti piene di quadri con cui i pittori d'epoca, ambiente sobrio e rustico allo stesso tempo.",
  "Caratteristiche_e_servizi": "",
  "Categorie": "",
  "Codice_fiscale": "",
  "Descrizione": "Osteria Gigino di Genova in 27/R, v. Romana della Castagna con le pareti piene di quadri con cui i pittori d'epoca, ambiente sobrio e rustico allo stesso tempo.\n\t\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\tDescrivendo un po' il locale, entrando si nota subito la tipologia: osteria classica con le pareti piene di quadri con cui i pittori dell’epoca a volte pagavano i loro pranzi, ambiente sobrio e rustico allo stesso tempo... L’osteria si divide in tre sale. La prima subito come si entra(quando non si entra direttamente dal portone del caseggiato) dove una volta era posizionato il bancone della mescita vini, non molto grande ma accogliente per ospitare riunioni di lavoro o di famiglia. La seconda un po’ più grande(dove si giocava a carte e biliardo) adatta per piccoli ricevimenti, dove sono in mostra le fotografie con i personaggi famosi dell’epoca del “Gigino”. La terza(la più intima), piccolina dove, salendo 3 gradini, si è a contatto con l’oste. Ah, dimenticavo, per entrare in osteria occorre suonare il campanello. Il menu ricco e ricercato offre patanegra, jamon serrano, cotto al tartufo, ecc., passando da una cucina tradizionale ligure ad una toscana: chiaramente il pesto, il tocco e lo stocche(su ordinazione) non mancano mai sulle nostre tavole.",
  "Indirizzo": "Via Romana della Castagna, 27/R - \n16148\n\nGenova (GE)",
  "Nome_negozio": "Osteria Gigino",
  "Numero_telefono": "+39 339 8732013",
  "Orari_di_apertura": "[\"Su 11:00 - 15:00, 19:00 - 23:59\",\"Tu 19:00 - 23:59\",\"We 19:00 - 23:59\",\"Th 19:00 - 23:59\",\"Fr 19:00 - 23:59\",\"Sa 11:00 - 15:00, 19:00 - 23:59\"]",
  "P_IVA": "03475630103",
  "Prodotti": "",
  "Recensioni_totali": "\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t151\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\trecensioni\n\t\t\t\t\t\t",
  "Servizio1": "",
  "Servizio2": "",
  "Servizio3": "",
  "URL_Sito_Web": "https://www.osteriagigino.com/",
  "URL_immagine": "",
  "URL_negozio": "https://www.paginegialle.it/osteriagigino",
  "Valutazione": "4.1"
}
```

Example 5

```json
{
  "Astratto": "Osteria Gigino di Genova in 27/R, v. Romana della Castagna con le pareti piene di quadri con cui i pittori d'epoca, ambiente sobrio e rustico allo stesso tempo.",
  "Caratteristiche_e_servizi": "",
  "Categorie": "",
  "Codice_fiscale": "",
  "Descrizione": "Osteria Gigino di Genova in 27/R, v. Romana della Castagna con le pareti piene di quadri con cui i pittori d'epoca, ambiente sobrio e rustico allo stesso tempo.\n\t\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\tDescrivendo un po' il locale, entrando si nota subito la tipologia: osteria classica con le pareti piene di quadri con cui i pittori dell’epoca a volte pagavano i loro pranzi, ambiente sobrio e rustico allo stesso tempo... L’osteria si divide in tre sale. La prima subito come si entra(quando non si entra direttamente dal portone del caseggiato) dove una volta era posizionato il bancone della mescita vini, non molto grande ma accogliente per ospitare riunioni di lavoro o di famiglia. La seconda un po’ più grande(dove si giocava a carte e biliardo) adatta per piccoli ricevimenti, dove sono in mostra le fotografie con i personaggi famosi dell’epoca del “Gigino”. La terza(la più intima), piccolina dove, salendo 3 gradini, si è a contatto con l’oste. Ah, dimenticavo, per entrare in osteria occorre suonare il campanello. Il menu ricco e ricercato offre patanegra, jamon serrano, cotto al tartufo, ecc., passando da una cucina tradizionale ligure ad una toscana: chiaramente il pesto, il tocco e lo stocche(su ordinazione) non mancano mai sulle nostre tavole.",
  "Indirizzo": "Via Romana della Castagna, 27/R - \n16148\n\nGenova (GE)",
  "Nome_negozio": "Osteria Gigino",
  "Numero_telefono": "+39 339 8732013",
  "Orari_di_apertura": "[\"Su 11:00 - 15:00, 19:00 - 23:59\",\"Tu 19:00 - 23:59\",\"We 19:00 - 23:59\",\"Th 19:00 - 23:59\",\"Fr 19:00 - 23:59\",\"Sa 11:00 - 15:00, 19:00 - 23:59\"]",
  "P_IVA": "03475630103",
  "Prodotti": "",
  "Recensioni_totali": "\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t149\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\trecensioni\n\t\t\t\t\t\t",
  "Servizio1": "",
  "Servizio2": "",
  "Servizio3": "",
  "URL_Sito_Web": "https://www.osteriagigino.com/",
  "URL_immagine": "",
  "URL_negozio": "https://www.paginegialle.it/osteriagigino",
  "Valutazione": "4.1"
}
```

## 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-dettagli-negozi-paginegialle",
  "taskName": "Pagine Gialle Shop Detail Scraper",
  "parameters": "{\"detail_pages_URLs\":[\"https://www.paginegialle.it/osteriagigino\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"detail_pages_URLs\":[\"https://www.paginegialle.it/osteriagigino\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "crawler-dettagli-negozi-paginegialle",
        "taskName": "Pagine Gialle Shop Detail 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-dettagli-negozi-paginegialle",
  "taskName": "Pagine Gialle Shop Detail Scraper",
  "parameters": "{\"detail_pages_URLs\":[\"https://www.paginegialle.it/osteriagigino\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `crawler-dettagli-negozi-paginegialle`, 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-dettagli-negozi-paginegialle.json)
- [Manifest](https://www.octoparse.com/templates/crawler-dettagli-negozi-paginegialle-manifest.json)
