Consumption of elecricity in the rural areas including consumption for agricultural production

APIExecutable4/7Query nowOpen workbench Subscribe🇵🇱Poland

This dataset is part of the Local Data Bank (Bank Danych Lokalnych, BDL) API maintained by Statistics Poland (GUS), under the category Housing Economy and Municipal Infrastructure, subgroup Network Devices, subject code P2474. It provides yearly territorial time series on electricity consumption in rural areas, including consumption for agricultural production, covering Poland at multiple administrative levels from voivodeship down to gmina. Territorial units are identified using official TERYT identifiers, allowing integration with other geographic datasets. The API allows programmatic access to these statistics for analysis of rural energy use patterns and regional infrastructure planning across Poland's administrative divisions.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › NETWORK DEVICES. Local Data Bank (BDL) subject P2474: yearly territorial series for Poland (voivodship to gmina level), units keyed by TERYT ids.

Values of one variable across territorial units Documentation Open source record

Data schema (8 fields)

Click a field to see example values.

Field	Type	Description
variable_idVariable id	string	GUS variable id for subject P2474: 63713 consumers, 63714 electricity consumption (MWh).GUS variable id selecting the measured series of subject P2474 (the n1/n2 dimension combination): 63713=consumers [-]; 63714=consumption of electricity [MWh].
unit_levelUnit level	integer	Territorial aggregation level, from 0 (Poland) to 6 (gmina).Territorial aggregation level: 0=Poland, 1=macroregion, 2=voivodship (województwo), 3=region, 4=subregion, 5=powiat, 6=gmina.
year	integer	Reference year of the yearly value.Reference year of the value (yearly series, back to 1995 for the oldest subjects). Filters server-side via the API's year parameter.
unit_idUnit id	string	12-digit BDL territorial unit identifier.12-digit BDL territorial-unit id (macroregion+voivodship+region+subregion+powiat+gmina+type digits). An equality filter pins the unit server-side (unit-parent-id).
unit_nameUnit name	string	Name of the territorial unit.Name of the territorial unit.
teryt_tercTeryt terc	string	TERYT TERC code of the territorial unit, if applicable.TERYT TERC territorial code derived from the unit id (2 digits = voivodship, 4 = powiat, 7 = gmina incl. type digit; empty for NUTS-only units).
value	number	Measured value for the selected variable, unit and year.Measured value for the selected variable, unit and year.
attr_idAttr id	integer	GUS attribute id indicating data quality or annotation flag.GUS value-attribute id (data quality/annotation flag).

Schema captured from bdl 5 days ago.

Query the data

Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.

Where=

Sort by

Sample data (8 records)

variable_id	unit_level	year	unit_name	teryt_terc	value	attr_id
63713	—	2002	POLAND	—	4599920	1
63713	—	2003	POLAND	—	4625880	1
63713	—	2004	POLAND	—	4652870	1
63713	—	2005	POLAND	—	4667535	1
63713	—	2006	POLAND	—	4661879	1
63713	—	2007	POLAND	—	4698991	1
63713	—	2008	POLAND	—	4705862	1
63713	—	2009	POLAND	—	4823473	1

Live sample captured at profiling time — values may have changed upstream.

Verification Status

Using the API

Configuration

Base URL: https://bdl.stat.gov.pl/api/v1/subjects/P2474

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/63713?page-size=10&format=json&lang=en'

Yearly values of variable 63713 (consumers [-]) per territorial unit. Filters: unit-level=0–6, year=YYYY, unit-parent-id={12-digit unit id}; page-size ≤ 100. Anonymous limits: 5 req/s, 100 req/15 min.

Full API documentation ↗