Developer Documentation

API pubbliche cantieri italiani.

REST JSON API per accedere programmaticamente al database cantieri Italia Cantieri. Gratuita, senza autenticazione per uso pubblico, conforme open data CC BY 4.0.

60 req/min

2.000/giorno per IP

JSON REST

UTF-8, RFC 7159

HTTPS only

TLS 1.3

Endpoints

GET /api/cantieri

Lista cantieri paginata con filtri

Parametri

Nome	Tipo	Descrizione
regione	string	Es. "Piemonte"
provincia	string	Sigla 2 lettere, es. "TO"
comune	string	Nome comune
categoria	string	Es. "ristrutturazione"
tipo_titolo	string	"PDC", "SCIA", "CILA", "PAS", "DIA", "CONCESSIONE"
limit	number	Default 50, max 200
offset	number	Paginazione

Esempio cURL

curl "https://www.italiacantieri.it/api/cantieri?regione=Piemonte&limit=5"

GET /api/comuni/autocomplete

Autocompletamento comuni

Parametri

Nome	Tipo	Descrizione
q	string	Query, minimo 2 caratteri

Esempio cURL

curl "https://www.italiacantieri.it/api/comuni/autocomplete?q=ales"

Esempio risposta JSON

{
  "data": [
    {
      "id": "...",
      "slug": "2025-bologna-2025-966474-pdc",
      "tipo_titolo": "PDC",
      "comune": "Bologna",
      "provincia": "BO",
      "regione": "Emilia-Romagna",
      "indirizzo": "Via XX Settembre",
      "civico": "12",
      "data_pubblicazione": "2025-03-14",
      "importo_lavori": 450000,
      "categorie": ["ristrutturazione", "facciate"],
      "fonte_tipo": "open_data_PA",
      "url_fonte": "https://opendata.comune.bologna.it/..."
    }
  ],
  "total": 1759,
  "page": 1,
  "limit": 5
}

Licenza e attribuzione

CC BY 4.0 — dati aperti, attribuzione richiesta

Dati

CC BY 4.0

Attribuzione

italiacantieri.it (AZIENDA 365 SRL)

Uso commerciale

Permesso con attribuzione

Modifiche

Permesse con menzione fonte

Esempio di attribuzione richiesta: Dati: italiacantieri.it (AZIENDA 365 SRL), CC BY 4.0

Serve una chiave API dedicata?

Per uso istituzionale (PA, universita, ricerca) con rate limit personalizzato, SLA e dataset aggiuntivi (CSV/GeoJSON export, webhook nuovi cantieri): api@italiacantieri.it.

Programma partnership PA