Open data API

API GoccIA

Endpoint REST pubblici per i 24 parametri dell'acqua potabile italiana analizzati dal motore GoccIA. Dati conformi al D.Lgs. 18/2023 e alle linee guida WHO/EFSA. Niente chiave API, niente registrazione, licenza CC-BY 4.0.

Base URL

https://goccia.org/api/v1

CORS aperto (Access-Control-Allow-Origin: *) · Cache 1h · Risposta JSON. Rate limit non strict ma evita più di 60 richieste/minuto.

GET /api/v1/parameters

Restituisce l'elenco completo dei 24 parametri con limiti di legge, range ideali, pesi del subscore e link alla scheda divulgativa.

Esempio cURL

curl -s https://goccia.org/api/v1/parameters | jq '.parameters[0]'

Esempio risposta (estratto)

{
  "api": "GoccIA Open Data",
  "version": "v1",
  "license": "CC-BY 4.0",
  "parameters": [
    {
      "id": "ph",
      "name_it": "pH",
      "aliases": ["ph", "p.h.", "concentrazione ioni idrogeno"],
      "unit": "unità pH",
      "legal_limit": { "min": 6.5, "max": 9.5 },
      "ideal_range": { "min": 7, "max": 8 },
      "weights": { "health": 0, "aesthetic": 0.3, "pipe": 0.7 },
      "microbiological": false,
      "guide_url": "https://goccia.org/parametri/ph",
      "source": {
        "legal": "D.Lgs. 18/2023 (recepimento Direttiva UE 2020/2184)",
        "ideal": "WHO Guidelines for Drinking-water Quality (4th ed.) — EFSA"
      }
    }
  ]
}

GET /api/v1/parameters/{id}

Restituisce i dettagli di un singolo parametro per id (es. piombo, e_coli, pfas_totali).

Esempio cURL

curl -s https://goccia.org/api/v1/parameters/piombo

Risposta

{
  "id": "piombo",
  "name_it": "Piombo",
  "aliases": ["piombo", "pb", "lead"],
  "unit": "µg/L",
  "legal_limit": { "max": 10 },
  "ideal_range": { "max": 1 },
  "weights": { "health": 1, "aesthetic": 0, "pipe": 0 },
  "microbiological": false,
  "guide_url": "https://goccia.org/parametri/piombo",
  "license": "CC-BY 4.0",
  "citation": "GoccIA — goccia.org — Labservice S.r.l."
}

Come citare l'API

La licenza CC-BY 4.0 richiede solo che venga indicata la fonte. Formato consigliato:

Dati: GoccIA Open Data API — goccia.org — Labservice S.r.l. — CC-BY 4.0

Per pubblicazioni accademiche:

@misc{goccia_api_2026,
  title = {GoccIA Open Data API: parametri dell'acqua potabile italiana},
  author = {{Labservice S.r.l.}},
  year = {2026},
  url = {https://goccia.org/api-docs},
  note = {CC-BY 4.0}
}

Esempi d'uso

JavaScript / Node

const res = await fetch('https://goccia.org/api/v1/parameters/nitrati');
const data = await res.json();
console.log(data.legal_limit.max); // 50

Python

import requests
data = requests.get('https://goccia.org/api/v1/parameters').json()
for p in data['parameters']:
    print(p['id'], p['legal_limit'])

Contatti developer

Bug, feature request, integrazioni: dev@goccia.org o aprire una issue su GitHub.

Vedi anche il press kit per asset visivi, embed widget e contatti stampa.