123Acqua Public API v1

API per ricercatori, giornalisti e sviluppatori

Accesso programmabile ai dati di qualità dell'acqua in Italia: calcolo GoccIA, configurazione parametri normativi (D.Lgs. 18/2023), aggregati statistici per provincia. Pensata per università, redazioni di inchiesta, ONG e startup civic-tech.

Crea una API key gratuita Scarica OpenAPI 3.0

Tier gratuito

Per progetti accademici, prototipi e tesi.

1000 richieste/giorno
Tutti e 3 gli endpoint v1
Dati con licenza CC BY 4.0
Nessuna carta richiesta

0 EUR

CONSIGLIATO PRODUZIONE

Tier paid

Per redazioni, ONG, prodotti commerciali.

Richieste illimitate
Priorità in caso di degrado
SLA risposta 24h
Fattura elettronica IT

99 EUR/mese

Esempi rapidi

POST /api/v1/aquascore

Calcola GoccIA (1-99) da un set di parametri.

curl -X POST https://123acqua.com/api/v1/aquascore \
  -H "Authorization: Bearer 123aq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "parameters": [
      { "parameter_id": "nitrati", "numeric_value": 12.4, "unit": "mg/L" },
      { "parameter_id": "ph", "numeric_value": 7.6 }
    ]
  }'

GET /api/v1/parameters

Lista PARAMETER_CONFIGS: soglie legali (D.Lgs. 18/2023) e ideali.

curl https://123acqua.com/api/v1/parameters \
  -H "Authorization: Bearer 123aq_live_..."

GET /api/v1/aggregato

Dati aggregati per provincia/parametro/mese (percentili 10/50/90).

curl "https://123acqua.com/api/v1/aggregato?province=MI&parameter_id=nitrati&month_from=2026-01" \
  -H "Authorization: Bearer 123aq_live_..."

Documentazione completa

La specifica OpenAPI 3.0 è disponibile in YAML e può essere importata in Postman, Insomnia, Swagger UI o generatori client SDK.

/api-docs/openapi-v1.yaml