F.A.Q. generali

Cosa sono le quotazioni immobiliari OMI?

Le quotazioni immobiliari OMI sono dei valori di riferimento forniti dall’Agenzia delle Entrate per stimare in modo rapido il prezzo di vendita o di affitto di un immobile, sulla base della sua tipologia, ubicazione e della superficie espressa in metri quadrati.

Queste quotazioni sono affidabili?

Rappresentano il miglior modo per ottenere una stima di un immobile avendo pochissime informazioni. Sono rilasciate dall'Agenzia delle Entrate e si basano sugli atti di compravendita e sui contratti di locazione dell'ultimo semestre (attualmente il secondo semestre del 2024).
Clicca qui per saperne di più

Per utilizzare l'API è necessario effettuare un login?

No, l'API si utilizza grazie a una semplice chiamata che non richiede autenticazione (le istruzioni sono sotto).

Tuttavia, come prevede la licenza MIT, è obbligatorio attribuire i crediti in caso di utilizzo. Dunque si prega di inserire un link che riporti alla pagina web ufficiale dell'API in caso di utilizzo del servizio in progetti pubblici.

Non esistono le API ufficiali fornite dall'Agenzia delle Entrate?

Domanda retorica, no. Questo è il primo servizio libero e gratuito per accedere automaticamente alle quotazioni OMI più aggiornate.

Oltre a non fornire API, il portale dell'Agenzia delle Entrate ha vari limiti: ad esempio è necessario completare manualmente un CAPTCHA ogni volta che si vuole inoltrare una richiesta.

Quali sono i limiti di utilizzo?

Il servizio è libero, anche per uso commerciale. Le richieste sono illimitate, ma non troppe in poco tempo: hai un credito di 100 richieste, che si ricarica al ritmo di 1 richiesta al secondo.

Per aumentare i limiti, ottenere risposte più rapide ed eliminare l’obbligo di attribuzione, contattami: d.sagona.20@gmail.com

Come si utilizza?

Per utilizzare il servizio è sufficiente effettuare una semplice richiesta GET fornendo i seguenti parametri:

codice_comune – Obbligatorio. È il codice catastale del comune (es. G273 per Palermo).
metri_quadri – Facoltativo. Numero di metri quadrati commerciali dell'immobile. Il valore predefinito è 1.
operazione – Facoltativo. Specifica il tipo di operazione: affitto o acquisto.
zona_omi – Facoltativo. Filtra per zona OMI. Trova la zona qui.
tipo_immobile – Facoltativo. Tipologia di immobile (es. ville_e_villini).

Elenco di valori ammessi per tipo_immobile:

(le categorie tra parentesi sono puramente indicative)

abitazioni_civili (cat. A/2)
ville_e_villini (cat. A/7, A/8)
abitazioni_di_tipo_economico (cat. A/3, A/4, A/5)
abitazioni_signorili (cat. A/1)
negozi (cat. C/1)
uffici (cat. A/10, B/4)
box (cat. C/6)
posti_auto_scoperti (cat. C/7)
posti_auto_coperti (cat. C/6, C/7)
capannoni_tipici (cat. C/2)
magazzini (cat. C/2)
laboratori (cat. C/3)
autorimesse (cat. C/6)
capannoni_industriali (cat. D/7)
abitazioni_tipiche_dei_luoghi (cat. A/9, A/11)
centri_commerciali (cat. D/8)
uffici_strutturati (cat. A/10, B/4)

Esempio di richiesta completa tramite browser

https://3eurotools.it/api-quotazioni-immobiliari-omi/ricerca?codice_comune=G273&tipo_immobile=abitazioni_civili&metri_quadri=100&zona_omi=B3&operazione=acquisto

Output:

{
  "abitazioni_civili": {
    "stato_di_conservazione_mediano_della_zona": "normale",
    "prezzo_acquisto_min": 100000.0,
    "prezzo_acquisto_max": 145000.0,
    "prezzo_acquisto_medio": 122500.0
  }
}

Spiegazione: Il campo stato_di_conservazione_mediano_della_zona indica il livello mediano di conservazione degli immobili nella zona (può essere "ottimo", "normale", "scadente").

I prezzi minimo e massimo indicano l'intervallo stimato dei valori considerati rispettivamente economici e costosi per la zona di riferimento. Non rappresentano gli estremi reali delle compravendite o dei contratti di locazione, servono infatti per stabilire un range di prezzo accurato.

Ad esempio un attico ristrutturato si posizionerà nella parte alta del range, mentre un piano terra in cattive condizioni in quella bassa. Il prezzo medio è la media aritmetica tra minimo e massimo.

Esempio in Python

import requests

url = "https://3eurotools.it/api-quotazioni-immobiliari-omi/ricerca"
params = {
  "codice_comune": "G273",
  "metri_quadri": 100,
  "operazione": "acquisto",
  "zona_omi": "B22",
  "tipo_immobile": "abitazioni_di_tipo_economico"
}

response = requests.get(url, params=params)
print(response.text)

Esempio in Javascript

const params = new URLSearchParams({
  codice_comune: "G273",
  metri_quadri: 100,
  operazione: "acquisto",
  zona_omi: "B22",
  tipo_immobile: "abitazioni_di_tipo_economico"
});

fetch("https://3eurotools.it/api-quotazioni-immobiliari-omi/ricerca?" + params)
  .then(response => response.text())
  .then(data => console.log(data));

	Senza API OMI (dataset)	Con API OMI
Gestione del dataset	Richiede gestione manuale e risorse elevate	Dati in tempo reale, nessuna gestione o manutenzione necessaria
Aggiornamenti	Scaricare e integrare manualmente ogni semestre	API aggiornata automaticamente
Tempo richiesto	Ore per scaricare, processare, integrare	Risultati istantanei con una chiamata API

3eurotools.it

API Quotazioni Immobiliari OMI 💶🏡

ATTENZIONE: questo è uno strumento di sviluppo, è rivolto esclusivamente a sviluppatori e a soggetti con competenze tecniche.