🚗 Subito Auto Scraper

Want to find used cars on Subito.it or analyze the Italian private + dealer market? This scraper makes it super easy!

Paste an input_url from your browser once you've already filtered on Subito, or use structured filters (make, model, region, price, fuel type, etc.) — structured filters work better for AI agents. When input_url is set it overrides the filters. Either way, you get up to 2000 car listings from the Auto section only, with pricing, specs, and location as CSV or JSON.

💡 Perfect for...

• Car Buyers: Monitor deals from private sellers and dealers across Italy.
• Dealerships: Track competitor inventory and pricing on Subito.
• Market Research: Analyze Italian used-car supply by brand, region, mileage, and fuel.
• Data Analysts: Export clean structured data for dashboards and pricing models.
• 🤖 AI Agents: Power bots and OpenClaw workflows with real-time Subito Auto listings.
• 📚 RAG Systems: Feed vehicle specs and prices into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a Subito Auto search URL (input_url) if you already filtered in the browser, or use structured filters (better for AI agents). input_url always wins when set.
• 🎯 Structured Filters: Search by make, model, region, city, condition, body type, price, mileage, year, fuel, gearbox, and seller type — no URL crafting.
• 🚗 Auto Only: Scoped to Subito Auto — ignores immobili, elettronica, etc.
• ⚙️ Rich Listings: Price, year, mileage, fuel, gearbox, body, location, and images.
• 🔎 Optional Deep Dive: Turn on enrich_details for extra fields from each ad page (usually unnecessary).
• ⏱️ Sorting Options: Newest, relevance, price, year, mileage, power, or length.
• 🇮🇹 Built for Italy: All 20 regions with a live make dropdown fetched from Subito's brands API.

📦 What's inside the data?

For every single car listing, you will get:

• Core Details: id, title, url, image, photo_count, description, published_at
• Location: location, region, province, town
• Technical Specs: make, model, version, fuel_type, gearbox, mileage, year, body_type, doors, seats, color, power, emission_class, condition
• Pricing & Seller: price, seller_type, seller_name
• Extras: neopatentati when present

🛠️ Sort options

Use the sort_by parameter:

• Most Recent – Newest listings first
• Most Relevant – Subito relevance ranking
• Lowest / Highest Price
• Newest / Oldest Year
• Lowest / Highest KM
• Lowest / Highest Power
• Shortest / Longest Length

🚀 Quick start

Option A — Input URL

1. Open Subito Auto, apply filters in the browser, copy the results URL.
2. Paste it into input_url.
3. Set max_cars and click Start.

Option B — Structured filters (better for AI agents)

1. Leave input_url empty.
2. Set filters (e.g. make FIAT, model Panda), optional region/city, price / mileage / year / fuel.
3. Choose sort_by and max_cars (up to 2000).
4. Click Start and export CSV, Excel, or JSON when done.

---

Tech details for developers 🧑‍💻

Input Example (filters)

{
  "make": "FIAT",
  "model": "Panda",
  "region": "Lombardia",
  "price_max": 10000,
  "energy": "Benzina",
  "sort_by": "Lowest Price",
  "max_cars": 100
}

Input Example (URL override)

{
  "input_url": "https://www.subito.it/annunci-lombardia/vendita/auto/?q=bmw",
  "max_cars": 100
}

Output Example

{
  "id": "654772709",
  "title": "Panda anno 2010",
  "url": "https://www.subito.it/auto/panda-anno-2010-napoli-654772709.htm",
  "image": "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/70/…?rule=gallery-800-w",
  "price": 3000,
  "year": 2010,
  "mileage": 163000,
  "fuel_type": "Benzina",
  "gearbox": "Manuale",
  "body_type": "Utilitaria",
  "location": "Giugliano in Campania, Napoli, Campania",
  "make": "FIAT",
  "model": "Panda",
  "seller_type": "Private"
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Paste a Subito Auto search URL; overrides all filters below when set. Leave empty to use filters (better for AI agents).
make	string enum	No	any	Brand as on Subito, fetched live from Subito's brands API (e.g. FIAT, BMW, ALFA ROMEO). Empty = all brands.
model	string	No	—	Free-text model name (e.g. Panda). Only used when make is set; not a dropdown.
query	string	No	—	Free-text keywords.
region	string enum	No	"" (all Italy)	Italian region (e.g. Lombardia, Lazio, Campania). Empty = nationwide.
city	string	No	—	City or province text.
condition	string enum	No	any	Usato, Km0, Nuovo.
body_type	string enum	No	any	Utilitaria, Berlina, Station Wagon, Monovolume, SUV/Fuoristrada, Cabrio, Coupé, City Car, Altro.
price_min / price_max	integer	No	—	Price range in euros.
mileage_min / mileage_max	integer	No	—	Mileage range in km.
year_min / year_max	integer	No	—	Registration year range.
energy	string enum	No	any	Fuel type as shown on Subito (Benzina, Diesel, Gpl, Elettrica, Ibrida, …).
gearbox	string enum	No	any	Manuale, Automatico, Sequenziale, Altro.
seller_type	string enum	No	any	Privato or Azienda.
sort_by	string enum	No	Most Recent	See sort options above.
max_cars	integer	Yes	50	How many listings to return (1–2000).
enrich_details	boolean	No	false	Fetch each ad page for extra fields (slower; rarely needed).
listing_urls	string[]	No	—	Direct ad URLs. If provided without search filters, only these are scraped.

Notes on filters

• input_url always wins over filters when provided.
• This Actor only scrapes cars (Subito Auto). Motori accessories, moto, immobili, etc. are out of scope.
• Each run returns at most max_cars listings (1–2000).
• Prefer official Subito brand names when filtering by make.