Evitalya API · v1

Una puntuación de habitabilidad para cualquier dirección de Italia

Una sola llamada HTTP: una puntuación calculada a partir de 111 métricas para cualquier dirección de Italia — seguridad, servicios, movilidad, medio ambiente, inmobiliario y riesgos naturales. Cobertura nacional, fuentes oficiales (ISTAT, ARPA, ISPRA, INGV, OMI, AGENAS), licencias abiertas al uso comercial.

Para quién es

Agencias y asesores inmobiliarios

Puntúa cada dirección de tu cartera con una sola llamada y pon la puntuación y las seis categorías en la ficha del anuncio. Cuando el cliente pregunta «cómo es este barrio», la respuesta se apoya en datos oficiales, no en una opinión.

Relocation y asesores de expatriación

Compara direcciones candidatas antes de que llegue una familia: escuelas, sanidad, transporte, seguridad y riesgo natural en la misma escala. El campo insufficient_data separa «malo» de «no medido» — que es toda la diferencia cuando das un consejo.

Portales y software

Añade a tus fichas una puntuación a nivel de dirección. La respuesta devuelve códigos (safety, enviro), no etiquetas: tu integración no se rompe cuando cambia el idioma del sitio. La cuota es mensual, así que una importación nocturna puede gastarla de una vez.

Precios

Sin contrato, sin negociación, sin permanencia. El plan gratuito empieza al momento y no pide tarjeta: coge tu clave desde tu cuenta y empieza a llamar. Los planes de pago se activan desde tu cuenta con tarjeta y se cancelan en el mismo sitio. Los precios son mensuales; el IVA se aplica según nuestro régimen fiscal.

Empieza en cinco minutos

Crea una cuenta, verifica tu correo, coge tu clave desde tu cuenta. El plan gratuito no pide tarjeta.

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

Por qué importa insufficient_data: una puntuación baja puede significar que el sitio es malo, o que no había datos para medir esa categoría. Este campo separa ambas cosas — y para un tasador esa es toda la diferencia.

Respuestas

Código	Significado
`200`	Puntuación calculada.
`401`	Clave ausente, no válida o revocada.
`404`	`address_not_found` — la dirección no se pudo geocodificar.
`429`	`monthly_quota_exceeded` — tu cuota mensual se ha agotado.
`502`	El servicio de geocodificación no está disponible temporalmente.

Lo que conviene saber

La cuota es mensual, no diaria: una importación nocturna o el recálculo de una cartera puede gastarla de una vez.
Las claves de categoría son códigos (safety, enviro), no etiquetas. Tu integración no se rompe cuando cambia el idioma del sitio.
La clave se muestra una sola vez. El servidor guarda solo su huella.
Si cancelas, la clave sigue funcionando con el límite del plan gratuito. No rompemos tu integración sin avisar.

Lo que puedes hacer: con un plan activo puedes publicar las puntuaciones que obtienes en tu propio producto y en los documentos que entregas a tu cliente; la atribución es obligatoria. Detalle: Condiciones, cláusula 21.

Para máquinas: la descripción OpenAPI y los planes en JSON.

Empieza gratis