API REST JSON/XML

Hai bisogno di importare i dati delle aste nel tuo sistema in modo programmatico?

Implementa le nostre API REST per avere i dati delle aste aggiornati quotidianamente.

📄 Specifiche Tecniche#

Di seguito viene spiegato come utilizzare le nostre API.

🌐 Endpoint#

Tutte le chiamate vanno fatte al seguente endpoint

https://www.gestionale-aste.it/api/

Tutte le risposte sono codificate in UTF-8.

🔐 Autenticazione#

L'autenticazione avviene attraverso un'API KEY fornita da noi che va inviata con ogni request e può essere inviata in due modi: tramite Header X-Api-Key oppure tramite Basic Authentication.

Esempio di autenticazione con header X-Api-Key:

curl -H "X-Api-Key: test" https://www.gestionale-aste.it/api/aste

Esempio di autenticazione con basic authentication:

curl https://test:test@www.gestionale-aste.it/api/aste

Con l'API KEY "test" è possibile provare le API limitatamente a 5 aste.

Per utilizzare le API con i dati completi devi sottoscrivere un abbonamento mensile e ti invieremo la tua API KEY.

⚠️ Codici di risposta#

Nel caso di codici diversi da 200 la response conterrà un messaggio d'errore.

Esempio di errore in formato JSON

{
    "error": "Unauthorized"
}

Esempio di errore in formato XML

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <error>Unauthorized</error>
</root>

📑 GET /aste#

Questa chiamata fornisce le aste disponibili.

Esempio

curl -H "X-Api-Key: test" https://www.gestionale-aste.it/api/aste

Risposta JSON

{
    "aste": [
        {
            "id": "123456",
            "codice_rge": "01/2025",
            "data_scadenza": "2025-05-10",
            "descrizione": "Appartamento ...",
            "nr_locali": "3",
            "nr_bagni": "1",
            "nr_posti_auto": "1",
            "mq": "80",
            "vani": "5.00",
            "piano": "1",
            "prezzo": "90000",
            "provincia": "RM",
            "comune": "ROMA",
            "cap": "00100",
            "indirizzo": "via ...",
            "civico": "1/A",
            "latitudine": "41.8960968",
            "longitudine": "12.4878994",
            "link_mappa": "https://www.google.com/maps/search/?api=1&query=roma",
            "occupazione": "Libero",
            "tribunale": "ROMA",
            "lotto": "1",
            "tipo_di_asta": "Esecuzione Immobiliare Post Legge 80",
            "tipologia": "Abitazione di tipo civile",
            "foglio": "12",
            "particella": "123",
            "subalterno": "1234",
            "cod_istat": "12345",
            "data_pubblicazione": "2025-02-01",
            "data_inserimento": "2025-02-01 12:30:00",
            "giudice": "",
            "delegato": "",
            "custode": "",
            "custode_cell": "",
            "custode_tel": "",
            "custode_email": "",
            "tipo_di_vendita": "Senza Incanto",
            "offerta_minima": "67500",
            "rialzo_minimo": "1000",
            "modalita_vendita": "Sincrona Mista",
            "data_vendita": "2025-05-10 18:00:00",
            "termine_offerta": "2025-01-09 12:00:00",
            "nr_esperimento": "0",
            "valore_stima": "120000",
            "link_asta": "https://pvp.giustizia.it/pvp/...",
            "link_allegati": [
                {
                    "name": "Avviso di vendita.pdf (186 Kb)",
                    "url": "https://..."
                },
                {
                    "name": "planimetrie.pdf (44 Kb)",
                    "url": "https://..."
                },
                {
                    "name": "ordinanzaweb.pdf (688 Kb)",
                    "url": "https://..."
                },
                {
                    "name": "Periziaweb.pdf (1073 Kb)",
                    "url": "https://..."
                },
                {
                    "name": "fotografie.pdf (6658 Kb)",
                    "url": "https://..."
                }
            ],
            "cat_catastale": "A/2",
            "foto_satellite": "https://www.gestionale-aste.it/...",
            "foto_street_view": "https://www.gestionale-aste.it/...",
            "foto_carosello": [],
            "foto_allegati": [
                "https://www.gestionale-aste.it/...001.jpg",
                "https://www.gestionale-aste.it/...002.jpg",
                "https://www.gestionale-aste.it/...003.jpg"
            ],
            "doc_avviso": "https://...",
            "doc_perizia": "https://...",
            "doc_foto": "https://..."
        },
    ],
    "aste_rimanenti": 25000,
    "ultimo_id": "123456"
}

La chiamata fornisce le aste non scadute, in ordine di id crescente e paginate (massimo 100 aste per singola chiamata).

Il valore della proprietà aste_rimanenti indica quante aste ci sono ancora da scaricare.

Il valore della proprietà ultimo_id va passato alla richiesta successiva per farsi tornare la prossima pagina di risultati.

Pertanto l'algoritmo per farsi dare tutte le aste disponibili è il seguente:

ultimo_id = 0
do
    GET /aste?id=<ultimo_id>
while aste_rimanenti > 0;

⚙ Codice di esempio PHP/JavaScript/Python#

Di seguito viene riportato il codice di esempio per scaricare tutte le aste comprese nel proprio abbonamento.

Parametri opzionali

Esempio: ottenere i dati in formato XML

curl -H "X-Api-Key: test" https://www.gestionale-aste.it/api/aste?output_format=xml

Esempio: ottenere i dati della sola provincia di Roma, 10 alla volta

curl -H "X-Api-Key: test" "https://www.gestionale-aste.it/api/aste?prov=RM&limit=10"

📑 GET /aste/123456#

Questa chiamata fornisce i dati di una singola asta identificata dall'id numerico specificato ("123456" nell'esempio).

Esempio

curl -H "X-Api-Key: test" https://www.gestionale-aste.it/api/aste/123456

Risposta JSON

{
    "asta": {
        "id": "123456",
        "codice_rge": "01/2025",
        "data_scadenza": "2025-05-10",
        "descrizione": "Appartamento ...",
        "nr_locali": "3",
        "nr_bagni": "1",
        "nr_posti_auto": "1",
        "mq": "80",
        "vani": "5.00",
        "piano": "1",
        "prezzo": "90000",
        "provincia": "RM",
        "comune": "ROMA",
        "cap": "00100",
        "indirizzo": "via ...",
        "civico": "1/A",
        "latitudine": "41.8960968",
        "longitudine": "12.4878994",
        "link_mappa": "https://www.google.com/maps/search/?api=1&query=roma",
        "occupazione": "Libero",
        "tribunale": "ROMA",
        "lotto": "1",
        "tipo_di_asta": "Esecuzione Immobiliare Post Legge 80",
        "tipologia": "Abitazione di tipo civile",
        "foglio": "12",
        "particella": "123",
        "subalterno": "1234",
        "cod_istat": "12345",
        "data_pubblicazione": "2025-02-01",
        "data_inserimento": "2025-02-01 12:30:00",
        "giudice": "",
        "delegato": "",
        "custode": "",
        "custode_cell": "",
        "custode_tel": "",
        "custode_email": "",
        "tipo_di_vendita": "Senza Incanto",
        "offerta_minima": "67500",
        "rialzo_minimo": "1000",
        "modalita_vendita": "Sincrona Mista",
        "data_vendita": "2025-05-10 18:00:00",
        "termine_offerta": "2025-01-09 12:00:00",
        "nr_esperimento": "0",
        "valore_stima": "120000",
        "link_asta": "https://pvp.giustizia.it/pvp/...",
        "link_allegati": [
            {
                "name": "Avviso di vendita.pdf (186 Kb)",
                "url": "https://..."
            },
            {
                "name": "planimetrie.pdf (44 Kb)",
                "url": "https://..."
            },
            {
                "name": "ordinanzaweb.pdf (688 Kb)",
                "url": "https://..."
            },
            {
                "name": "Periziaweb.pdf (1073 Kb)",
                "url": "https://..."
            },
            {
                "name": "fotografie.pdf (6658 Kb)",
                "url": "https://..."
            }
        ],
        "cat_catastale": "A/1",
        "foto_satellite": "https://www.gestionale-aste.it/...",
        "foto_street_view": "https://www.gestionale-aste.it/...",
        "foto_carosello": [],
        "foto_allegati": [
            "https://www.gestionale-aste.it/...001.jpg",
            "https://www.gestionale-aste.it/...002.jpg",
            "https://www.gestionale-aste.it/...003.jpg"
        ],
        "doc_avviso": "https://...",
        "doc_perizia": "https://...",
        "doc_foto": "https://..."
    }
}

Se l'asta non viene trovata verrà restituito il codice HTTP 404 e il seguente messaggio di errore:

{
    "error": "Not Found"
}

Soluzioni e servizi aggiuntivi#

Oltre al servizio di invio email aste ai tuoi contatti, forniamo altri servizi a partire dai dati delle aste.

Panoramica aste#

Di seguito i link alle statistiche delle aste immobiliari nelle maggiori province italiane.