note rapide

note.md

Dati di occupazione/disoccupazione a livello comunale - ISTAT

Il tasso di occupazione/disoccupazione pre-calcolato a livello comunale non esiste nei dataset ISTAT come dato diretto. Ma i dati per calcolarlo ci sono, accessibili via API SDMX.

Il dataset

DF_DCSS_ISTR_LAV_PEN_2_TV_3 Popolazione residente di 15 anni e più per condizione professionale ed età - comuni

Fonte: Censimento Permanente della Popolazione (avviato nel 2018).

• Copertura: 8.126 comuni
• Anni disponibili: 2018, 2019, 2021, 2022, 2023, 2024 (2020 assente)
• Frequenza: annuale

Codici condizione professionale (CUR_ACT_STAT)

Codice	Significato
1	Occupati
12	In cerca di occupazione (disoccupati)
22	Forze di lavoro (occupati + disoccupati)
23	Non forze di lavoro
24	Pensionati
5	Studenti
4	Casalinghe/i
7	Altra condizione
99	Totale 15+

Come calcolare i tassi

Tasso di occupazione    = occupati(1)  / totale_15+(99)    * 100
Tasso di disoccupazione = in_cerca(12) / forze_lavoro(22)  * 100

Come scaricarlo via API

Singolo comune (es. Roma, codice 058091):

curl -kL -H "Accept: application/vnd.sdmx.data+csv;version=1.0.0" \
  "https://esploradati.istat.it/SDMXWS/rest/data/DF_DCSS_ISTR_LAV_PEN_2_TV_3/A.058091.RESPOP_AV.T.Y_GE15.TOTAL.ALL..ALL.ALL"

Solo l'ultimo anno disponibile per tutti i comuni:

curl -kL -H "Accept: application/vnd.sdmx.data+csv;version=1.0.0" \
  "https://esploradati.istat.it/SDMXWS/rest/data/DF_DCSS_ISTR_LAV_PEN_2_TV_3?lastNObservations=1" \
  > occupazione_comuni_ultimo_anno.csv

Dataset correlato

DF_DCSS_ISTR_LAV_PEN_2_TV_4 — stesso dataset con breakdown per cittadinanza (italiani/stranieri/apolidi), stesso livello comunale.

Riferimento

Guida usata per capire come esplorare le API SDMX di ISTAT: onData — Guida all'uso delle API REST di ISTAT https://ondata.github.io/guida-api-istat/