Find a comune by name, or find comuni by criteria

Two questions on one path. With only q (and limit), a case- and accent-insensitive name search across all ~7,900 Italian comuni returns identifiers (ISTAT code, province, region, page URL) — call getComune with the code for the numbers; several comuni share a name, so check the province. With any other parameter it finds comuni by criteria: region, province, population, purchase price, rent, population change 2019–2025 and the verified comuni of a tax regime, paged (max 100) and sorted. A comune with no price, rent or population-change figure is left out of the filter on it and counted in missingData — never treated as cheap, free or stable. taxRegime lists only comuni on the regime's verified routes: a comune missing from it is not a "no".

get/comuni

Request

  • Base URL: https://www.expatliving.it/api/v1
  • URL: https://www.expatliving.it/api/v1/comuni
  • Auth: none declared

Query parameters

qstring

A comune name or part of one, e.g. "Introdacqua". Alone: name search (2–80 characters, up to 25 results). With other filters: only comuni whose name contains it.

limitinteger

Name search: 1–25, default 10. Filters: 1–100, default 25.

regionstring

A region name or slug, e.g. "Abruzzo".

provincestring

A province's two-letter code ("AQ") or slug.

minPopulationinteger

Residents, inclusive.

maxPopulationinteger

Residents, inclusive.

minPurchasePriceEurM2number

Purchase price in EUR/m2, inclusive. A comune with no price is left out, never treated as cheap.

maxPurchasePriceEurM2number

Purchase price in EUR/m2, inclusive. A comune with no price is left out, never treated as cheap.

minRentEurM2Monthnumber

Rent in EUR/m2 per month, inclusive. A comune with no rent figure is left out.

maxRentEurM2Monthnumber

Rent in EUR/m2 per month, inclusive. A comune with no rent figure is left out.

minPopulationChangePctnumber

Population change 2019 to 2025, in percent, inclusive. Negative means decline.

maxPopulationChangePctnumber

Population change 2019 to 2025, in percent, inclusive.

taxRegimestring

A verified geographic regime slug from /tax/regimes. Lists only comuni on its verified routes; one missing from the list is not a "no".

sort'population' | 'name' | 'purchasePrice' | 'rent' | 'populationChange'

Sort key; a comune without a figure for it sorts last.

order'asc' | 'desc'

Default desc for population and populationChange, asc otherwise.

offsetinteger

Rows to skip, for the next page.

Response

Name search: matching comuni, best match first. Filters: the matching page, with counts of what was left out for missing data.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.