# Zornade

> API gratuita per dati catastali e territoriali italiani: 85 milioni di particelle, 20 blocchi dati da 15+ fonti ufficiali.

## API REST v2

- Base URL: https://api.zornade.com/api/v2
- Autenticazione: header `x-api-key` con token gratuito creato su https://app.zornade.com/api
- Rate limit: 10.000 richieste/ora per token, fino a 5 token per utente, nessun limite mensile
- Documentazione: https://app.zornade.com/api
- OpenAPI: https://api.zornade.com/api/v2/openapi.json (richiede x-api-key)
- Errori e soluzioni: https://app.zornade.com/api/errori

## Endpoint principali

- GET /api/v2/health: stato del servizio, versione, elenco endpoint (pubblico, senza key)
- GET /api/v2/geocode/search?q=...&city=...&limit=...: geocoding diretto (scope geocoding:read)
- GET /api/v2/geocode/reverse?lat=...&lng=...&radius=...: geocoding inverso (scope geocoding:read)
- GET /api/v2/admin/regions: elenco regioni (scope admin_data:read)
- GET /api/v2/admin/provinces?region=...: province (scope admin_data:read)
- GET /api/v2/admin/municipalities?province=...&region=...: comuni (scope admin_data:read)
- GET /api/v2/parcels/search?comune=...&foglio=...&label=...&sezione=...: ricerca catastale (scope parcels:read)
- GET /api/v2/parcels/locate?lat=...&lng=...: particelle da punto (scope parcels:read)
- GET /api/v2/parcels/locate?points=lat1,lng1;lat2,lng2: multi-punto, max 10 (scope parcels:read)
- GET /api/v2/parcels/locate?bbox=minLng,minLat,maxLng,maxLat: bbox, span max 0.05 gradi per lato (scope parcels:read)
- GET /api/v2/parcels/{fid|gml_id}?include=...: dettaglio particella con blocchi selezionabili (scope parcels:read)

## Blocchi dati selezionabili con include

basic, cadastral, address, addresses, risk, subsidence, terrain, population,
buildings, economics, demographics, land_cover, land_use, valuation,
valuation_history, coastal_erosion, cultural_heritage, solar, poi, nightlights.

Fonti: Agenzia delle Entrate (catasto e OMI), MEF, ISTAT, INGV, ISPRA,
Copernicus, JRC PVGIS, MiC, NASA Black Marble, WorldPop, OpenStreetMap,
Foursquare, OpenAddresses.

## Attribuzione e licenze

- Le attribuzioni alle fonti dati sono sempre obbligatorie, per tutti i licenziatari.
- L'attribuzione a Zornade (campo meta.zornade_attribution_required) è rinunciabile solo con licenza commerciale.
- Il piano gratuito non richiede pagamenti. Token gratuiti, 10.000 richieste/ora.

## Pagine per caso d'uso

- API Quotazioni OMI: https://app.zornade.com/api/quotazioni-omi
- API Valutazioni Immobiliari: https://app.zornade.com/api/valutazioni-immobiliari
- API Rischio Idrogeologico e Sismico: https://app.zornade.com/api/rischio-idrogeologico
- API Geocoding Italia: https://app.zornade.com/api/geocoding
- Mappa catastale online: https://app.zornade.com/mappa-catastale-online
- Geoportale catastale: https://app.zornade.com/geoportale-catastale

## MCP Server

Zornade è disponibile come server MCP per Claude, Cursor e altri client compatibili.

- Endpoint: https://mcp.zornade.com/mcp
- Guida: https://zornade.com/blog/server-mcp-catasto-italiano-claude-cursor

## Contatti

- Sito: https://zornade.com
- Stato: https://status.zornade.com
- Supporto: https://zornade.com/servizi-sviluppo-software#contact