Read the yearly tourism series of an Italian comune
leggi_serie_comuneReads the yearly series of nights spent (presenze) and arrivals of one Italian comune, split by guests resident in Italy and abroad, over a range of years. Use it for the trend of one comune, given its 6-digit cod_istat from cerca_comune; do not use it for one year or for capacity and population (use leggi_dati_comune instead), or for several comuni (use confronta_comuni instead). Rows are yearly, oldest first; from 2025 ISTAT counts include privately rented holiday flats, so anno_discontinuita and nota flag that totals across 2025 are not comparable (hotel figures are). A comune without figures returns an empty list in serie with a nota, and a range outside its years with data or an unknown code returns an error that says what to pass. Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cod_istat": "<cod_istat>"
},
"name": "leggi_serie_comune"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| a_anno | No | Last year to include, e.g. 2024, not before `da_anno`; default: the latest year with data. A range with no year of data returns an error that gives the years. | |
| da_anno | No | First year to include, e.g. 2015; default: the first year with data. | |
| cod_istat | Yes | 6-digit ISTAT code of the comune as a string, leading zeros kept ("058091" is Roma); it comes from cerca_comune. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nome | Yes | Official name of the comune. | |
| nota | Yes | Notes in English on reading the series (the change of scope above, a comune without figures, or a range without a year of figures); null otherwise. | |
| fonte | Yes | Source to cite with the figures: processed by DatiTuristici.it from institutional data (ISTAT). | |
| serie | Yes | One row per year with movement figures, oldest first, from `da_anno` to `a_anno`; yearly figures only. An empty list when the comune has none, or none in that range (`nota` then lists the years that have figures). | |
| scheda | Yes | Link to the comune's public page on datituristici.it, to cite. | |
| regione | Yes | Region as recorded by ISTAT (Bolzano and Trento are provinces of TRENTINO-ALTO ADIGE); null if not recorded. | |
| cod_istat | Yes | 6-digit ISTAT code of the comune, as a string with leading zeros kept. | |
| provincia | Yes | Province (or metropolitan city) as recorded by ISTAT; null if not recorded. | |
| anno_discontinuita | Yes | 2025 when the series reaches it: from 2025 ISTAT counts include privately rented holiday flats, so totals and non-hotel figures are not comparable with years before 2025 (hotel figures are). Null when every row is before 2025. |