Subito.it Property Scraper

Examples:

• /annunci-italia/vendita/appartamenti/ — all Italy, apartments for sale
• /annunci-lazio/vendita/appartamenti/roma/roma/ — Rome city apartments for sale
• /annunci-lombardia/affitto/appartamenti/milano/?q=trilocale — Milan-province three-room rentals
• /annunci-italia/affitto-vacanze/case-vacanza/ — vacation homes nationwide

Filter params (priceMin/Max, areaMin/Max, roomsMin/Max, advertiserType) are applied post-fetch in memory — they don't go into the URL because Subito doesn't expose price/area as URL query parameters; the values are validated against each parsed listing.

---

Output

One Apify dataset record per listing. Headline fields:

Field	Description
adId	Subito numeric listing ID
detailUrl	Full URL (/{categoryShort}/{slug}-{id}.htm)
title / shortDescription	Listing subject and body excerpt
transactionType	sale / rent / vacation_rent
propertyType	apartment / villa / land / garage / loft / commercial / room / vacation_home
advertType	private / agency
price / priceCurrency / pricePerSqm	EUR price, currency, computed €/m²
areaSqm / terrainAreaSqm	Surface and plot area
rooms / roomsLabel / bathrooms / floor	When present in features
buildingType / heatingType / yearBuilt / energyClass	When present in features
country / region / province / provinceCode / city / microLocation	Address chain
street / fullAddress	Composed address
latitude / longitude	GPS when present
mainImageUrl / imageUrls / imageCount	All images from images.sbito.it CDN
advertiserId / advertiserName / advertiserUrl / advertiserType	Seller info
isFeatured / isUrgent / labels	Vetrina / Urgente badges
datePosted	Listing post date
searchTransaction / searchPropertyType / searchRegion / searchProvince / searchCity / searchKeyword / searchUrl	Echo of input params
scrapedAt	ISO-8601 scrape timestamp

Two dataset views are pre-configured: Overview (compact) and Full Detail.

Detail-only fields — feature flags (hasElevator, hasParking, hasGarage, hasTerrace, hasBalcony, isFurnished) and totalFloors are populated from the per-listing detail page, not the search results. The list-endpoint scraper leaves them as null — open a feature request for detail-page enrichment.

---

Important notes

• Real estate is one of four Subito verticals (Motori, Market, Immobili, Lavoro). This actor only handles Immobili. Pasting a search URL from another vertical and pointing the actor at it won't work.
• EUR is the only currency Subito uses today.
• Rooms = locali in Italian convention. Subito reports integer locali counts (1, 2, 3, …); studios appear as rooms: 1.
• Pagination is ?o=N. Each page typically yields ~30 listings. The actor stops when a page returns 0 listings or when the first ID matches the previous page (loop detector).
• Anti-bot is light vs Njuskalo or Idealista — datacenter proxies usually work. Switch to RESIDENTIAL country=IT if you start seeing 403s or stripped pages.
• Nationwide queries use regionSlug=italia. For broad searches (e.g. all of Italy), expect the cap (maxListings) to bind well before the catalog is exhausted; narrow with priceMin/Max and areaMin/Max to slice the inventory.

---

Common location slugs

Regions — italia (nationwide), lombardia, lazio, campania, sicilia, veneto, emilia-romagna, piemonte, puglia, toscana, calabria, sardegna, liguria, marche, abruzzo, friuli-venezia-giulia, trentino-alto-adige, umbria, basilicata, molise, valle-d-aosta

Major provinces — roma, milano, napoli, torino, palermo, genova, bologna, firenze, bari, catania, venezia, verona, padova, trieste, brescia, cagliari

Major cities — same slug as the province for capital cities (roma, milano, napoli, torino, bologna, …)

To find more, browse subito.it, drill down by clicking the region → province → city in the breadcrumb, and copy the slug from the URL.

---

Troubleshooting

Symptom	Likely cause	Fix
[HTTP] 403	Datacenter proxy fingerprinted	Switch proxyConfiguration to RESIDENTIAL country=IT
[404] URL not recognized	Wrong region/province/city slug	Verify the slug from a real Subito URL
[PARSE] __NEXT_DATA__ not found	Subito changed page structure	Open an issue — actor needs an updated parser
Only sponsored / Vetrina cards saved	Not the actor's behavior — these are normal	Sort is by recency by default; sponsored cards mix in
latitude / longitude always null	Not all listings have geocoded coordinates	Expected; private listings often skip GPS
Throughput slower than expected	Inter-page delay too long	Drop requestDelay to 800-1000 ms
Filter roomsMin: 2 keeps rooms: null records	Filter only applies when rooms != null	Expected — listings without rooms data bypass the filter

---

License

Apache-2.0