Retail prices of selected consumer goods and services (monthly data)
This API provides access to average retail prices of selected consumer goods and services in Poland, part of subject group P2917 in the Local Data Bank (Bank Danych Lokalnych, BDL) maintained by Statistics Poland (GUS). It offers territorial time series covering administrative units from the voivodship down to the gmina level, each identified using official TERYT area codes. The data is published as part of the national statistical office's broader BDL API, which allows structured queries for retrieving price indicators alongside other territorial statistics. It is intended for researchers, public administration, and analysts studying regional price differences and living costs across Poland over time.PRICES › AVERAGE RETAIL PRICES OF GOODS AND CONSUMER SERVICES. Local Data Bank (BDL) subject P2917: yearly territorial series for Poland (voivodship to gmina level), units keyed by TERYT ids.
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (8 fields)
Click a field to see example values.
| Field | Type | Description |
|---|---|---|
| variable_idVariable id | string | GUS variable id identifying the specific good/month/measure combination.GUS variable id selecting the measured series of subject P2917 (the n1/n2 dimension combination): 387718=January / rice - per kg [PLN]; 388923=January / rice - per kg [-]; 389147=January / rice - per kg [-]; 387706=January / wheat roll - per 50g [PLN]; 388911=January / wheat roll - per 50g [-]; 389135=January / wheat roll - per 50g [-]; 387032=January / wheat-rye bread - per 0.5kg [PLN]; 388836=January / wheat-rye bread - per 0.5kg [-]; 389123=January / wheat-rye bread - per 0.5kg [-]; 387019=January / wheat flour - per kg [PLN]; 388824=January / wheat flour - per kg [-]; 389054=January / wheat flour - per kg [-]; 387007=January / pearl-barley groats - per 0.5kg [PLN]; 388812=January / pearl-barley groats - per 0.5kg [-]; 389042=January / pearl-barley groats - per 0.5kg [-]; … (3204 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P2917 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level, from country (0) down to gmina (6).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 recorded 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 code identifying the territorial unit.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, e.g. country, voivodship or gmina.Name of the territorial unit, e.g. country, voivodship or gmina. |
| teryt_tercTeryt terc | string | TERYT TERC administrative code for the territorial unit.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 | Recorded retail price or index value for the variable.Recorded retail price or index value for the variable. |
| attr_idAttr id | integer | GUS attribute code flagging data quality or annotation.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 7 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.
Sample data (8 records)
| variable_id | unit_level | year | unit_id | unit_name | teryt_terc | value | attr_id |
|---|---|---|---|---|---|---|---|
| 387718 | — | 2006 | 000000000000 | POLAND | — | 2.59 | 1 |
| 387718 | — | 2007 | 000000000000 | POLAND | — | 2.73 | 1 |
| 387718 | — | 2008 | 000000000000 | POLAND | — | 3.26 | 1 |
| 387718 | — | 2009 | 000000000000 | POLAND | — | 4.58 | 1 |
| 387718 | — | 2010 | 000000000000 | POLAND | — | 4.41 | 1 |
| 387718 | — | 2011 | 000000000000 | POLAND | — | 4.01 | 1 |
| 387718 | — | 2012 | 000000000000 | POLAND | — | 4.19 | 1 |
| 387718 | — | 2013 | 000000000000 | POLAND | — | 4.27 | 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/P2917
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/387718?page-size=10&format=json&lang=en'Yearly values of variable 387718 (January / rice - per kg [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.
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.