Alcoholic beverages, tobacco

APIJoinable5/7Query nowOpen workbench Subscribe🇵🇱Poland

Part of Poland's Local Data Bank (BDL), maintained by the Polish Central Statistical Office (GUS), providing statistical API access to subject P1467: average retail prices of goods and consumer services, specifically for alcoholic beverages and tobacco. Data are organized as yearly territorial time series covering Poland's administrative units from voivodship down to gmina level, identified by TERYT territorial unit codes. The API allows free, unauthenticated access to these price statistics, supporting analysis of regional price trends over time.PRICES › AVERAGE RETAIL PRICES OF GOODS AND CONSUMER SERVICES. Local Data Bank (BDL) subject P1467: 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 selecting the measured series of subject P1467 (the n1/n2 dimension combination): 5000=Pure vodka Polonaise - Polish Vodka 50% 0.5l [PLN]; 8265=pure vodka 40% - per 0.5l [PLN]; 5001=flavoured vodka 40% - per 0.5l [PLN]; 519963=flavoured vodka 37,5% - per 0.5l [PLN]; 5002=white grape wine, dry - per 0.75l [PLN]; 5003=beer, light full - per 0.5l [PLN]; 5004=cigarettes Mars - per 20pcs [PLN]; 453798=cigarettes - per 20 pcs [PLN]; 1727958=cigarettes (1) - per 20 pcs [PLN]; 1638916=flavoured vodka 37,5% - per 0.7l [PLN]; 1638917=white grape wine for - per 0,75l [PLN]; 1749188=flavoured vodka, min. 37,5% - per 0.7l [PLN].
unit_levelUnit level	integer	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 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 id (macroregion+voivodship+region+subregion+powiat+gmina+type digits). An equality filter pins the unit server-side (unit-parent-id).
unit_nameUnit name	string	—
teryt_tercTeryt terc	string	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	—
attr_idAttr id	integer	GUS value-attribute id (data quality/annotation flag).

Schema captured from bdl 6 hours 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_id	unit_name	teryt_terc	value	attr_id
5000	—	1999	000000000000	POLAND	—	23.34	1
5000	—	2000	000000000000	POLAND	—	24.62	1
5000	—	1999	010000000000	MACROREGION POŁUDNIOWY	—	0	4
5000	—	2000	010000000000	MACROREGION POŁUDNIOWY	—	0	4
5000	—	1999	011200000000	MAŁOPOLSKIE	12	22.95	1
5000	—	2000	011200000000	MAŁOPOLSKIE	12	24.13	1
5000	—	1999	011210000000	REGION MAŁOPOLSKIE	—	22.95	1
5000	—	2000	011210000000	REGION MAŁOPOLSKIE	—	24.13	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/P1467

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 5000 (Pure vodka Polonaise - Polish Vodka 50% 0.5l [PLN]) 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 ↗

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.