get_demographics
Demographic, economic, housing and other local statistics for a Polish location, from GUS BDL (Bank Danych Lokalnych) — Poland's public Central Statistical Office open-data bank. ~50 indicators across 11 categories (population, economy, housing, spatial planning, infrastructure, environment, safety, education, prices) plus a few derived metrics. Address by location (city, county or gmina name) OR teryt. A city or county name resolves to county/powiat (4-digit) level, a gmina name to that gmina; a name shared by several units returns the candidates with their codes (pass one as teryt). teryt wins when both are given. Use list_locations to find TERYT codes — neighborhoods/osiedla are NOT addressable here. A query returns the requested level PLUS all parent levels (a gmina query also yields powiat, NUTS3 region and voivodeship indicators). Optional year, or yearFrom+yearTo for a time series, and category to filter. Cost: 1 token.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Single year (2003-present). Mutually exclusive with yearFrom/yearTo. Omit for the latest available year per indicator. | |
| teryt | No | TERYT code: 2-digit (voivodeship, e.g. 14), 4-digit (county, e.g. 1465), 6 or 7-digit (gmina, e.g. 1465011). The 7th digit selects the unit type: 3 = urban-rural gmina overall, 4/5 = urban/rural part only, 8 = Warszawa district (1465011 = all of Warszawa, 1465108 = Śródmieście). Wins over location. Use list_locations to find codes. | |
| yearTo | No | End year for a time series (max current year + 1). | |
| category | No | Filter to these categories. Omit to return all available. | |
| location | No | City, county, gmina, or district name (e.g. 'Warszawa', 'Kraków', 'Wieliczka'). A city/county name resolves to county/powiat level; a gmina name resolves to that gmina; a Warszawa district name (e.g. 'Mokotów') resolves to that district, another city's delegatura (e.g. 'Kraków-Podgórze') to its parent county. A name shared by several units returns the candidates with their codes; pass one as teryt. Use this OR teryt. | |
| yearFrom | No | Start year for a time series (min 2003). |