Evitalya API · v1

A livability score for any address in Italy

One HTTP call: a score computed from 111 metrics for any address in Italy — safety, services, transport, environment, real estate and natural risk. National coverage, official sources (ISTAT, ARPA, ISPRA, INGV, OMI, AGENAS), licences open to commercial use.

Who it is for

Estate agents and advisers

Score every address in your portfolio with one call, and put the score and the six categories in the listing. When a client asks "what is this neighbourhood like", the answer rests on official data, not on an opinion.

Relocation and immigration advisers

Compare candidate addresses before a family arrives: schools, healthcare, transport, safety and natural risk on the same scale. The insufficient_data field separates "bad" from "not measured" — which is the whole difference when you are giving advice.

Portals and software

Add an address-level score to your listing pages. The response returns codes (safety, enviro), not labels: your integration does not break when the site language changes. The quota is monthly, so a nightly import can spend it in one run.

Pricing

No contract, no sales call, no minimum term. The free plan starts immediately and asks for no card: take your key from your account and start calling. Paid plans start from your account with a credit card and are cancelled in the same place. Prices are monthly; VAT is applied according to our tax regime.

Start in five minutes

Create an account, verify your email, take your key from your account. The free plan asks for no card.

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

Why insufficient_data matters: a low score can mean the place is bad, or that there was no data to measure that category. This field separates the two — which, for a valuer, is the whole difference.

Responses

Code	Meaning
`200`	Score computed.
`401`	Key missing, invalid or revoked.
`404`	`address_not_found` — the address could not be geocoded.
`429`	`monthly_quota_exceeded` — your monthly quota is spent.
`502`	The geocoding service is temporarily unavailable.

What you should know

The quota is monthly, not daily: a nightly import or a portfolio recomputation can spend it in one run.
Category keys are codes (safety, enviro), not labels. Your integration does not break when the site language changes.
The key is shown once. The server keeps only its digest.
If you cancel, the key keeps working at the free plan's limit. We do not break your integration without warning.

What you may do: with an active plan you may publish the scores you obtain in your own product and in the documents you deliver to your client; attribution is required. Detail: Terms, section 21.

For machines: the OpenAPI description and the plans as JSON.

Start free