Evitalya API · v1

Ein Lebensqualitäts-Score für jede Adresse in Italien

Ein einziger HTTP-Aufruf: ein aus 111 Kennzahlen berechneter Score für jede beliebige Adresse in Italien – Sicherheit, Versorgung, Mobilität, Umwelt, Immobilien und Naturgefahren. Landesweite Abdeckung, amtliche Quellen (ISTAT, ARPA, ISPRA, INGV, OMI, AGENAS), Lizenzen, die eine kommerzielle Nutzung erlauben.

Für wen die API gedacht ist

Immobilienmakler und -berater

Ermitteln Sie mit einem einzigen Aufruf den Score jeder Adresse Ihres Portfolios und nehmen Sie den Score und die sechs Kategorien in das Exposé auf. Wenn Ihr Kunde fragt: „Wie ist die Gegend hier?“, stützt sich die Antwort auf amtliche Daten, nicht auf eine Meinung.

Relocation-Dienstleister und Berater für den Umzug ins Ausland

Vergleichen Sie infrage kommende Adressen, bevor eine Familie ankommt: Schulen, Gesundheitsversorgung, Mobilität, Sicherheit und Naturrisiko auf derselben Skala. Das Feld insufficient_data trennt „schlecht“ von „nicht gemessen“ – und genau darauf kommt es an, wenn Sie eine Empfehlung abgeben.

Portale und Software

Ergänzen Sie Ihre Exposés um einen Score auf Adressebene. Die Antwort liefert Codes (safety, enviro), keine Bezeichnungen: Die Integration funktioniert weiter, auch wenn sich die Sprache der Website ändert. Das Kontingent gilt pro Monat, ein nächtlicher Import kann es also in einem Durchlauf aufbrauchen.

Preise

Kein Vertrag, keine Verhandlungen, keine Mindestlaufzeit. Der kostenlose Tarif startet sofort und erfordert keine Karte: Sie holen sich den Schlüssel in Ihrem Konto und beginnen mit den Aufrufen. Die kostenpflichtigen Tarife werden über Ihr Konto mit Kreditkarte aktiviert und an derselben Stelle gekündigt. Die Preise verstehen sich pro Monat; die MwSt. richtet sich nach unserer Steuerregelung.

In fünf Minuten startklar

Erstellen Sie ein Konto, bestätigen Sie Ihre E-Mail-Adresse und holen Sie sich den Schlüssel in Ihrem Konto. Der kostenlose Tarif erfordert keine Karte.

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": []
}

Warum insufficient_data wichtig ist: Ein niedriger Score kann bedeuten, dass die Lage schlecht ist oder dass keine Daten vorlagen, um diese Kategorie zu messen. Dieses Feld trennt die beiden Fälle – und für Gutachter ist genau das entscheidend.

Antworten

Code	Bedeutung
`200`	Score berechnet.
`401`	Schlüssel fehlt, ist ungültig oder wurde widerrufen.
`404`	`address_not_found` – die Adresse konnte nicht geokodiert werden.
`429`	`monthly_quota_exceeded` – das Monatskontingent ist ausgeschöpft.
`502`	Der Geokodierungsdienst ist vorübergehend nicht verfügbar.

Wichtig zu wissen

Das Kontingent gilt pro Monat, nicht pro Tag: Ein nächtlicher Import oder die Neuberechnung eines Portfolios kann es in einem einzigen Durchlauf aufbrauchen.
Die Kategorieschlüssel sind Codes (safety, enviro), keine Bezeichnungen. Die Integration funktioniert weiter, auch wenn sich die Sprache der Website ändert.
Der Schlüssel wird nur einmal angezeigt. Der Server speichert davon nur einen Hash.
Wenn Sie kündigen, funktioniert der Schlüssel weiter – im Rahmen des kostenlosen Tarifs. Wir legen Ihre Integration nicht ohne Vorankündigung lahm.

Was Sie tun dürfen: Mit einem aktiven Tarif dürfen Sie die Scores, die Sie erhalten, in Ihrem Produkt und in den Dokumenten veröffentlichen, die Sie Ihrem Kunden übergeben; die Quellenangabe ist Pflicht. Einzelheiten: Nutzungsbedingungen, Artikel 21.

Für Maschinen: die OpenAPI-Beschreibung und die Preisliste als JSON.

Kostenlos starten