Trovacasa Scraper

Actor Apify per lo scraping di annunci immobiliari da Trovacasa.it.

Descrizione

Questo Actor estrae informazioni dettagliate sugli annunci immobiliari pubblicati su Trovacasa.it. L'Actor naviga automaticamente le pagine di ricerca (listing), identifica i link agli annunci e raccoglie tutti i dati disponibili per ciascun immobile.

Funzionalità

• ✅ Scraping automatico di pagine di listing (ricerca)
• ✅ Estrazione dettagliata di informazioni per ogni annuncio
• ✅ Gestione automatica della paginazione (maxPages)
• ✅ Supporto per proxy (configurabile)
• ✅ Retry automatico con gestione errori
• ✅ Output strutturato in formato JSON

Input

L'Actor accetta i seguenti parametri di input:

startUrls (obbligatorio)

Array di URL delle pagine di listing da cui iniziare lo scraping. Importante: devono essere pagine di ricerca/listing, non pagine di dettaglio singoli annunci.

Esempio:

{
    "startUrls": [
        {
            "url": "https://www.trovacasa.it/case-in-vendita/milano"
        }
    ]
}

maxPages (opzionale)

Numero massimo di pagine di listing da processare. Se non specificato, verranno processate tutte le pagine disponibili.

Default: 1

Nota: Gli utenti con account gratuito sono limitati a 1 pagina automaticamente.

proxyConfiguration (opzionale)

Configurazione proxy per la protezione anti-bot. Di default utilizza Apify Proxy residenziale per l'Italia.

Default:

{
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "IT"
}

Output

L'Actor salva i dati estratti nel dataset di Apify. Ogni record contiene le seguenti informazioni:

Struttura Dati

{
    id: string;                    // ID univoco dell'annuncio
    url: string;                    // URL della pagina dell'annuncio
    titolo: string;                 // Titolo dell'annuncio
    prezzo: string;                 // Prezzo dell'immobile
    indirizzo: string;              // Indirizzo completo
    superficie: string;            // Superficie in metri quadri
    locali: string;                 // Numero di locali
    bagni: string;                 // Numero di bagni
    riferimento: string;           // Riferimento dell'annuncio
    codiceAnnuncio: string;        // Codice annuncio univoco
    descrizione: string;            // Descrizione completa
    caratteristiche: {
        tipologia: string;          // Tipo di immobile (Appartamento, Villa, ecc.)
        contratto: string;          // Tipo di contratto (Vendita, Affitto)
        comune: string;             // Comune dell'immobile
        classeEnergetica: string;   // Classe energetica (A-G)
        consumoEnergetico: string;  // Consumo energetico in kWh
    };
    tag: string[];                 // Tag e caratteristiche aggiuntive
    immagini: string[];            // URL delle immagini
    agenzia: {
        nome: string;              // Nome dell'agenzia
        logo: string;              // URL del logo
        indirizzo: string;          // Indirizzo dell'agenzia
        link: string;              // Link alla pagina dell'agenzia
    };
    telefoni: string[];            // Numeri di telefono dell'agenzia
}

Viste Dataset

Il dataset include due viste predefinite:

1. Overview: Vista compatta con i campi principali
2. Dettagli Completi: Vista completa con tutti i campi disponibili

Limitazioni Account Gratuito

Gli utenti con account gratuito sono automaticamente limitati a 1 pagina di listing. Per rimuovere questa limitazione, è necessario un piano a pagamento.