🚀 Subito.it Universal Scraper (Fast, Detailed & 100% Reliable)

An advanced, ultra-fast, and professional cloud-based web scraper for Subito.it (Italy's leading marketplace for Motors, Real Estate, Jobs, Electronics, Home, and more).

Questo è lo scraper definitivo e pronto all'uso per estrarre annunci da Subito.it in tempo reale, ottimizzato specificamente per investitori immobiliari, concessionari auto, commercianti e reseller che necessitano di dati strutturati ed esportabili in Excel, CSV o JSON.

---

🌟 Key Features / Caratteristiche Principali

• Deep Feature Extraction (Estrazione Dati Avanzata): Unlike basic scrapers, this Actor dynamically extracts all category-specific technical details:
  • Real Estate (Immobili): Surface area (mq), number of rooms (locali), bathrooms (bagni), floor (piano), heating (riscaldamento), building state (stato), energy class, and outdoor spaces (balcone/giardino).
  • Motors (Veicoli): Mileage (Km), registration year (anno), fuel type (carburante), transmission (cambio), emission class (Euro), horsepower (HP), and engine power (kW).
• Geographical Validation (Prevenzione Errori 404): Features a built-in Italian administrative validation layer that automatically resolves and normalizes Region, Province, and Comune queries to match Subito's strict URL routing, preventing 404 crawler crashes.
• Cloudflare Bypass & Proxy Integration: Utilizes optimized TLS fingerprinting and browser header emulation (got-scraping) to navigate seamlessly. Integrated with Apify's proxy configuration (residential Italian proxies are highly recommended).
• Zero-Coding Excel/CSV Exports: Outputs clean, structured flat data, ready to be immediately imported into Excel or Google Sheets for market analysis and price calculations.

---

⚙️ Input Configuration / Configurazione Input

The Actor accepts the following input parameters:

Field / Campo	Type	Description / Descrizione	Default
category	string	The Subito category slug (e.g., appartamenti, auto, telefonia, offerte-lavoro).	appartamenti
region	string	The Italian region (e.g., Lombardia, Sicilia). Leave empty for all Italy.	""
province	string	The province name or abbreviation (e.g., MI, Milano, RG, Ragusa).	""
comune	string	The specific municipality name (e.g., Ragusa, Milano).	""
query	string	Search keyword or phrase (e.g., bilocale, Toyota, iPhone).	""
priceMin	integer	Minimum listing price in Euros.	null
priceMax	integer	Maximum listing price in Euros.	null
maxPages	integer	Maximum number of search result pages to crawl (30 ads/page).	5
extraFilters	object	JSON object containing additional category-specific filters (e.g. {"szs": 80}).	{}
proxyConfig	object	Apify proxy configuration widget settings.	{"useApifyProxy": true}

Input Example (JSON)

{
  "category": "appartamenti",
  "region": "Sicilia",
  "province": "RG",
  "comune": "Ragusa",
  "query": "bilocale",
  "priceMin": 30000,
  "priceMax": 120000,
  "maxPages": 3,
  "extraFilters": {
    "szs": "50",
    "btrs": "1"
  },
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "IT"
  }
}

---

📊 Output Dataset Example (JSON)

Every listing extracted is fully anonymized to comply with GDPR and privacy standards. Faked mock details are shown below to illustrate the output schema:

{
  "id": "123456789",
  "urn": "id:ad:123456789:list:987654321",
  "title": "Bilocale Ristrutturato in Centro Storico",
  "description": "Splendido appartamento finemente ristrutturato composto da ingresso, soggiorno con cucina a vista, camera matrimoniale e bagno. Ottimo per investimento o giovani coppie.",
  "date": "2026-05-27 10:15:30",
  "price": 85000,
  "url": "https://www.subito.it/appartamenti/bilocale-ristrutturato-in-centro-storico-ragusa-123456789.htm",
  "category": {
    "id": "7",
    "name": "Appartamenti",
    "slug": "appartamenti"
  },
  "location": {
    "comune": "Ragusa",
    "provincia": "Ragusa",
    "regione": "Sicilia",
    "shortProvincia": "RG"
  },
  "images": [
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/sample-image-1.jpg",
    "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/sample-image-2.jpg"
  ],
  "features": {
    "Superficie": "65 mq",
    "Locali": "2",
    "Piano": "2",
    "Bagni": "1",
    "Stato": "Ottimo / Ristrutturato",
    "Riscaldamento": "Autonomo",
    "Classe energetica": "C",
    "Balcone": "Sì",
    "Aria condizionata": "Sì",
    "Arredato": "Sì",
    "Ascensore": "No"
  },
  "advertiser": {
    "name": "Mario Rossi",
    "type": "private",
    "userId": "9876543",
    "company": false
  }
}

---

🔒 Privacy & GDPR Compliance

This Actor extracts publicly available listings data.

• Anonymization: All listing details, images, and user accounts exposed in the dataset represent public classified information posted by the respective users on the source website.
• Compliance: Users of this Actor are solely responsible for ensuring that their data processing activities comply with local privacy regulations (GDPR) and the source platform's Terms of Service.

🚀 Proxy Requirements

Subito.it actively blocks cloud datacenter IP addresses. To ensure consistent success rates and prevent 403 Forbidden errors:

• Always enable Apify Proxy.
• Use Residential Proxy Groups.
• Target Italy (IT) as the exit country to match local user behavior.