cerca_comune
Search Italian comuni by name
Searches Italian municipalities (comuni) by name, tolerating partial names and typos, and returns each match with its 6-digit ISTAT code, province and region. Use it when you have a place name and need the code; when you already have the 6-digit code, do not search again and use leggi_dati_comune instead, to pick comuni by criteria use classifica_territori, and to browse a province use elenca_territori. All homonyms are returned, most similar first (narrow them with `provincia` or `regione`); an empty list means nothing resembles the text and is not an error. Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
输入参数nome必填limiteregioneprovincia
leggi_dati_comune
Read tourism figures of an Italian comune
Reads the tourism figures of one Italian municipality (comune) in one year: nights spent (presenze), arrivals, bed places, accommodation establishments and resident population. Use it when you have the 6-digit `cod_istat` from cerca_comune; do not use it to look a place up by name (use cerca_comune instead), to follow a comune over the years (use leggi_serie_comune instead) or to put comuni side by side (use confronta_comuni instead). Presenze are nights, not people (one guest staying three nights counts three); `anno` defaults to the latest year with data, and capacity figures are for `anno_capacita`: the latest year published, as on the comune's page, or the latest up to `anno` when `anno` is given. Missing figures are null and `nota` says why (also from 2025, when the counts changed scope), and a year outside `anni_disponibili` 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.
输入参数annocod_istat必填
elenca_territori
List Italian regions, provinces and comuni
Lists Italian regions, provinces or comuni in alphabetical order, with how many provinces and comuni each region has and how many comuni each province has. Use it to browse the territory and to get the exact names that classifica_territori accepts; do not use it to rank places by tourism figures (use classifica_territori instead) or to look one comune up by name (use cerca_comune instead). Names ignore case, accents and punctuation, and Trentino-Alto Adige is one region with the two provinces of Bolzano and Trento; an unknown or ambiguous name returns an error with the closest names, a comune without a recorded province has null there, and a page past the end is an empty list. Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
输入参数limiteoffsetlivello必填regioneprovincia
classifica_territori
Rank Italian territories by tourism figures
Ranks and filters Italian comuni, provinces or regions by the tourism figures of one year, with the same rows, order and values as the advanced search (Esplora) on datituristici.it. Use it for questions with criteria, such as the comuni of a region with the most nights or those above a bed occupancy threshold; do not use it to read one known comune (use leggi_dati_comune instead), to look a place up by name (use cerca_comune instead) or to browse names (use elenca_territori instead). Figures are for `anno`, by default the latest year with data; a figure that is not available is null, an empty list means that no territory meets the criteria, and in 2025 `variazione` is null because the counts started including privately rented holiday flats (`nota` explains it). Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
输入参数annofiltrilimiteoffsetordinelivelloregioneandamentoprovinciaordina_per
leggi_dati_territorio
Read tourism totals of an Italian region, province or Italy
Reads the tourism totals of one Italian region, one province or the whole of Italy in one year: nights, arrivals, bed places, establishments and population. Use it for the figures of a whole territory, split by guests resident in Italy and abroad; do not use it to rank or filter territories (use classifica_territori instead) or for a single comune (use leggi_dati_comune instead). Names ignore case and accents, Trentino-Alto Adige is one region with the provinces of Bolzano and Trento, and an unknown name returns an error with the closest names (elenca_territori lists them all). The totals are those of classifica_territori for the same year; a figure that is not available is null and `nota` says why, also from 2025, when the counts changed scope. Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
输入参数annonomelivello必填
leggi_serie_comune
Read the yearly tourism series of an Italian comune
Reads 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.
输入参数a_annoda_annocod_istat必填
confronta_comuni
Compare tourism figures of Italian comuni side by side
Compares 2 to 5 Italian comuni side by side in the same year: nights, arrivals, bed places, establishments, population, average stay and share of arrivals from abroad. Use it when the question is about several comuni at once and you have their 6-digit codes from cerca_comune; do not use it for one comune (use leggi_dati_comune instead) or to rank many by a criterion (use classifica_territori instead). `anno` defaults to the latest year with figures for every comune, so the numbers stay comparable; a comune without figures in that year keeps null values and `nota` names it, also flagging 2025 and later, when the counts changed scope. Fewer than 2 or more than 5 codes, a repeated code or an unknown one returns an error that says what to pass. Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
输入参数annocod_istat必填
leggi_previsioni_comune
Read the projection of an Italian comune with uncertainty and reliability
Reads the statistical projection of one Italian municipality (comune) for the year after the latest ISTAT year: total, hotel and non-hotel nights and arrivals. Use it when you have the 6-digit `cod_istat` from cerca_comune and the question is what to expect next; do not use it for past figures (use leggi_serie_comune instead) or to set comuni side by side (use confronta_comuni instead). Each line gives last year's real figure, the projected figure and `affidabilita_pct` (0 to 100, measured by projecting a past year), and only the total has the p10 to p90 uncertainty band; a line that fails the checks has `disponibile` false and a `motivo`, a comune without a yearly series returns an empty list in `linee` with a `nota`, and a missing figure is null. These are estimates, not official statistics, and they are served only while the site shows projections to everyone, otherwise the call returns an error. Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
输入参数cod_istat必填
leggi_copertura_dati
Read how far the tourism figures go and how recent they are
Reads which tourism figures the service holds and how recent they are: the latest year, how many comuni are covered, the last import, what each metric means and the 2025 break in the series. Use it to check how current the figures are, what a metric means or why a comune has a gap; do not use it to read the figures themselves (use leggi_dati_comune instead) or to find a comune by name (use cerca_comune instead). With a 6-digit `cod_istat` it adds the years with figures and with capacity for that comune and whether it has a projection and why not; without one `per_comune` is null. `aggiornato_il` is the time of the last successful import, null if none is recorded, not of the last check for new files. Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
输入参数cod_istat