# Subito.it Real Estate Scraper (`ayrtondavoli97/propscout-scraper`) Actor Extract real estate listings from Subito.it in Italy. Get title, price, surface, rooms, bathrooms, city, agency, URL and investment score. Supports sale/rent, property type filters, deduplication and monitoring mode. - **URL**: https://apify.com/ayrtondavoli97/propscout-scraper.md - **Developed by:** [Francesco Ayrton Davoli](https://apify.com/ayrtondavoli97) (community) - **Categories:** Real estate, AI, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $2.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## 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 ```json { "city": "Milano", "contractType": "vendita", "propertyType": "appartamento", "sources": ["subito"], "maxItems": 200, "fastMode": true, "sourceTimeoutSecs": 120, "deduplication": true, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` #### Higher-volume run ```json { "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: ```json { "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 ```bash npm install npm start ``` # Actor input Schema ## `sources` (type: `array`): Stable commercial release supports Subito.it. Leave as default unless you are migrating an older task. ## `city` (type: `string`): City to search in (e.g. Roma, Milano, Napoli) ## `province` (type: `string`): Optional Italian province code (e.g. RM, MI, NA) ## `contractType` (type: `string`): Use vendita for sale listings or affitto for rental listings ## `propertyType` (type: `string`): Type of property to search for ## `priceMin` (type: `integer`): Minimum listing price in euros ## `priceMax` (type: `integer`): Maximum listing price in euros ## `surfaceMin` (type: `integer`): Minimum property surface area in square meters ## `maxItems` (type: `integer`): Maximum number of Subito.it listings to extract. This is a ceiling, not a guaranteed final amount because deduplication can remove repeated listings. ## `sourceTimeoutSecs` (type: `integer`): Maximum time budget for Subito.it pagination before returning partial results. Recommended: 90 for balanced runs, 120-180 for high-volume runs. ## `fastMode` (type: `boolean`): Prefer faster source timeouts and fewer retries to avoid full run timeout on Apify. ## `stopOnSourceTimeout` (type: `boolean`): If enabled, the actor stops after the first source timeout. Keep disabled for partial but reliable output. ## `monitoringMode` (type: `boolean`): When enabled, only outputs new listings compared to the previous run. Use with Apify scheduler for price alerts. ## `telegramBotToken` (type: `string`): Telegram bot token used to send alerts in monitoring mode ## `telegramChatId` (type: `string`): Telegram chat ID where alerts will be sent in monitoring mode ## `deduplication` (type: `boolean`): When enabled, removes likely repeated listings using fuzzy matching ## `proxyConfig` (type: `object`): Apify proxy settings. Residential proxy is recommended for stable production runs. ## Actor input object example ```json { "sources": [ "subito" ], "contractType": "vendita", "propertyType": "appartamento", "maxItems": 100, "sourceTimeoutSecs": 90, "fastMode": true, "stopOnSourceTimeout": false, "monitoringMode": false, "deduplication": true, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("ayrtondavoli97/propscout-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("ayrtondavoli97/propscout-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 '{}' | apify call ayrtondavoli97/propscout-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ayrtondavoli97/propscout-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Subito.it Real Estate Scraper", "description": "Extract real estate listings from Subito.it in Italy. Get title, price, surface, rooms, bathrooms, city, agency, URL and investment score. Supports sale/rent, property type filters, deduplication and monitoring mode.", "version": "0.0", "x-build-id": "bnarYgksKv65AnrUz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ayrtondavoli97~propscout-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ayrtondavoli97-propscout-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ayrtondavoli97~propscout-scraper/runs": { "post": { "operationId": "runs-sync-ayrtondavoli97-propscout-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ayrtondavoli97~propscout-scraper/run-sync": { "post": { "operationId": "run-sync-ayrtondavoli97-propscout-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "city" ], "properties": { "sources": { "title": "Source to scrape", "type": "array", "description": "Stable commercial release supports Subito.it. Leave as default unless you are migrating an older task.", "items": { "type": "string", "enum": [ "subito" ] }, "default": [ "subito" ] }, "city": { "title": "City", "type": "string", "description": "City to search in (e.g. Roma, Milano, Napoli)" }, "province": { "title": "Province code", "type": "string", "description": "Optional Italian province code (e.g. RM, MI, NA)" }, "contractType": { "title": "Contract type", "enum": [ "vendita", "affitto" ], "type": "string", "description": "Use vendita for sale listings or affitto for rental listings", "default": "vendita" }, "propertyType": { "title": "Property type", "enum": [ "appartamento", "villa", "ufficio", "negozio", "terreno", "box" ], "type": "string", "description": "Type of property to search for", "default": "appartamento" }, "priceMin": { "title": "Min price (EUR)", "type": "integer", "description": "Minimum listing price in euros" }, "priceMax": { "title": "Max price (EUR)", "type": "integer", "description": "Maximum listing price in euros" }, "surfaceMin": { "title": "Min surface (m2)", "type": "integer", "description": "Minimum property surface area in square meters" }, "maxItems": { "title": "Max items per source", "type": "integer", "description": "Maximum number of Subito.it listings to extract. This is a ceiling, not a guaranteed final amount because deduplication can remove repeated listings.", "default": 100 }, "sourceTimeoutSecs": { "title": "Timeout per source (seconds)", "type": "integer", "description": "Maximum time budget for Subito.it pagination before returning partial results. Recommended: 90 for balanced runs, 120-180 for high-volume runs.", "default": 90 }, "fastMode": { "title": "Fast mode", "type": "boolean", "description": "Prefer faster source timeouts and fewer retries to avoid full run timeout on Apify.", "default": true }, "stopOnSourceTimeout": { "title": "Stop on source timeout", "type": "boolean", "description": "If enabled, the actor stops after the first source timeout. Keep disabled for partial but reliable output.", "default": false }, "monitoringMode": { "title": "Monitoring mode", "type": "boolean", "description": "When enabled, only outputs new listings compared to the previous run. Use with Apify scheduler for price alerts.", "default": false }, "telegramBotToken": { "title": "Telegram Bot Token", "type": "string", "description": "Telegram bot token used to send alerts in monitoring mode" }, "telegramChatId": { "title": "Telegram Chat ID", "type": "string", "description": "Telegram chat ID where alerts will be sent in monitoring mode" }, "deduplication": { "title": "Enable deduplication", "type": "boolean", "description": "When enabled, removes likely repeated listings using fuzzy matching", "default": true }, "proxyConfig": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. Residential proxy is recommended for stable production runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```