# Subito Product Scraper

Scrape titolo, prezzo, numero di telefono, ecc. from Subito.it list page with search result page URL.

- Template page: [https://www.octoparse.com/template/scraper-prodotti-subito](https://www.octoparse.com/template/scraper-prodotti-subito)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$14/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## 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 listing pages.

## Output

The current workflow extracts 15 fields, including `Titolo`, `URL_inserito`, `URL_pagina_annunci`, `caratteristica1`, `caratteristica2`, `caratteristica3`, `caratteristica4`, `caratteristica5`, `caratteristica6`, `categoria`, `numero_di_telefono`, `parola_chiave`, `posizione`, `prezzo`, `rivenditore`.

## 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 cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### urls

Required. urls Constraints: minItems=1; maxItems=100000; items.minLength=1; items.maxLength=10000.

## How to Use

## Subito Product Scraper

### Input
- **urls** (required): Enter one or more search result page URLs from Subito, one per line.

### How to Use
1. Open the template and select **Try it** or **Start**.
2. Enter the URLs in the `urls` field.
3. Run the task in the cloud.
4. Review the output rows and export or process the structured data.

### Output Fields
The template returns the following fields for each listing on the search result page:
- `URL_inserito`
- `parola_chiave`
- `categoria`
- `Titolo`
- `URL_pagina_annunci`
- `posizione`
- `prezzo`
- `caratteristica1`
- `caratteristica2`
- `caratteristica3`
- `caratteristica4`
- `caratteristica5`
- `caratteristica6`
- `rivenditore`
- `numero_di_telefono`

### Limitations
- The template collects data only from search result pages; it does not scrape full detail pages.
- Fields such as `caratteristica6`, `rivenditore`, and `numero_di_telefono` may be empty if the source record does not provide them.

### Pricing
- **$14 per 1,000 output lines** (billing based on the number of rows returned).

### Tips
- Start with one or a few URLs and review the returned rows before scaling.
- Use the most specific valid URLs to reduce unrelated or duplicate records.
- Use a stable field (e.g., `URL_inserito` or `Titolo`) 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

- [Amazon Japan Product Scraper](https://www.octoparse.com/template/amazon-japan-product-scraper)
- [Etsy Product Scraper (by URL)](https://www.octoparse.com/template/etsy-product-scraper-by-url)
- [MercadoLibre Product Details Scraper](https://www.octoparse.com/template/mercadolibre-detalles-scraper)
- [Amazon Product Scraper (for US)](https://www.octoparse.com/template/amazon-product-details-scraper)
- [Rakuten Product Review Scraper](https://www.octoparse.com/template/rakuten-product-review-scraper)

## Input Schema

```json
{
  "title": "Subito Product Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "urls": {
      "title": "urls",
      "description": "urls",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 100000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "urls"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "urls": [
    "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1"
  ]
}
```

Example 2

```json
{
  "urls": [
    "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1"
  ]
}
```

Example 3

```json
{
  "urls": [
    "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1"
  ]
}
```

Example 4

```json
{
  "urls": [
    "https://www.subito.it/annunci-campania/affitto-vacanze/case-vacanza/salerno/salerno/"
  ]
}
```

Example 5

```json
{
  "urls": [
    "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Titolo": {
      "type": "string",
      "description": ""
    },
    "URL_inserito": {
      "type": "string",
      "description": ""
    },
    "URL_pagina_annunci": {
      "type": "string",
      "description": ""
    },
    "caratteristica1": {
      "type": "string",
      "description": ""
    },
    "caratteristica2": {
      "type": "string",
      "description": ""
    },
    "caratteristica3": {
      "type": "string",
      "description": ""
    },
    "caratteristica4": {
      "type": "string",
      "description": ""
    },
    "caratteristica5": {
      "type": "string",
      "description": ""
    },
    "caratteristica6": {
      "type": "string",
      "description": ""
    },
    "categoria": {
      "type": "string",
      "description": ""
    },
    "numero_di_telefono": {
      "type": "string",
      "description": ""
    },
    "parola_chiave": {
      "type": "string",
      "description": ""
    },
    "posizione": {
      "type": "string",
      "description": ""
    },
    "prezzo": {
      "type": "string",
      "description": ""
    },
    "rivenditore": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Subito Product 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
{
  "Titolo": "smart forfour II 2015 1.0 Passion 71cv twinamic",
  "URL_inserito": "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1&o=1",
  "URL_pagina_annunci": "https://www.subito.it/auto/smart-forfour-ii-2015-1-0-passion-71cv-twinamic-roma-668097036.htm",
  "caratteristica1": "Usato",
  "caratteristica2": "06/2015",
  "caratteristica3": "64761 Km",
  "caratteristica4": "Benzina",
  "caratteristica5": "Automatico",
  "caratteristica6": "Euro 6",
  "categoria": "Auto",
  "numero_di_telefono": "0685872736",
  "parola_chiave": "smart",
  "posizione": "Roma(RM)",
  "prezzo": "9300 €",
  "rivenditore": "Rosati Auto"
}
```

Example 2

```json
{
  "Titolo": "Smart fortwo coupe PIU' DI 80 SMART DISPONIBILI PR",
  "URL_inserito": "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1&o=1",
  "URL_pagina_annunci": "https://www.subito.it/auto/smart-fortwo-coupe-piu-di-80-smart-disponibili-pr-roma-664756867.htm",
  "caratteristica1": "Usato",
  "caratteristica2": "06/2019",
  "caratteristica3": "35000 Km",
  "caratteristica4": "Benzina",
  "caratteristica5": "Automatico",
  "caratteristica6": "Euro 6",
  "categoria": "Auto",
  "numero_di_telefono": "0685870841",
  "parola_chiave": "smart",
  "posizione": "Roma(RM)",
  "prezzo": "10990 €",
  "rivenditore": "LSCAR"
}
```

Example 3

```json
{
  "Titolo": "Smart ForTwo 453 automatica",
  "URL_inserito": "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1&o=1",
  "URL_pagina_annunci": "https://www.subito.it/auto/smart-fortwo-453-automatica-roma-664504819.htm",
  "caratteristica1": "Usato",
  "caratteristica2": "02/2015",
  "caratteristica3": "103545 Km",
  "caratteristica4": "Benzina",
  "caratteristica5": "Automatico",
  "caratteristica6": "Euro 6",
  "categoria": "Auto",
  "numero_di_telefono": "0697624951",
  "parola_chiave": "smart",
  "posizione": "Roma(RM)",
  "prezzo": "10999 €",
  "rivenditore": "FeM CAR 23 S.R.L.S"
}
```

Example 4

```json
{
  "Titolo": "CASA VACANZE - ATTICO VISTA MARE",
  "URL_inserito": "https://www.subito.it/annunci-campania/affitto-vacanze/case-vacanza/salerno/salerno/?o=1",
  "URL_pagina_annunci": "https://www.subito.it/case-vacanza/casa-vacanze-attico-vista-mare-salerno-663573524.htm",
  "caratteristica1": "70 mq",
  "caratteristica2": "3",
  "caratteristica3": "7",
  "caratteristica4": "1",
  "caratteristica5": "",
  "caratteristica6": "",
  "categoria": "Case vacanza",
  "numero_di_telefono": "3476417542",
  "parola_chiave": "",
  "posizione": "Salerno(SA)",
  "prezzo": "1600 €",
  "rivenditore": ""
}
```

Example 5

```json
{
  "Titolo": "Smart ForFour Turbo Brabus Style",
  "URL_inserito": "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1&o=1",
  "URL_pagina_annunci": "https://www.subito.it/auto/smart-forfour-turbo-brabus-style-roma-654469864.htm",
  "caratteristica1": "Usato",
  "caratteristica2": "04/2019",
  "caratteristica3": "123800 Km",
  "caratteristica4": "Benzina",
  "caratteristica5": "Automatico",
  "caratteristica6": "Euro 6",
  "categoria": "Auto",
  "numero_di_telefono": "0697638470",
  "parola_chiave": "smart",
  "posizione": "Roma(RM)",
  "prezzo": "10900 €",
  "rivenditore": "SMG RENT"
}
```

## 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": "scraper-prodotti-subito",
  "taskName": "Subito Product Scraper",
  "parameters": "{\"urls\":[\"https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"urls\":[\"https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "scraper-prodotti-subito",
        "taskName": "Subito Product 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": "scraper-prodotti-subito",
  "taskName": "Subito Product Scraper",
  "parameters": "{\"urls\":[\"https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/?q=smart&o=1\"]}"
}
JSON
```

## MCP Setup

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