Evitalya API · v1

Un punteggio di vivibilità per ogni indirizzo in Italia

Una sola chiamata HTTP: un punteggio calcolato da 111 metriche per qualunque indirizzo in Italia — sicurezza, servizi, trasporti, ambiente, immobiliare e rischi naturali. Copertura nazionale, fonti ufficiali (ISTAT, ARPA, ISPRA, INGV, OMI, AGENAS), licenze aperte all'uso commerciale.

A chi serve

Agenzie e consulenti immobiliari

Assegni un punteggio a ogni indirizzo del portafoglio con una chiamata sola, e metti il punteggio e le sei categorie nella scheda dell'annuncio. Quando il cliente chiede «com'è questa zona», la risposta poggia su dati ufficiali, non su un'opinione.

Relocation e consulenti per l'espatrio

Confronti gli indirizzi candidati prima che una famiglia arrivi: scuole, sanità, trasporti, sicurezza e rischio naturale sulla stessa scala. Il campo insufficient_data separa «cattivo» da «non misurato» — che è tutta la differenza quando stai dando un consiglio.

Portali e software

Aggiungi alle schede annuncio un punteggio a livello di indirizzo. La risposta rende codici (safety, enviro), non etichette: l'integrazione non si rompe quando cambia la lingua del sito. La quota è mensile, quindi un import notturno può consumarla in una volta.

Prezzi

Nessun contratto, nessuna trattativa, nessuna durata minima. Il piano gratuito parte subito e non chiede la carta: prendi la chiave dal tuo account e cominci a chiamare. I piani a pagamento si attivano dal tuo account con carta di credito e si disdicono nello stesso posto. I prezzi sono mensili; l'IVA si applica secondo il nostro regime fiscale.

Si comincia in cinque minuti

Apri un account, verifica l'email, prendi la chiave dal tuo account. Il piano gratuito non chiede la carta.

curl -X POST https://evitalya.com/v1/score \
  -H "x-api-key: ev_pro_..." \
  -H "content-type: application/json" \
  -d '{"address": "Via Vigevano 12, Milano"}'

{
  "schema": "evitalya.score.v1",
  "plan": "pro",
  "address": { "resolved": "Via Vigevano 12, Milano", "istat": "015146",
               "comune": "Milano", "provincia": "MI" },
  "score": 72.4,
  "reliability": 0.91,
  "reliability_code": "high",
  "categories": {
    "safety":       { "score": 68.2, "reliability": 0.88 },
    "services":     { "score": 79.5, "reliability": 0.93 },
    "mobility":     { "score": 84.1, "reliability": 0.90 },
    "enviro":       { "score": 61.7, "reliability": 0.95 },
    "realestate":   { "score": 70.3, "reliability": 0.87 },
    "natural_risk": { "score": 88.0, "reliability": 0.96 }
  },
  "measured_metrics": 104,
  "total_metrics": 111,
  "insufficient_data": []
}

Perché insufficient_data conta: un punteggio basso può voler dire che il posto è brutto, oppure che non c'erano dati per misurare quella categoria. Questo campo separa le due cose — e per chi fa una perizia è tutta la differenza.

Risposte

Codice	Significato
`200`	Punteggio calcolato.
`401`	Chiave assente, non valida o revocata.
`404`	`address_not_found` — l'indirizzo non è stato geocodificato.
`429`	`monthly_quota_exceeded` — la quota mensile è esaurita.
`502`	Il servizio di geocodifica è temporaneamente non disponibile.

Quello che devi sapere

La quota è mensile, non giornaliera: un import notturno o il ricalcolo di un portafoglio può consumarla in una volta sola.
Le chiavi di categoria sono codici (safety, enviro), non etichette. L'integrazione non si rompe quando cambia la lingua del sito.
La chiave si vede una volta sola. Il server ne conserva solo l'impronta.
Se disdici, la chiave continua a funzionare al limite del piano gratuito. Non rompiamo la tua integrazione senza avvisare.

Che cosa puoi fare: con un piano attivo puoi pubblicare i punteggi che ottieni nel tuo prodotto e nei documenti che consegni al tuo cliente; l'attribuzione è obbligatoria. Il dettaglio: Termini, articolo 21.

Per le macchine: la descrizione OpenAPI e il listino in JSON.

Comincia gratis