BDL (Bank Danych Lokalnych GUS) — definicja i przykład

Czym jest BDL?

Bank Danych Lokalnych, w skrócie BDL, to największy w Polsce uporządkowany zbiór informacji statystycznych o wymiarze terytorialnym, prowadzony i udostępniany przez Główny Urząd Statystyczny pod adresem bdl.stat.gov.pl. BDL zawiera ponad 40 tysięcy zmiennych opisujących sytuację społeczno-gospodarczą Polski - od demografii i rynku pracy, przez edukację, zdrowie i kulturę, aż po finanse publiczne i ochronę środowiska. Dla badaczy wynagrodzeń BDL jest narzędziem absolutnie podstawowym, ponieważ pozwala porównywać płace między województwami, podregionami, a w niektórych przypadkach także powiatami.

BDL wystartował w obecnej formie w 2010 roku i od tego czasu jest stale rozwijany. Obecnie obejmuje szeregi czasowe sięgające w wielu przypadkach roku 1995, a niektóre dane demograficzne nawet roku 1950. To czyni BDL nie tylko źródłem danych bieżących, ale także wartościowym archiwum historycznym.

Struktura BDL: K -> G -> P -> V

BDL jest zorganizowany hierarchicznie według następującej struktury:

K - Kategorie (najwyższy poziom): np. Rynek pracy, Ludność, Wynagrodzenia i świadczenia społeczne, Gospodarka mieszkaniowa.
G - Grupy: w ramach kategorii Rynek pracy znajdziemy np. Pracujący, Bezrobocie rejestrowane, Wynagrodzenia.
P - Podgrupy: np. Przeciętne miesięczne wynagrodzenie brutto.
V - Zmienne (variables): konkretne wskaźniki, np. Przeciętne miesięczne wynagrodzenie brutto w sektorze przedsiębiorstw, w sektorze publicznym, według sekcji PKD.

Każda zmienna ma unikalny identyfikator liczbowy (zmienna ID), który jest stabilny w czasie i pozwala na automatyczne pobieranie danych przez API.

Dane terytorialne - od Polski po gminy

BDL jest zorganizowany w następujących poziomach terytorialnych:

Polska - poziom krajowy.
Województwo - 16 jednostek (NUTS-2).
Region - 7 regionów makro (NUTS-1, np. region południowy).
Podregion - 73 jednostki (NUTS-3).
Powiat - 380 jednostek (LAU-1), w tym 66 miast na prawach powiatu.
Gmina - 2477 jednostek (LAU-2).

Ważna uwaga: dane o wynagrodzeniach są dostępne w BDL głównie na poziomie województw i podregionów. Na poziomie powiatów są dostępne pewne wskaźniki (przeciętne wynagrodzenie w sektorze przedsiębiorstw dla powiatów, w których jest reprezentatywna próba), ale nie wszystkie. Na poziomie gmin danych płacowych praktycznie nie ma - tajemnica statystyczna i mała liczebność prób to uniemożliwiają.

API REST BDL - jak korzystać

API BDL jest publiczne i darmowe, dostępne pod adresem api.stat.gov.pl/Home/BdlApi. Główne endpointy to:

/api/v1/subjects - lista kategorii, grup i podgrup.
/api/v1/variables - lista zmiennych, można filtrować po subject-id.
/api/v1/variables/{id} - szczegóły konkretnej zmiennej.
/api/v1/data/by-variable/{id} - dane dla zmiennej, filtr po roku i jednostce terytorialnej.
/api/v1/data/by-unit/{id} - dane dla jednostki terytorialnej.
/api/v1/units - lista jednostek terytorialnych.

Format odpowiedzi to JSON. Bez klucza API obowiązują limity (10 zapytań na sekundę, 5000 na dzień). Po zarejestrowaniu klucza limity rosną do 100 zapytań na sekundę i 2 milionów na dzień. Klucz można uzyskać za darmo przez formularz na portalu API GUS.

Najważniejsze zmienne BDL dla wynagrodzeń

Z perspektywy badań płacowych warto znać następujące zmienne i ich obszary:

Przeciętne miesięczne wynagrodzenie brutto - ogółem oraz według sektorów.
Przeciętne miesięczne wynagrodzenie w sektorze przedsiębiorstw.
Przeciętne miesięczne wynagrodzenie w sektorze publicznym i prywatnym.
Wynagrodzenie według sekcji PKD (rolnictwo, przemysł, budownictwo, handel, transport, informacja i komunikacja, finanse, działalność profesjonalna, edukacja, opieka zdrowotna).
Relacja do przeciętnego wynagrodzenia w kraju (Polska = 100).
Stopa bezrobocia rejestrowanego (kontekst dla danych płacowych).
Liczba pracujących ogółem i w sektorze przedsiębiorstw.

Jak interpretować dane BDL

Dane w BDL są najczęściej podawane jako wartości roczne lub miesięczne (w zależności od zmiennej). Wartość 7155.48 w polu Przeciętne miesięczne wynagrodzenie brutto za 2023 rok dla Polski oznacza, że tyle wynosiła przeciętna pensja brutto w gospodarce narodowej. Ważne, żeby zwracać uwagę na dwie rzeczy: (1) zakres podmiotowy - czy mówimy o sektorze przedsiębiorstw, czy o gospodarce narodowej, (2) konstrukcję wskaźnika - czy to brutto, czy netto, czy zawiera trzynastki, premie i inne dodatki.

Limity API i komercyjne użycie

Dane BDL są dostępne na licencji pozwalającej na komercyjne użycie z podaniem źródła w formie: Źródło: Bank Danych Lokalnych GUS. Nie ma opłat za korzystanie. Limity API w wersji bez klucza wystarczają do pojedynczych zapytań dziennikarskich i prac akademickich. Aplikacje produkcyjne, zwłaszcza serwisy z dużym ruchem, powinny uzyskać klucz API i implementować cache po stronie aplikacji.

Różnica między BDL a BSW

BDL i BSW (Badanie Struktury Wynagrodzeń) to dwa różne produkty GUS, często mylone:

BDL - baza danych z wartościami średnimi i agregatami w przekroju terytorialnym, dostępna online przez przeglądarkę i API. Aktualizowana na bieżąco.
BSW - cykliczne badanie (co 2 lata) zawierające szczegółowy rozkład wynagrodzeń (mediana, percentyle) według zawodu, płci, wieku, wykształcenia. Wyniki publikowane w postaci raportów PDF i tablic Excel - nie są standardowo udostępniane przez API BDL.

FAQ - najczęściej zadawane pytania o BDL

Czy dostęp do BDL jest darmowy? Tak, całość danych i API są bezpłatne, także do użytku komercyjnego.

Jak często są aktualizowane dane? Zależnie od zmiennej - od raz w miesiącu (rynek pracy, sektor przedsiębiorstw) po raz w roku (dane gospodarcze).

Czy mogę pobrać wszystkie dane na raz? Nie ma jednego archiwum z całością BDL, ale przez API można systematycznie zbudować własną kopię.

Czy BDL ma dane o wynagrodzeniach na poziomie powiatu? Tylko w ograniczonym zakresie - przeciętne wynagrodzenie w sektorze przedsiębiorstw dla powiatów, które spełniają kryteria reprezentatywności.

Praktyczne scenariusze użycia BDL

BDL nie jest tylko narzędziem akademickim - znajduje zastosowanie w wielu praktycznych kontekstach. Samorządy wykorzystują BDL do oceny pozycji swoich gmin na tle innych: porównują stopę bezrobocia, dochody własne na mieszkańca, liczbę pracujących w sekcji przemysłu czy usługach. Inwestorzy zagraniczni szukając lokalizacji pod fabrykę czy centrum logistyczne sprawdzają w BDL dostępność siły roboczej, poziom płac w regionie i strukturę wiekową ludności. Dziennikarze danych używają BDL do tworzenia map i infografik o zarobkach w różnych częściach kraju, często wskazując na lukę między Mazowszem a Polską Wschodnią.

Drugim ważkim zastosowaniem jest badanie efektywności polityk publicznych. Programy rządowe kierowane do regionów słabszych ekonomicznie (np. Polska Wschodnia, Ściana Zachodnia) są monitorowane właśnie przez wskaźniki BDL: czy poziom płac się zbliżył do średniej krajowej, czy zatrudnienie rośnie szybciej, czy pojawiła się większa dynamika inwestycji prywatnych. Bez BDL takie monitorowanie byłoby praktycznie niemożliwe.

Format i ścieżki dostępu

Z BDL można korzystać na kilka sposobów:

Przeglądarka WWW - bdl.stat.gov.pl, intuicyjny interfejs z drzewem kategorii. Można wybrać zmienną, lata, jednostki terytorialne i pobrać dane jako Excel lub CSV.
API REST - dla aplikacji, automatyzacji i regularnego pobierania dużych ilości danych.
Pliki zbiorcze - GUS publikuje okresowo paczki danych obejmujące całość zmiennych dla wybranej kategorii w plikach CSV/XLSX.
Strona stat.gov.pl - wybrane wykresy interaktywne i dashboardy zbudowane na danych BDL, np. interaktywna mapa wynagrodzeń.

Format danych zwracanych przez API to JSON, ale GUS udostępnia również specyfikację OpenAPI 3.0, która pozwala generować klientów w różnych językach programowania (Python, JavaScript, R, Java).

Najczęstsze błędy użytkowników BDL

Pracując z BDL warto wystrzegać się typowych pułapek interpretacyjnych. Po pierwsze, wskaźnik Przeciętne wynagrodzenie w sektorze przedsiębiorstw nie jest tym samym, co wynagrodzenie w gospodarce narodowej - sektor przedsiębiorstw obejmuje firmy 10+ pracowników, gospodarstwo narodowe to wszystko, łącznie z administracją publiczną, edukacją, ochroną zdrowia. Liczby mogą się różnić o kilkaset złotych. Po drugie, dane miesięczne mogą być bardzo zmienne ze względu na premie, trzynastki, nagrody kwartalne - średniorocznie te efekty się wygładzają, ale w pojedynczym miesiącu pensje mogą skakać o 20-30%.

Po trzecie, agregaty regionalne potrafią być zwodnicze. Na przykład Mazowsze ma najwyższe przeciętne wynagrodzenie w Polsce, ale to głównie Warszawa - reszta Mazowsza ma płace blisko średniej krajowej. Dlatego do badań wewnątrzregionalnych warto schodzić na poziom podregionów (NUTS-3) lub powiatów.

BDL a otwarte dane publiczne

BDL jest wpisany w szeroką strategię otwartych danych publicznych państwa polskiego. Dane są dostępne na licencji zbliżonej do Creative Commons - wystarczy podanie źródła. BDL jest też podłączony do unijnego portalu danych publicznych data.europa.eu i portalu krajowego dane.gov.pl. Dzięki temu polscy badacze i deweloperzy mają te same narzędzia, co ich odpowiednicy z innych krajów członkowskich UE.

Przykłady kodów API w Pythonie

Dla deweloperów wkraczających w pracę z BDL, oto przykłady typowych zapytań w Pythonie z biblioteką requests:

Pobranie listy województw - GET /api/v1/units/units?level=2&format=json
Pobranie zmiennej Przeciętne miesięczne wynagrodzenie brutto za 2023 dla województwa mazowieckiego - GET /api/v1/data/by-variable/{varId}?unit-parent-id=011000000000&year=2023
Wyszukanie zmiennych zawierających w nazwie słowo wynagrodzenie - GET /api/v1/variables/search?name=wynagrodzenie

Wynik jest zwracany w formie JSON z polami values, year, unit-id, unit-name oraz metadanymi (miara, dokładność, data publikacji). Większe zapytania można paginować przez parametry page-size i page (max 100 rekordów na stronę bez klucza, 1000 z kluczem). Dla aplikacji produkcyjnych zaleca się cache po stronie aplikacji - dane BDL rzadko się zmieniają w trakcie miesiąca, więc można trzymać kopię przez 24-48 godzin.

BDL a inne portale GUS

Często BDL jest mylony z innymi serwisami GUS. Dla jasności:

BDL - dane terytorialne, wszystkie zmienne dla wszystkich poziomów (Polska, województwo, powiat, gmina). Główne narzędzie analityczne.
STRATEG - system monitorowania strategii rozwoju, dane wskaźników celów strategicznych. Mniej szczegółowy niż BDL, ale lepiej zorganizowany pod kątem konkretnych celów polityki publicznej.
Demografia - dedykowana baza demograficzna z bardzo szczegółowymi danymi o populacji, urodzeniach, zgonach, migracjach.
Eurostat przez GUS - polska wersja danych Eurostatu, takich jak SES (Structure of Earnings Survey), LFS (Labour Force Survey), HBS (Household Budget Survey).
Portal Informacyjny - jednolity punkt wyszukiwania we wszystkich publikacjach GUS, działa jak google na dane statystyczne.

Krytyka i ograniczenia BDL

BDL, mimo bogactwa danych, ma swoje ograniczenia. Po pierwsze, granularność danych płacowych jest niewystarczająca - na poziomie powiatu możemy zobaczyć tylko ogólne wynagrodzenie, bez podziału na sekcje czy zawody. Po drugie, często brakuje porównań z kosztami życia w danym regionie - 7000 PLN brutto w Warszawie a 7000 PLN w Lublinie to kompletnie inna siła nabywcza, ale BDL tego nie pokazuje. Po trzecie, interfejs użytkownika jest pomocny, ale dla osób niezaznajomionych z metodologią statystyczną może być zbyt techniczny - nie każdy wie, czym jest sekcja PKD czy NUTS-3. Wreszcie, API działa dobrze, ale dokumentacja czasem jest nieaktualna lub niepełna - w niektórych przypadkach trzeba eksperymentować, by znaleźć właściwy parametr.

Plany rozwoju BDL

GUS zapowiada w nadchodzących latach kilka usprawnień BDL: pełna integracja z BDL3 (nowa wersja architektury), dodanie nowych baz tematycznych (np. innowacyjność, transformacja cyfrowa), wzbogacenie wizualizacji o interaktywne mapy choropletyczne, rozbudowa API o webhooki dla notyfikacji o nowych danych, oraz możliwość otwartych pulpitów analitycznych (dashboardy budowane przez użytkowników). Te zmiany mają sprawić, że BDL będzie nie tylko źródłem danych, ale także platformą analityczną porównywalną z najlepszymi rozwiązaniami w UE (Statistics Norway, Statistics Sweden).