# Subito.it Cars & Automotive Scraper (`epicscrapers/subito-automotive-scraper`) Actor

Scrape Subito.it cars, motorcycles, vans, campers, boats, and vehicle parts. Extract prices, mileage, year, specs, photos, location, seller details, and optional phone data for market research, dealer monitoring, and lead generation.

- **URL**: https://apify.com/epicscrapers/subito-automotive-scraper.md
- **Developed by:** [Epic Scrapers](https://apify.com/epicscrapers) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 vehicle listing scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Subito Automotive Scraper

> **English version:** scroll down to [English](#english).

Puoi usare Subito Automotive Scraper per creare sistemi di avviso, svolgere ricerche di mercato o per qualsiasi altro progetto di tuo interesse.

### Esempio di risultato

Questo esempio include tutti gli arricchimenti opzionali. Ogni arricchimento viene fatturato separatamente, quindi puoi disattivare quelli che non ti servono per ridurre i costi.

Consulta l'[esempio JSON completo nella sezione inglese](#heres-an-example-result).

### Quali dati puoi raccogliere?

Ogni risultato può includere:

- titolo dell'annuncio, descrizione completa, URL e data di pubblicazione
- prezzo numerico e formattato
- marca, modello, data di immatricolazione, chilometraggio, carburante e cambio
- condizione del veicolo, carrozzeria, numero di posti, potenza ed emissioni, se disponibili
- città, provincia e regione
- tipo di venditore e nome del venditore o concessionario
- tutti gli URL delle immagini disponibili
- numero di telefono del venditore opzionale
- indirizzo, orari di apertura, logo e sito web del concessionario opzionali
- specifiche tecniche dettagliate, dotazioni, dimensioni, consumi ed emissioni opzionali

Subito potrebbe non restituire sempre tutti i dati. In questi casi, restituiamo campi vuoti.

### Casi d'uso comuni

- **Monitoraggio dei prezzi delle auto usate:** confronta i prezzi richiesti per marca, modello, anno, chilometraggio e regione.
- **Monitoraggio dell'inventario dei concessionari:** controlla nuovi annunci, disponibilità e variazioni di prezzo.
- **Ricerca di mercato:** analizza l'offerta regionale, le tendenze dei carburanti, l'età dei veicoli e il chilometraggio.
- **Generazione di lead:** raccogli informazioni pubbliche sui venditori professionali per contatti conformi alla legge.
- **Avvisi e automazione:** pianifica le ricerche e invia i nuovi dati a Google Sheets, Make, Zapier, webhook o alla tua API.

### Configurazione

Puoi impostare tutti i filtri desiderati sul sito di Subito e copiare qui l'URL. Puoi anche usare la ricerca per parole chiave, che offre un ampio elenco di filtri ed è l'opzione consigliata.

Inizia con un'esecuzione ridotta e modifica i filtri fino a ottenere esattamente i risultati desiderati.

Ecco un esempio di input:

```json
{
  "searchQuery": "fiat panda",
  "category": "auto",
  "region": "lazio",
  "minPrice": 5000,
  "maxPrice": 20000,
  "yearFrom": 2018,
  "maxMileage": 80000,
  "fuelType": "benzina",
  "gearbox": "manuale",
  "sortOrder": "datedesc",
  "maxResultPerQuery": 100
}
```

Attiva solo i dati aggiuntivi che ti servono:

- **Numeri di telefono:** tenta di recuperare il numero di telefono pubblico del venditore.
- **Dettagli del negozio:** aggiunge le informazioni disponibili per i venditori professionali, come indirizzo, orari, logo e sito web.
- **Specifiche tecniche:** aggiunge le specifiche e le dotazioni disponibili del veicolo.

### Domande frequenti

#### È necessario un account Subito o una chiave API?

No. L'Actor raccoglie dati di annunci disponibili pubblicamente.

#### Posso estrarre un solo annuncio?

Sì. Aggiungi il suo URL diretto di Subito in **Start URLs**.

#### Posso monitorare nuove auto o variazioni di prezzo?

Sì. Salva l'input e pianifica l'esecuzione periodica dell'Actor. Usa l'URL dell'annuncio e gli attributi del veicolo per confrontare i dataset nel tempo.

#### Perché mancano alcuni campi?

I venditori non forniscono tutti gli attributi in ogni annuncio. Anche i dati opzionali relativi a telefono, concessionario e specifiche tecniche possono non essere disponibili.

#### Come posso esportare i risultati?

Scarica il dataset in formato JSON, CSV, Excel, XML o HTML. Puoi anche accedervi tramite l'API di Apify o collegare l'Actor ad altre applicazioni.

### Esclusione di responsabilità

*Questo Actor è uno strumento indipendente e non è affiliato, approvato o sponsorizzato da Subito.it. Usalo solo per scopi leciti e rispetta i termini di Subito.it, le norme applicabili sulla protezione dei dati e le leggi locali. I dati pubblici degli annunci possono contenere dati personali. Assicurati di avere una base giuridica valida prima di raccoglierli o utilizzarli.*

***

## English

You can use the Subito automotive scraper for building alert systems, market research, or whatever interests you.

### Here's an example result

> This example has all optional enrichments enabled. They are billed separately, so you can turn off the ones you do not need to reduce costs.

```json
{
  "request_url": "ricerca-diretta",
  "category": "Motori",
  "sub_category": "Auto",
  "type": "In vendita",
  "publication_date": {
    "iso": "2026-09-22T12:19:05.011Z",
    "date": "2026-09-22",
    "time": "12:19:05",
    "timestamp": 1790079545011,
    "local": "2026-09-22 14:19:05"
  },
  "advertiser_type": "azienda",
  "advertiser_name": "fmg auto",
  "page_url": "https://www.subito.it/auto/fiat-panda-cross-0-9-twinair-turbo-s-s-4x4-frosinone-661697272.htm",
  "title": "Fiat Panda Cross 0.9 TwinAir Turbo S&S 4x4",
  "description": "Fiat Panda Twin-Air Cross 4x4 \n\n\nAnno 03/2019\nKm 110000\nUfficiale Italiana \nCambio Manuale\nAlimentazione Benzina \nEuro 6\n4x4 \nAdatta a Neopatentati \nOttimo Stato \nPronta consegna\nQualsiasi prova\nFinanziamenti in sede\nAccettiamo permute\n\n\nVI ASPETTIAMO NEL NOSTRO AUTOSALONE A FONTANA LIRI (FR)\nFMG AUTO SRL\n\n\nCONTATTI\n\n\n? ###phonenumber### ###phonenumber###\n\n\nMAIL: tristrisauto2015@libero.it\n\nVI ASPETTIAMO NEL NOSTRO AUTOSALONE A FONTANA LIRI (FR)\nFMG AUTO \n\nCONTATTI\n\n###phonenumber### - ###phonenumber###\n\nMAIL: tristrisauto2015@libero.it\n\nVI ASPETTIAMO NEL NOSTRO AUTOSALONE A FONTANA LIRI (FR)\nFMG AUTO \n\nCONTATTI\n\n###phonenumber### - ###phonenumber###\n\nMAIL: tristrisauto2015@libero.it",
  "geo": {
    "city": "Fontana Liri",
    "province": "Frosinone",
    "province_code": "FR",
    "region": "Lazio"
  },
  "features": {
    "fuel": "Benzina",
    "gearbox": "Manuale",
    "mileage": {
      "km": 110000,
      "formatted": "110.000 Km"
    },
    "pollution": {
      "euro": 6,
      "formatted": "Euro 6"
    },
    "power": {
      "kw": 63,
      "hp": 85,
      "formatted": "63 kW / 85 Cv"
    },
    "price": {
      "value": 10990,
      "formatted": "10.990 €"
    },
    "register_date": {
      "formatted": "03/2019",
      "year": 2019,
      "month": 3
    },
    "seats": 4,
    "brand": "FIAT",
    "model": "Panda Cross",
    "version": "Panda Cross 0.9 TwinAir Turbo S&S 4x4",
    "version_code": "105827",
    "vehicle_status": "Usato",
    "car_type": "Berlina"
  },
  "images": [
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/40/403f9b59-c507-4b31-a49e-9c924ee95a90",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/0e/0e5972ca-c08b-4716-a1b1-4bad1dfd4bba",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/58/586d19de-6bc0-437e-9834-a44f6d5056d8",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/cf/cfec3a33-3de1-4b71-8942-815b034dff9b",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/9f/9f0f33af-d82b-4273-90a1-2e1322eb8f6c",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/05/05c08842-294a-4770-816f-9f5cba8491f6",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/6d/6daa0bfa-e91b-45b4-91c9-7341fb0980db",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/42/42ec44f2-a70d-41be-b52a-f397cfcb4f66",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/ef/ef17bd26-8372-4efd-a517-89ef32764434",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/56/56c51f44-a366-457a-a879-cdcf52b7e15f",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/b3/b39e7256-ad0d-45d1-a818-a779a42fd4bb",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/1b/1bc93b8e-725c-4cc7-9379-68c9beeec0a9",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/43/43567abf-4970-4543-aa7e-085b8563f913",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/4c/4cc0a2e7-4083-4bae-b283-3bf3755e0ef3",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/77/7775a0e2-f3c8-42ff-ba27-20f1331addc2",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/33/33a68468-544c-4c19-a19e-17bec73bb49d",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/8b/8b07b20a-e48c-4415-a472-0f4be4d5d654",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/f1/f1af168f-03c9-4d1f-866d-69dea300e567",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/dc/dc36d217-3280-4d23-aff3-ae050cb23b9b",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/a2/a2c21987-6cea-4058-8d17-69a169ea8457",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/7f/7fb97a92-560f-438f-be07-1252c57b6c2b"
  ],
  "advertiser_shop_data": {
    "name": "fmg auto",
    "shop_categories": [
      "Auto"
    ],
    "address": "viale xxix maggio snc, Frosinone, Lazio",
    "listing_count": 63,
    "impresapiu_shop_page": "https://impresapiu.subito.it/shops/2055-fmg-auto",
    "website": null,
    "logo": "https://images.sbito.it/api/v1/sbt-shops-images-pro/images/9b/9b1f5502-c4cb-4acf-8fca-e872ae95440d?rule=shop_logo_medium_auto"
  },
  "phone_number": "07761715748",
  "car_specs": {
    "displacement": null,
    "cylinders": null,
    "gears": null,
    "drive_wheels": null,
    "fuel_consumption": null,
    "co2_class": null,
    "weight": null,
    "length": null,
    "width": null,
    "height": null,
    "wheelbase": null,
    "body_type": null,
    "doors": null,
    "hybrid_type": null,
    "equipment": null
  }
}
```

### What can you collect?

Each result can include:

- listing title, full description, URL, and publication date
- numeric and formatted price
- make, model, registration date, mileage, fuel, and gearbox
- vehicle condition, body type, seats, power, and emissions when available
- city, province, and region
- seller type and seller or dealer name
- all available image URLs
- optional seller phone number
- optional dealer address, opening hours, logo, and website
- optional detailed technical specifications, equipment, dimensions, consumption, and emissions

Subito might not always return all the data. In these cases, we return empty fields.

### Common use cases

- **Used-car price monitoring:** compare asking prices by make, model, year, mileage, and region.
- **Dealer inventory tracking:** monitor new listings, stock, and price changes.
- **Market research:** study regional supply, fuel trends, vehicle age, and mileage.
- **Lead generation:** collect public business seller information for lawful outreach.
- **Alerts and automation:** schedule searches and send new data to Google Sheets, Make, Zapier, webhooks, or your own API.

### Setting it up

You can set all the filters you want on the Subito website and copy the URL here. You can also use the keyword search option, which has an extensive list of filters and is recommended.

Start with a small run and adjust your filters to get exactly the results you want.

Here's an example input:

```json
{
  "searchQuery": "fiat panda",
  "category": "auto",
  "region": "lazio",
  "minPrice": 5000,
  "maxPrice": 20000,
  "yearFrom": 2018,
  "maxMileage": 80000,
  "fuelType": "benzina",
  "gearbox": "manuale",
  "sortOrder": "datedesc",
  "maxResultPerQuery": 100
}
```

Turn on only the extra data that you need:

- **Phone numbers** attempts to retrieve the seller's public phone number.
- **Shop details** adds available information for professional sellers, such as their address, opening hours, logo, and website.
- **Technical specifications** adds available vehicle specifications and equipment.

### FAQ

#### Do I need a Subito account or API key?

No. The Actor collects publicly available listing data.

#### Can I scrape one listing only?

Yes. Add its direct Subito listing URL to **Start URLs**.

#### Can I monitor new cars or price changes?

Yes. Save your input and schedule the Actor to run at regular intervals. Use the listing URL and vehicle attributes to compare datasets over time.

#### Why are some fields missing?

Sellers do not provide every attribute on every listing. Optional phone, dealer, and technical data can also be unavailable.

#### How can I export the results?

Download the dataset as JSON, CSV, Excel, XML, or HTML. You can also access it through the Apify API or connect the Actor to other applications.

### Disclaimer

*This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Subito.it. Use it only for lawful purposes and follow Subito.it's terms, applicable data-protection rules, and local laws. Public listing data can contain personal data. Make sure that you have a valid legal basis before you collect or use it.*

# Actor input Schema

## `startUrls` (type: `array`):

URL Subito.it o API dirette. Supporta URL di ricerca (es. /annunci-lazio/vendita/auto/), URL con filtri (?q=fiat+panda), URL dettaglio annuncio, e URL API dirette (hades.subito.it/...). Lascia vuoto se usi i filtri qui sotto.

## `searchQuery` (type: `string`):

Testo libero: marca, modello, o qualsiasi parola chiave (es. 'fiat panda', 'mercedes classe a 2008').

## `category` (type: `string`):

Categoria di veicoli.

## `region` (type: `string`):

Filtra per regione italiana.

## `maxPrice` (type: `integer`):

Prezzo massimo in Euro.

## `minPrice` (type: `integer`):

Prezzo minimo in Euro.

## `minMileage` (type: `integer`):

Chilometraggio minimo.

## `maxMileage` (type: `integer`):

Chilometraggio massimo.

## `yearFrom` (type: `integer`):

Anno di immatricolazione minimo (es. 2018).

## `yearTo` (type: `integer`):

Anno di immatricolazione massimo (es. 2025).

## `fuelType` (type: `string`):

Tipo di alimentazione.

## `gearbox` (type: `string`):

Tipo di cambio.

## `condition` (type: `string`):

Stato del veicolo.

## `sortOrder` (type: `string`):

Ordina i risultati. Anno e chilometraggio sono disponibili per Auto e Moto; potenza e lunghezza solo per Auto.

## `maxResultPerQuery` (type: `integer`):

Numero massimo di annunci da estrarre per ogni URL o ricerca. 0 = nessun limite.

## `enrichPhone` (type: `boolean`):

Recupera il numero di telefono del venditore per ogni annuncio (richiede una richiesta extra per annuncio).

## `enrichShop` (type: `boolean`):

Recupera i dettagli del negozio (indirizzo, orari, logo, sito web) per annunci di venditori professionali.

## `enrichCarSpecs` (type: `boolean`):

Recupera le specifiche tecniche dettagliate del veicolo (cilindrata, consumi, emissioni, dimensioni, dotazioni) quando disponibili.

## `proxyConfiguration` (type: `object`):

Configurazione proxy Apify.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/fiat/panda/"
  ],
  "sortOrder": "relevance",
  "maxResultPerQuery": 100,
  "enrichPhone": false,
  "enrichShop": false,
  "enrichCarSpecs": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Link to the dataset of scraped records

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/fiat/panda/"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("epicscrapers/subito-automotive-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": ["https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/fiat/panda/"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("epicscrapers/subito-automotive-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://www.subito.it/annunci-lazio/vendita/auto/roma/roma/fiat/panda/"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call epicscrapers/subito-automotive-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,epicscrapers/subito-automotive-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0VhUyu4fJIaa0nic8/builds/61SV2HaTTEhQRNwai/openapi.json