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, è 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 ogni 3 secondi.

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 richiesta GET fornendo i seguenti parametri:

codice_comune Obbligatorio

È il codice catastale del comune (es. G273 per Palermo).

anno Facoltativo

Anno di riferimento delle quotazioni (es. 2004).
Default: restituisce gli ultimi dati rilasciati dall'Agenzia Delle Entrate

operazione Facoltativo

Specifica il tipo di operazione: affitto o acquisto.
Se non indicato, restituisce entrambi.

zona_omi Facoltativo

Filtra i risultati per zona OMI (es. B1). Se omesso, cerca nell'intero comune.

Trova la tua zona OMI

metri_quadri Facoltativo

Numero di metri quadrati commerciali dell'immobile.
Default: 1

tipo_immobile Facoltativo

Indica la tipologia di immobile. Consulta la lista qui sotto.

Valori ammessi per il parametro tipo_immobile

abitazioni_civili (A/2)
ville_e_villini (A/7, A/8)
abitazioni_di_tipo_economico (A/3-4-5)
abitazioni_signorili (A/1)
negozi (C/1)
uffici (A/10, B/4)
box (C/6)
posti_auto_scoperti (C/7)

posti_auto_coperti (C/6, C/7)
capannoni_tipici (C/2)
magazzini (C/2)
laboratori (C/3)
autorimesse (C/6)
capannoni_industriali (D/7)
centri_commerciali (D/8)
uffici_strutturati (A/10)

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&anno=2021

Output:

   
{
  "abitazioni_civili":
  {
    "stato_di_conservazione_mediano_della_zona":"normale",
    "prezzo_acquisto_min":94000.0,
    "prezzo_acquisto_max":135000.0,
    "prezzo_acquisto_medio":114500.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 💶🏡

Importante novità:

È ora possibile includere nella ricerca l'anno di riferimento delle quotazioni, continuare a leggere la pagina per più informazioni.

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