# Scraper Annunci Affitti Italia (`amintouzani/scraper-annunci-affitti`) Actor Monitora affitti su Immobiliare, Subito, Idealista, Casa.it e Wikicasa in un colpo solo. Filtra per prezzo, mq e orario di pubblicazione, elimina i doppioni e ti notifica su Telegram gli annunci nuovi - **URL**: https://apify.com/amintouzani/scraper-annunci-affitti.md - **Developed by:** [Amin Touzani](https://apify.com/amintouzani) (community) - **Categories:** Real estate, Automation, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.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 ## Scraper Annunci Affitti Italia ### Cosa fa Scraper Annunci Affitti Italia? **Scraper Annunci Affitti Italia** cerca in un colpo solo gli annunci di **case in affitto** su [Immobiliare.it](https://www.immobiliare.it), [Subito.it](https://www.subito.it), [Idealista.it](https://www.idealista.it), [Casa.it](https://www.casa.it) e [Wikicasa.it](https://www.wikicasa.it) — tutti e cinque, in automatico — li normalizza in un formato unico (titolo, prezzo, metri quadri, locali, data/ora di pubblicazione, link) e ti notifica gli annunci nuovi — opzionalmente anche su **Telegram**. Grazie alla piattaforma Apify puoi eseguirlo, **schedularlo** (es. ogni 15 minuti) per essere il primo a rispondere agli annunci appena pubblicati, integrarlo con altre app e monitorare le esecuzioni. ### Perché usarlo? - **Una sola ricerca, cinque portali**: niente più tab aperte su cinque siti diversi. - **Solo annunci nuovi**: l'Actor ricorda gli annunci già visti (per ogni combinazione di filtri) e salva/notifica solo le novità. - **Filtri**: prezzo minimo/massimo, metratura minima/massima e finestra temporale di pubblicazione vengono applicati sia nelle URL di ricerca sia **lato client dopo il parsing**, così i risultati rispettano sempre i filtri anche quando un portale li ignora. - **Notifiche Telegram immediate** con titolo, prezzo, mq, locali, ora di pubblicazione e link diretto. ### Come si usa 1. Apri l'Actor e vai nella tab **Input**. 2. Inserisci la **città** (es. `Milano`) ed eventualmente attiva la ricerca in tutta la **provincia**. 3. Imposta i filtri che ti interessano: prezzo min/max, mq min/max, annunci pubblicati nelle **ultime N ore**. 4. (Facoltativo) Inserisci **token e chat ID Telegram** per ricevere le notifiche. 5. Premi **Start**. Per il monitoraggio continuo, crea uno **Schedule** (es. ogni 15–30 minuti). ### Input | Campo | Descrizione | | --- | --- | | `citta` | Città di ricerca (obbligatoria), es. `Milano`. | | `cerca_in_provincia` | Se `true`, estende la ricerca a tutta la provincia. | | `prezzo_min` / `prezzo_max` | Range di prezzo in € al mese. | | `mq_min` / `mq_max` | Range di superficie in mq. | | `pubblicato_da_ore` | Tiene solo gli annunci pubblicati nelle ultime N ore. Funziona solo quando il portale espone una data attendibile: gli annunci senza data **non vengono scartati** (potrebbero essere vecchi), e un annuncio sponsorizzato con data "aggiornata" artificialmente può superare il filtro pur non essendo davvero nuovo (vedi FAQ). | | `telegram_token` / `telegram_chat_id` | Credenziali per le notifiche Telegram (facoltative). | ### Come ottenere token e Chat ID Telegram Le notifiche Telegram sono facoltative, ma se le vuoi ti servono due valori: il **token del bot** e il tuo **Chat ID**. Si ottengono in meno di due minuti, senza scrivere codice. **1. Crea un bot e ottieni il token (da @BotFather)** 1. Apri Telegram e cerca **[@BotFather](https://t.me/BotFather)**, il bot ufficiale per creare altri bot. 2. Invia il comando `/newbot`. 3. Scegli un nome (es. "Affitti Milano Bot") e uno username che finisca in `bot`. 4. BotFather risponde con un messaggio contenente il **token**, una stringa tipo `123456789:AAHf3x9K...` — è il valore da mettere in `telegram_token`. **2. Trova il tuo Chat ID** 1. Cerca **[@userinfobot](https://t.me/userinfobot)** e invia `/start`: risponde subito con il tuo **ID numerico** (es. `987654321`) — è il valore da mettere in `telegram_chat_id`. Incolla entrambi i valori nei campi `telegram_token` e `telegram_chat_id` dell'Input e sei pronto. ### Output Ogni annuncio nuovo viene salvato nel Dataset in questo formato (scaricabile in JSON, CSV, Excel o HTML): ```json { "urn": "subito_601234567", "source": "Subito.it", "title": "Bilocale arredato zona Navigli", "price": "1200€", "size_mq": "55", "rooms": "2", "published_at": "2026-07-14 10:31", "url": "https://www.subito.it/immobili/bilocale-arredato-601234567.htm" } ```` | Campo | Significato | | --- | --- | | `urn` | Identificativo univoco `portale_id`, usato per il deduplicato tra le esecuzioni. | | `source` | Portale di provenienza. | | `title` | Titolo dell'annuncio. | | `price` | Canone mensile (`N/D` se il portale non lo espone in lista). | | `size_mq` / `rooms` | Superficie e numero di locali (`N/D` se assenti). | | `published_at` | Data e ora di pubblicazione nel fuso `Europe/Rome` (`N/D` se il portale non la espone nella pagina di ricerca). | | `url` | Link diretto all'annuncio. | ### Quanto costa monitorare gli affitti? L'Actor lavora via HTTP puro (nessun browser), gira con soli **128 MB di RAM** e scarica una sola pagina di risultati per portale, quindi ogni esecuzione dura in genere 10-40 secondi e consuma pochissime compute unit. Il modello di prezzo è **Pay Per Event**: paghi solo per ciò che l'Actor produce davvero, non un canone fisso. | Evento | Costo | | --- | --- | | Avvio dell'Actor (`Actor Start`) | $0.005 a esecuzione | | Annuncio nuovo salvato nel Dataset (`result`) | $1.00 ogni 1.000 (= $0.001 a annuncio) | A questi si sommano i **costi di utilizzo piattaforma** (compute unit + proxy), fatturati separatamente da Apify: dato il footprint minimo (128 MB, pochi secondi a esecuzione) restano una voce marginale rispetto ai due eventi sopra. #### La prima esecuzione è la più costosa La prima volta che lanci l'Actor su una combinazione di città/filtri, la sua "memoria" degli annunci già visti è vuota: **tutti** gli annunci trovati in quel momento vengono considerati nuovi, salvati nel Dataset e (se configurato) inviati su Telegram tutti insieme — è normale ritrovarsi con 50-150 annunci in un colpo solo in questa prima esecuzione "di popolamento", a seconda di città e filtri. Dalla seconda esecuzione in poi il costo scende drasticamente: l'Actor notifica solo le **vere novità** rispetto all'ultima scansione, quindi la maggior parte delle esecuzioni successive trova pochi o **zero** annunci nuovi (costando quindi solo l'`Actor Start`). Se cambi i filtri, la memoria riparte da zero e la prossima esecuzione tornerà a essere una "popolamento" più costosa (vedi sezione Consigli). #### Simulazione di spesa (esempio indicativo) Ipotesi: città di medie dimensioni, filtri non troppo stretti, schedulazione ogni **15 minuti** (~2.880 esecuzioni/mese). | Voce | Calcolo | Costo | | --- | --- | --- | | Prima esecuzione (popolamento, ~80 annunci) | 1 avvio + 80 risultati | $0.005 + $0.080 ≈ **$0.09** | | Esecuzioni successive (media 1-2 annunci nuovi/run) | 2.879 avvii + ~4.000 risultati | $14.40 + $4.00 ≈ **$18.40** | | **Totale primo mese (stima)** | | **~$18.50** + utilizzo piattaforma | Sono numeri puramente indicativi, pensati solo per farti capire l'ordine di grandezza: dipendono moltissimo da quanti annunci nuovi compaiono davvero nella tua città/fascia di prezzo. Con schedulazioni meno frequenti (es. ogni ora) o città/filtri più ristretti, il costo scende proporzionalmente — nella maggior parte dei casi l'`Actor Start` (fisso a ogni esecuzione) pesa più dei risultati, perché molte esecuzioni non trovano nulla di nuovo da notificare. ### Consigli - **La frequenza di scheduling è la leva di costo principale**: ogni esecuzione costa $0.005 anche a "vuoto" (zero annunci nuovi). Passare da ogni 15 a ogni 30-60 minuti taglia questa voce del 50-75% senza perdere molto in tempestività, se non ti serve la notifica nel giro di pochi minuti. - **Filtra stretto** (prezzo/mq/`pubblicato_da_ore`): meno annunci passano i filtri, meno risultati fatturabili produce ogni esecuzione, e la prima esecuzione di popolamento costa meno. - **Cambiare i filtri azzera la memoria**: la lista di annunci già visti è separata per ogni combinazione di città/filtri; se cambi anche solo un parametro, la prossima esecuzione ripartirà come una nuova "popolamento" (tutti gli annunci correnti rifatturati come nuovi). Evita di cambiare i filtri di continuo se vuoi tenere i costi sotto controllo. ### Non tutti i portali rispondono sempre allo stesso modo L'Actor scansiona **sempre tutti e 5 i portali automaticamente** — non è possibile disattivarne singolarmente. Alcuni siti immobiliari (in particolare **Idealista.it**) possono **bloccare temporaneamente** le richieste e restituire pochi o zero risultati in una singola esecuzione, anche se gli altri 4 portali funzionano regolarmente. Questo è un comportamento noto e normale del sito di destinazione, non un errore dell'Actor: le esecuzioni successive tornano spesso a funzionare normalmente. Se un portale specifico risulta bloccato in modo sistematico su più esecuzioni, controlla i log del run per i dettagli (codice HTTP, tentativi effettuati). ### FAQ e note legali - **L'ora di pubblicazione è sempre disponibile?** No: viene estratta quando il portale la espone nelle pagine di ricerca (es. Subito.it la fornisce sempre; altri portali solo a volte). In sua assenza il campo vale `N/D` e l'annuncio **non** viene scartato dal filtro `pubblicato_da_ore` — quindi con quel filtro attivo puoi comunque ricevere annunci "senza data" più vecchi di quanto richiesto, semplicemente perché il portale non espone abbastanza informazione per verificarlo. - **Le date di pubblicazione sono sempre affidabili?** Non al 100%, e questo vale anche per il filtro `pubblicato_da_ore`. Molti portali offrono agli inserzionisti servizi **a pagamento** (es. "in evidenza", "top annuncio", "annuncio sponsorizzato") che spingono un annuncio in cima ai risultati "più recenti" — o ne aggiornano la data mostrata — anche se l'immobile è in realtà sul mercato da settimane o mesi. L'Actor si basa sull'ordinamento e sulla data che il portale stesso espone nella pagina di ricerca: non ha modo di distinguere un annuncio genuinamente nuovo da uno ripubblicato/sponsorizzato dall'inserzionista, quindi un annuncio "vecchio" ma sponsorizzato può tranquillamente superare il filtro `pubblicato_da_ore` come se fosse nuovo. Se vedi ricomparire annunci che ti sembrano "vecchia conoscenza" nonostante il filtro orario, è probabile che sia per questo motivo, non un errore di parsing. - **È legale?** L'Actor estrae solo dati pubblicamente visibili nelle pagine di ricerca, con rate limiting e senza raccogliere dati personali. Assicurati comunque di rispettare i Termini di Servizio dei portali per il tuo caso d'uso. - Problemi o idee? Apri una segnalazione nella tab **Issues** dell'Actor. # Actor input Schema ## `citta` (type: `string`): Inserisci il nome della città (es: Milano). ## `cerca_in_provincia` (type: `boolean`): Se attivato, espande la ricerca a tutta la provincia anziché solo al comune. ## `prezzo_min` (type: `integer`): Budget minimo (lascia vuoto per 0) ## `prezzo_max` (type: `integer`): Budget massimo ## `mq_min` (type: `integer`): Superficie minima ## `mq_max` (type: `integer`): Superficie massima ## `pubblicato_da_ore` (type: `integer`): Tiene solo gli annunci pubblicati nelle ultime N ore (es. 24). Funziona quando il portale espone l'ora di pubblicazione (es. Subito.it); gli annunci senza data NON vengono scartati. Lascia vuoto per non filtrare. ## `telegram_token` (type: `string`): Token del bot Telegram. ## `telegram_chat_id` (type: `string`): ID della chat in cui inviare gli annunci. ## Actor input object example ```json { "citta": "Milano", "cerca_in_provincia": false } ``` # Actor output Schema ## `annunci` (type: `string`): No description # 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 = { "citta": "Milano" }; // Run the Actor and wait for it to finish const run = await client.actor("amintouzani/scraper-annunci-affitti").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 = { "citta": "Milano" } # Run the Actor and wait for it to finish run = client.actor("amintouzani/scraper-annunci-affitti").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 '{ "citta": "Milano" }' | apify call amintouzani/scraper-annunci-affitti --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=amintouzani/scraper-annunci-affitti", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Scraper Annunci Affitti Italia", "description": "Monitora affitti su Immobiliare, Subito, Idealista, Casa.it e Wikicasa in un colpo solo. Filtra per prezzo, mq e orario di pubblicazione, elimina i doppioni e ti notifica su Telegram gli annunci nuovi", "version": "0.0", "x-build-id": "e4c742zmKWSAXmPzV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/amintouzani~scraper-annunci-affitti/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-amintouzani-scraper-annunci-affitti", "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/amintouzani~scraper-annunci-affitti/runs": { "post": { "operationId": "runs-sync-amintouzani-scraper-annunci-affitti", "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/amintouzani~scraper-annunci-affitti/run-sync": { "post": { "operationId": "run-sync-amintouzani-scraper-annunci-affitti", "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": [ "citta" ], "properties": { "citta": { "title": "Città", "type": "string", "description": "Inserisci il nome della città (es: Milano).", "default": "Milano" }, "cerca_in_provincia": { "title": "Cerca in tutta la Provincia?", "type": "boolean", "description": "Se attivato, espande la ricerca a tutta la provincia anziché solo al comune.", "default": false }, "prezzo_min": { "title": "Prezzo Minimo (€)", "type": "integer", "description": "Budget minimo (lascia vuoto per 0)" }, "prezzo_max": { "title": "Prezzo Massimo (€)", "type": "integer", "description": "Budget massimo" }, "mq_min": { "title": "Metratura Minima (mq)", "type": "integer", "description": "Superficie minima" }, "mq_max": { "title": "Metratura Massima (mq)", "type": "integer", "description": "Superficie massima" }, "pubblicato_da_ore": { "title": "Pubblicati nelle ultime N ore", "minimum": 1, "type": "integer", "description": "Tiene solo gli annunci pubblicati nelle ultime N ore (es. 24). Funziona quando il portale espone l'ora di pubblicazione (es. Subito.it); gli annunci senza data NON vengono scartati. Lascia vuoto per non filtrare." }, "telegram_token": { "title": "Telegram Bot Token", "type": "string", "description": "Token del bot Telegram." }, "telegram_chat_id": { "title": "Telegram Chat ID", "type": "string", "description": "ID della chat in cui inviare gli annunci." } } }, "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 } } } } } } } } } } ```