PropScout Italy - Subito Real Estate Scraper

PropScout Italy extracts Italian real estate listings from subito.it and returns a clean, normalized dataset ready for analysis, monitoring and export.

This stable commercial release intentionally focuses on the platform that currently returns reliable results on Apify. Sources that were blocked or inconsistent during testing are not exposed to users in this version.

What this Actor does

• Scrapes real estate search results from subito.it
• Supports city, contract type and property type filters
• Extracts normalized listing fields such as title, price, surface, rooms, bathrooms, city, agency and source URL
• Removes likely duplicates with fuzzy matching
• Computes an investment score for quick ranking
• Supports monitoring mode for new-listing detection
• Can send Telegram alerts in monitoring mode
• Returns partial results instead of failing when the time budget is reached

Supported source

Source	Status	Notes
subito.it	Stable	Recommended for production and commercial runs

Other portals are not advertised in this release because they produced unstable responses, 403 blocks or empty outputs during Apify runs. This keeps the product honest and avoids selling unsupported coverage.

Recommended input

Stable commercial run

{
  "city": "Milano",
  "contractType": "vendita",
  "propertyType": "appartamento",
  "sources": ["subito"],
  "maxItems": 200,
  "fastMode": true,
  "sourceTimeoutSecs": 120,
  "deduplication": true,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Higher-volume run

{
  "city": "Milano",
  "contractType": "vendita",
  "propertyType": "appartamento",
  "sources": ["subito"],
  "maxItems": 500,
  "fastMode": true,
  "sourceTimeoutSecs": 240,
  "deduplication": true,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Input fields

Field	Type	Description
city	string	Required city name, for example Roma, Milano, Napoli
sources	array	Supported value: ["subito"]
contractType	string	vendita or affitto
propertyType	string	appartamento, villa, ufficio, negozio, terreno, box
priceMin	integer	Minimum price in EUR
priceMax	integer	Maximum price in EUR
surfaceMin	integer	Minimum surface in square meters
maxItems	integer	Maximum listings to extract. This is a ceiling, not a guaranteed final count
fastMode	boolean	Keeps runs responsive by using faster waits and fewer retries
sourceTimeoutSecs	integer	Time budget before returning partial results
deduplication	boolean	Removes likely repeated listings
monitoringMode	boolean	Outputs only new listings compared with previous runs
telegramBotToken	string	Telegram bot token for monitoring mode
telegramChatId	string	Telegram chat destination for monitoring mode
proxyConfig	object	Apify proxy configuration. RESIDENTIAL is recommended

Output schema

Each item follows a normalized schema like:

{
  "source": "subito.it",
  "listing_id": "sub_example-id",
  "title": "Bilocale in zona Loreto",
  "description": null,
  "price": 259000,
  "price_sqm": 4317,
  "surface_sqm": 60,
  "rooms": 2,
  "bathrooms": 1,
  "floor": "2",
  "city": "Milano",
  "zone": null,
  "address": null,
  "lat": null,
  "lng": null,
  "contract_type": "vendita",
  "property_type": "appartamento",
  "agency": "Example Agency",
  "images": [],
  "investment_score": 68,
  "score_reasons": ["Good price/sqm", "Incomplete location data"],
  "zone_avg_price_sqm": null,
  "url": "https://www.subito.it/appartamenti/example.htm",
  "scraped_at": "2026-04-09T10:00:00.000Z"
}

Notes for buyers and users

• maxItems is a target ceiling. Final output can be lower if fewer results are available or deduplication removes repeated listings.
• fastMode: true is recommended for Apify production runs.
• Use sourceTimeoutSecs: 120 or higher for larger exports.
• Some fields, such as exact address, latitude, longitude and images, depend on what is visible in the search result cards.
• The Actor is designed to return usable partial results instead of timing out the entire run.

Local development

npm install
npm start