Hai bisogno di integrare i dati delle aste nel tuo sistema?
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/asteEsempio di autenticazione con basic authentication:
curl https://test:test@www.gestionale-aste.it/api/asteCon 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#
| Codice HTTP | Descrizione |
|---|---|
| 200 | Richiesta avvenuta con successo |
| 401 | Autenticazione fallita |
| 400 | Request non valida (parametri mancanti o errati) |
| 403 | Provincia non presente nel tuo abbonamento |
| 404 | Asta non trovata |
| 429 | Troppe richieste (massimo una richiesta al secondo) |
| 500 | Errore imprevisto del server |
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/asteRisposta 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 parametro aste_rimanenti indica quante aste ci sono ancora.
Il parametro ultimo_id contiene l'ultimo id restituito e può essere utilizzato per le chiamate successive per farsi tornare le prossime aste.
Pertanto l'algoritmo per farsi dare tutte le aste disponibili è il seguente:
while aste_rimanenti > 0:
GET /aste?id=<ultimo_id>Parametri opzionali
| Parametro | Spiegazione |
|---|---|
| output_format | può valere json (il default) o xml e indica il formato con cui verranno restituiti i dati delle aste (JSON o XML) |
| limit | indica quante aste si vogliono ottenere al più in una singola chiamata (default/massimo 100) |
| id | indica che si vogliono avere le aste con id maggiore di quello specificato (tipicamente l'ultimo id restituito dalla chiamata precedente, utile per la paginazione dei risultati) |
| prov | indica che si vogliono avere le aste solo di una certa provincia (es. "RM" per la provincia di Roma) |
Esempio: ottenere i dati in formato XML
curl -H "X-Api-Key: test" https://www.gestionale-aste.it/api/aste?output_format=xmlEsempio: 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/123456Risposta 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"
}Database#
Per sapere attualmente quante aste sono contenute nel nostro database puoi andare alla seguente pagina: N. aste per provincia
Prezzo#
Calcola il tuo preventivo online
Contattaci#
Contattaci per avere maggiori informazioni.
Inviando i dati del modulo sottostante accetti le condizioni sulla privacy.
Vuoi farti un'idea sui dati delle aste?#
Per farti un'idea dei dati delle aste puoi scaricare il file Excel dimostrativo contenente 10 aste scelte a caso su Milano e provincia.
Quando apri il file Excel ricordati di cliccare su Abilita modifica per poter applicare i filtri e seguire i link.
Soluzioni e servizi aggiuntivi#
Oltre al servizio di invio email aste ai tuoi contatti, forniamo altri servizi a partire dai dati delle aste.
Excel Aste Immobiliari
Ogni lunedì ti inviamo l'Excel aggiornato con tutte le aste della tua zona
Pubblicazione Aste su Getrix/Immobiliare.it
Ogni settimana carichiamo sul tuo account Getrix le aste della tua zona, personalizzate come vuoi tu