# Autobelle Italy Car Scraper (`rainminer/autobelle-it-scraper`) Actor

Scrape classic and used car listings from autobelle.it — price, make, model, year, mileage, photos, location and seller details. Export structured JSON or CSV via Apify for market research and inventory monitoring.

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

## Pricing

from $1.49 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Autobelle Italy Car Scraper

Scrape **classic, vintage, and used car listings from [autobelle.it](https://www.autobelle.it/)** — Italy's marketplace for collector cars, historic vehicles, and modern used cars. Extract price, make, model, year, mileage, photos, location, and full descriptions. Export results as **JSON, CSV, or Excel** via the Apify platform.

### What does Autobelle Italy Car Scraper do?

Autobelle Italy Car Scraper collects structured vehicle data from [autobelle.it](https://www.autobelle.it/it/annunci.xhtml) search pages and individual listing detail pages. Provide a search URL such as `https://www.autobelle.it/it/annunci.xhtml` or a filtered search, and the Actor walks pagination, opens each listing, and returns clean rows up to your configured limit.

The Actor uses fast HTTP requests with Cheerio — no browser required.

### What data can Autobelle Italy Car Scraper extract?

| Field | Description |
| --- | --- |
| `id` | Listing ID |
| `title` | Full listing title |
| `price` / `priceFormatted` | Asking price in EUR |
| `year` | First registration year |
| `brand` / `model` | Make and model |
| `vehicleType` | Car, motorcycle, parts, etc. |
| `listingType` | Sale, wanted, or exchange |
| `mileage` | Odometer reading when available |
| `fuel` / `transmission` / `bodyType` | Technical specs |
| `country` / `location` | Seller geography |
| `description` | Full listing text |
| `postedDate` | Publication date |
| `images` | Photo URLs |
| `listingUrl` | Direct link to the listing |
| `searchUrl` | Start URL that produced this result |

### Why scrape autobelle.it?

- **Collector market research** — track asking prices for classic and vintage models
- **Inventory monitoring** — watch new listings for specific marques or eras
- **Cross-listing analysis** — compare Autobelle prices with other EU marketplaces
- **Lead generation** — find newly listed vehicles before competitors
- **Dataset building** — feed pricing models with structured Italian market data

### How to scrape autobelle.it

1. Open the Autobelle Italy Car Scraper on Apify Store and click **Try for free**.
2. Set **Start URLs** — paste `https://www.autobelle.it/it/annunci.xhtml` or a filtered search URL.
3. Set **Maximum items** — use 5 for a quick test; increase for production runs.
4. **Run** the Actor and wait for completion.
5. **Download** results from the Dataset tab as JSON, CSV, or Excel.

### Input

| Field | Type | Description |
| --- | --- | --- |
| `startUrls` | Array of URLs | Search or listing detail pages |
| `maxItems` | Integer | Max results per start URL (default: 5) |
| `proxyConfiguration` | Object | Proxy settings (default: no proxy) |

### Output example

```json
{
  "id": "361798",
  "title": "Audi A3 2.0 TFSI 190 CV quattro S tronic 7 marce, immatricolata 2019",
  "price": 25000,
  "priceFormatted": "25.000",
  "currency": "EUR",
  "year": 2019,
  "brand": "AUDI",
  "model": "A3 2.0 TFSI QUATTRO S-TR 200CV",
  "vehicleType": "Auto",
  "listingType": null,
  "mileage": 64000,
  "fuel": null,
  "transmission": null,
  "bodyType": "Veicolo tra il 2006 e oggi",
  "country": "italia",
  "location": null,
  "description": "Audi A3 immatricolata a novembre 2019...",
  "postedDate": "2026-07-30T15:23:24+02:00",
  "images": [
    "https://www.autobelle.it/altre-immagini/immagini_annunci/99000/990001945/lista_990001945.d1785406729.jpg"
  ],
  "listingUrl": "https://www.autobelle.it/it/a/Vendo_Audi_A3_2_0_TFSI_190_CV_quattro_S_tronic_7_marce_immatricolata_2019_361798.xhtml",
  "searchUrl": "https://www.autobelle.it/it/annunci.xhtml"
}
```

### Pricing

This Actor uses Apify pay-per-event pricing. You pay a small platform fee per run plus a per-result charge. Run a short test with `maxItems: 5` to estimate cost before scaling up.

### Integrations

Connect Autobelle data to Google Sheets, Zapier, Make, or your own pipeline via the Apify API. Schedule daily runs to monitor new listings automatically.

### Tips

- The default annunci page returns 50 listings per page with 40,000+ total results — use filters on autobelle.it and paste the filtered URL for targeted runs.
- Detail pages include richer specs than search cards; the Actor always opens detail pages for complete data.
- No login or account is required — only publicly visible listings are collected.

### Image Credit

Image credit: [autobelle.it](https://www.autobelle.it/)

# Actor input Schema

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

autobelle.it search URLs (e.g. https://www.autobelle.it/it/annunci.xhtml) or individual listing detail URLs.

## `maxItems` (type: `integer`):

Maximum number of car listings to return per start URL.

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

Proxy settings. The scraper works without a proxy in most regions.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.autobelle.it/it/annunci.xhtml"
    }
  ],
  "maxItems": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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": [
        {
            "url": "https://www.autobelle.it/it/annunci.xhtml"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rainminer/autobelle-it-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": [{ "url": "https://www.autobelle.it/it/annunci.xhtml" }],
    "proxyConfiguration": { "useApifyProxy": False },
}

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

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": [
    {
      "url": "https://www.autobelle.it/it/annunci.xhtml"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call rainminer/autobelle-it-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=rainminer/autobelle-it-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dDn3cUeKexEVQhljJ/builds/Z2BdH1JUpuF0Sv8dp/openapi.json