API - dane o składach opału, cenach i przepisach

API JSON: 6372 składy opału przypisanych do 1961 gmin, mediany cen ze składów, średnie ceny GUS i stan prawny uchwał antysmogowych 16 województw. Bez klucza działa wersja demonstracyjna z limitami, pełny dostęp daje klucz API. Stan na 19 listopada 2026.

Endpointy

ZapytanieCo zwraca
GET /locations Wyszukiwanie lokalizacji
GET /locate Gmina dla punktu
GET /stores Składy opału
GET /stores/{id} Jeden skład
GET /prices Ceny GUS
GET /prices/{fuel} Bieżące ceny paliwa
GET /regulations Przepisy antysmogowe
GET /subsidy Kalkulator dopłaty Czyste Powietrze

Wyszukiwanie lokalizacji

GET https://skladyopalow.pl/wp-json/so/v1/locations

Zamienia nazwę miejscowości, gminy albo kod pocztowy na stronę gminy w katalogu. Zwraca do 8 podpowiedzi.

Parametry
NazwaTypOpis
q (wymagany) string Nazwa miejscowości, gminy albo kod pocztowy (także fragment, bez polskich znaków też działa).
stores boolean Dołącz składy pasujące nazwą (najwyżej 4, typ "store").

Gdzie w katalogu jest Mińsk Mazowiecki?

GET /locations?q=Mińsk Mazowiecki
[
    {
        "type": "municipality",
        "label": "Mińsk Mazowiecki (gmina wiejska)",
        "name": "Mińsk Mazowiecki",
        "description": "pow. miński, mazowieckie",
        "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/gmina-minsk-mazowiecki/"
    },
    {
        "type": "municipality",
        "label": "Mińsk Mazowiecki",
        "name": "Mińsk Mazowiecki",
        "description": "pow. miński, mazowieckie",
        "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/minsk-mazowiecki/"
    }
]

Do której gminy należy kod 05-300?

GET /locations?q=05-300
[
    {
        "type": "postcode",
        "label": "05-300 Mińsk Mazowiecki, Karolina, Stojadła, T…",
        "description": "pow. miński, mazowieckie",
        "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/gmina-minsk-mazowiecki/?kod=05-300"
    }
]

Gmina dla punktu

GET https://skladyopalow.pl/wp-json/so/v1/locate

Zwraca gminę, w której leży punkt (granice z Państwowego Rejestru Granic, dokładność około 100 m), i adres jej strony.

Parametry
NazwaTypOpis
lat (wymagany) number Szerokość geograficzna (WGS84), w Polsce 48,8-55,1.
lon (wymagany) number Długość geograficzna (WGS84), w Polsce 13,9-24,3.

W jakiej gminie jest punkt 52,18 N 21,56 E?

GET /locate?lat=52.18&lon=21.56
{
    "municipality": "Mińsk Mazowiecki",
    "teryt": "1412011",
    "description": "pow. miński, mazowieckie",
    "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/minsk-mazowiecki/?punkt=52.18,21.56"
}

Składy opału

GET https://skladyopalow.pl/wp-json/so/v1/stores

Bez klucza (demo): składy w gminie (teryt, 7 cyfr), najwyżej 5 wyników - nazwa, gmina, paliwa, status danych i adres strony składu, bez identyfikatora. Z kluczem API: także najbliższe od kodu pocztowego albo punktu (lat, lon) z odległością, najwyżej 20 wyników, z polem id do pełnego wpisu. Cytując, podawaj status danych.

Parametry
NazwaTypOpis
lat number, 48,8-55,1 Szerokość geograficzna punktu (WGS84). Razem z lon - składy posortowane od najbliższego.
lon number, 13,9-24,3 Długość geograficzna punktu (WGS84).
postcode string Kod pocztowy - punktem odniesienia jest środek zabudowy obszaru kodu. Zamiast lat i lon.
teryt string TERYT gminy (7 cyfr, np. 1412011) - składy przypisane do gminy (bez odległości). Ma pierwszeństwo przed punktem.
radius integer, 1-50, domyślnie 25 Promień wyszukiwania od punktu w km (linia prosta).
fuel string Tylko składy z tym paliwem w ofercie. "wegiel" obejmuje też sortymenty (kostka, orzech, groszek, ekogroszek, miał).
Wartości: wegiel, ekogroszek, wegiel-kostka, wegiel-orzech, wegiel-groszek, mial-weglowy, pellet, brykiet, drewno-kominkowe
limit integer, 1-20, domyślnie 10 Maksymalna liczba wyników.

Składy w mieście Mińsk Mazowiecki (TERYT 1412011) - bez klucza

GET /stores?teryt=1412011
[
    {
        "name": "\"Hydro Centrum D. K. Koperscy, M. Mastalerz sp.j.\"",
        "url": "https://skladyopalow.pl/sklad/hydro-centrum-d-k-koperscy-m-mastalerz-sp-j-minsk-mazowiecki/",
        "municipality": {
            "name": "Mińsk Mazowiecki",
            "teryt": "1412011",
            "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/minsk-mazowiecki/"
        },
        "fuels": [
            "Węgiel"
        ],
        "featured": false,
        "registry_status": null,
        "source": {
            "data_status": "unverified",
            "description": "Dane z otwartych źródeł",
            "origin": "Składy Opałów"
        }
    },
    {
        "name": "PHU Topaz sp. z o.o. sklep nr 52",
        "url": "https://skladyopalow.pl/sklad/phu-topaz-sp-z-o-o-sklep-nr-52-minsk-mazowiecki/",
        "municipality": {
            "name": "Mińsk Mazowiecki",
            "teryt": "1412011",
            "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/minsk-mazowiecki/"
        },
        "fuels": [
            "Węgiel",
            "Węgiel groszek"
        ],
        "featured": false,
        "registry_status": null,
        "source": {
            "data_status": "unverified",
            "description": "Dane z otwartych źródeł",
            "origin": "Składy Opałów"
        }
    }
]

Najbliższe składy z ekogroszkiem od kodu 05-300 - z kluczem API

GET /stores?postcode=05-300&fuel=ekogroszek&limit=5
[
    {
        "id": "3a747e53-e447-47f0-a70e-67015c260066",
        "name": "Selmat",
        "url": "https://skladyopalow.pl/sklad/selmat-minsk-mazowiecki/",
        "distance_km": 1.4,
        "municipality": {
            "name": "Mińsk Mazowiecki",
            "teryt": "1412011",
            "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/minsk-mazowiecki/"
        },
        "fuels": [
            "Drewno kominkowe",
            "Ekogroszek",
            "Miał węglowy"
        ],
        "featured": false,
        "registry_status": {
            "state": "suspended",
            "label": "Działalność zawieszona",
            "as_of": "2026-10-03"
        },
        "source": {
            "data_status": "unverified",
            "description": "Dane z otwartych źródeł",
            "origin": "Składy Opałów"
        }
    },
    {
        "id": "7484797b-b4a9-414b-a68f-b1f4cf62f124",
        "name": "AVANT Michał Kamiński",
        "url": "https://skladyopalow.pl/sklad/sklad-opalu-stojadla-stojadla/",
        "distance_km": 2.1,
        "municipality": {
            "name": "Mińsk Mazowiecki",
            "teryt": "1412112",
            "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/gmina-minsk-mazowiecki/"
        },
        "fuels": [
            "Brykiet",
            "Ekogroszek",
            "Miał węglowy"
        ],
        "featured": false,
        "registry_status": null,
        "source": {
            "data_status": "unverified",
            "description": "Dane z otwartych źródeł",
            "origin": "Składy Opałów"
        }
    }
]

Składy z pelletem w promieniu 15 km od punktu - z kluczem API

GET /stores?lat=52.23&lon=21.01&radius=15&fuel=pellet
[
    {
        "id": "674037a1-bf97-4b36-8817-b266f10f63b9",
        "name": "Bricoman Warszawa Połczyńska",
        "url": "https://skladyopalow.pl/sklad/bricoman-warszawa-polczynska-warszawa/",
        "distance_km": 8.6,
        "municipality": {
            "name": "Warszawa",
            "teryt": "1465011",
            "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/warszawa/"
        },
        "fuels": [
            "Brykiet",
            "Pellet"
        ],
        "featured": false,
        "registry_status": null,
        "source": {
            "data_status": "unverified",
            "description": "Dane z otwartych źródeł",
            "origin": "Składy Opałów"
        }
    },
    {
        "id": "40084d23-dcf1-4410-a4f9-bdc0e76f8292",
        "name": "Tiplox",
        "url": "https://skladyopalow.pl/sklad/tiplox-sp-z-o-o-zabki/",
        "distance_km": 9.7,
        "municipality": {
            "name": "Ząbki",
            "teryt": "1434031",
            "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/wolominski/zabki/"
        },
        "fuels": [
            "Brykiet",
            "Drewno kominkowe",
            "Pellet"
        ],
        "featured": false,
        "registry_status": null,
        "source": {
            "data_status": "unverified",
            "description": "Dane z otwartych źródeł",
            "origin": "Składy Opałów"
        }
    }
]

Jeden skład

GET https://skladyopalow.pl/wp-json/so/v1/stores/{id}

Tylko z kluczem API. Pełny wpis jednego składu (id z listy składów pobranej z kluczem): adres, kontakt, godziny i cennik - najnowsza cena każdego paliwa z ostatnich 12 miesięcy, z datą. Bez klucza te same dane są na stronie składu (pole url).

Parametry
NazwaTypOpis
id (wymagany) string Identyfikator składu (pole id z listy składów, UUID).

Dane i cennik składu - z kluczem API

GET /stores/3a747e53-e447-47f0-a70e-67015c260066
{
    "id": "3a747e53-e447-47f0-a70e-67015c260066",
    "name": "Selmat",
    "url": "https://skladyopalow.pl/sklad/selmat-minsk-mazowiecki/",
    "distance_km": null,
    "municipality": {
        "name": "Mińsk Mazowiecki",
        "teryt": "1412011",
        "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/minsk-mazowiecki/"
    },
    "fuels": [
        "Drewno kominkowe",
        "Ekogroszek",
        "Miał węglowy"
    ],
    "featured": false,
    "registry_status": {
        "state": "suspended",
        "label": "Działalność zawieszona",
        "as_of": "2026-10-03"
    },
    "source": {
        "data_status": "unverified",
        "description": "Dane z otwartych źródeł",
        "origin": "Składy Opałów",
        "verified_at": null,
        "updated_at": "2026-10-01"
    },
    "address": "Wyszyńskiego 56, 05-300 Mińsk Mazowiecki",
    "nip": "8221259640",
    "phone": "25 758 27 39",
    "website": "https://www.facebook.com/selmatbud",
    "lat": 52.182763,
    "lon": 21.547012,
    "location_approximate": false,
    "hours": null,
    "price_list": []
}

Ceny GUS

GET https://skladyopalow.pl/wp-json/so/v1/prices

Oficjalne średnie roczne ceny detaliczne GUS (Bank Danych Lokalnych): węgiel kamienny za tonę, prąd G11 i gaz W-1.1 za kWh - Polska i województwa, od 1999 roku.

Ile kosztowała tona węgla według GUS?

GET /prices
{
    "wegiel-kamienny": {
        "name": "Węgiel kamienny",
        "unit": "zł/t",
        "period": "średnia roczna",
        "poland": {
            "2023": 2137.88,
            "2024": 1703.46,
            "2025": 1601.7
        },
        "voivodeships": {
            "dolnośląskie": {
                "2023": 2332.89,
                "2024": 1866.43,
                "2025": 1781.98
            },
            "kujawsko-pomorskie": {
                "2023": 2023.41,
                "2024": 1602.16,
                "2025": 1530.04
            }
        },
        "source": {
            "name": "GUS, Bank Danych Lokalnych, zmienna 5029",
            "url": "https://bdl.stat.gov.pl/bdl/metadane/cechy/5029"
        }
    },
    "prad-g11": {
        "name": "Energia elektryczna (G11)",
        "unit": "zł/kWh",
        "period": "średnia roczna",
        "poland": {
            "2023": 0.91,
            "2024": 1.01,
            "2025": 1.15
        },
        "voivodeships": {
            "dolnośląskie": {
                "2023": 0.88,
                "2024": 0.97,
                "2025": 1.09
            },
            "kujawsko-pomorskie": {
                "2023": 0.92,
                "2024": 1.01,
                "2025": 1.14
            }
        },
        "source": {
            "name": "GUS, Bank Danych Lokalnych, zmienna 5071",
            "url": "https://bdl.stat.gov.pl/bdl/metadane/cechy/5071"
        }
    },
    "gaz-w11": {
        "name": "Gaz ziemny (W-1.1)",
        "unit": "zł/kWh",
        "period": "średnia roczna",
        "poland": {
            "2023": 0.4,
            "2024": 0.46,
            "2025": 0.52
        },
        "voivodeships": {
            "dolnośląskie": {
                "2023": 0.4,
                "2024": 0.47,
                "2025": 0.53
            },
            "kujawsko-pomorskie": {
                "2023": 0.4,
                "2024": 0.46,
                "2025": 0.52
            }
        },
        "source": {
            "name": "GUS, Bank Danych Lokalnych, zmienna 478247",
            "url": "https://bdl.stat.gov.pl/bdl/metadane/cechy/478247"
        }
    }
}

Bieżące ceny paliwa

GET https://skladyopalow.pl/wp-json/so/v1/prices/{fuel}

Mediana zatwierdzonych cen ze składów z ostatnich 6 miesięcy (cenniki składów i zgłoszenia czytelników) - te same liczby co strona ceny paliwa. Dla paliw węglowych dodatkowo punkt odniesienia GUS, nigdy wliczony do mediany.

Parametry
NazwaTypOpis
fuel (wymagany) string Paliwo (slug).
Wartości: wegiel, ekogroszek, wegiel-kostka, wegiel-orzech, wegiel-groszek, mial-weglowy, pellet, brykiet, drewno-kominkowe
voivodeship string Województwo: slug (np. mazowieckie) albo 2-cyfrowy TERYT (np. 14). Bez parametru - cała Polska z podziałem na województwa i miesiące.
values boolean Dołącz pole values: posortowane ceny (zł), z których liczona jest mediana kraju - bez nazw składów.

Ceny pelletu w województwie mazowieckim

GET /prices/pellet?voivodeship=mazowieckie
{
    "fuel": "pellet",
    "name": "Pellet",
    "area": {
        "level": "voivodeship",
        "name": "mazowieckie",
        "teryt": "14"
    },
    "unit": "t",
    "unit_name": "tona",
    "window_months": 6,
    "from": null,
    "to": null,
    "n": 29,
    "median": 2250,
    "quartile_1": null,
    "quartile_3": null,
    "min": null,
    "max": null,
    "price_lists": null,
    "submissions": null,
    "source": null,
    "method": "Mediana zatwierdzonych cen z ostatnich 6 miesięcy (cenniki składów i zgłoszenia czytelników po moderacji); jeden skład = jedna, najnowsza cena; ceny spoza wiarygodnych widełek i wartości odstające odrzucone; mediana od 3 cen. Średnie GUS to osobne dane i nie wchodzą do mediany.",
    "page": "https://skladyopalow.pl/ceny-opalu/pellet/"
}

Cena ekogroszku w Polsce i w województwach

GET /prices/ekogroszek
{
    "fuel": "ekogroszek",
    "name": "Ekogroszek",
    "area": {
        "level": "poland",
        "name": "Polska",
        "teryt": ""
    },
    "unit": "t",
    "unit_name": "tona",
    "window_months": 6,
    "from": "2026-05-20",
    "to": "2026-11-02",
    "n": 433,
    "median": 2000,
    "quartile_1": 1790,
    "quartile_3": 2200,
    "min": 1200,
    "max": 2800,
    "price_lists": 433,
    "submissions": 0,
    "source": "cenniki składów",
    "rejected": 1,
    "bag_kg": 25,
    "bag_price": 50,
    "monthly_change": {
        "percent": 0,
        "from": "2026-10",
        "to": "2026-11",
        "pairs": 80,
        "month_to_date": true
    },
    "voivodeships": [
        {
            "voivodeship": "małopolskie",
            "teryt": "12",
            "median": 1745,
            "n": 26
        },
        {
            "voivodeship": "śląskie",
            "teryt": "24",
            "median": 1754.5,
            "n": 54
        },
        {
            "voivodeship": "podkarpackie",
            "teryt": "18",
            "median": 1790,
            "n": 7
        }
    ],
    "months": [
        {
            "month": "2026-05",
            "median": 1530,
            "n": 11
        },
        {
            "month": "2026-06",
            "median": 1590,
            "n": 16
        },
        {
            "month": "2026-07",
            "median": 1620,
            "n": 15
        }
    ],
    "gus": {
        "description": "Średnia roczna cena detaliczna węgla kamiennego ogółem (bez podziału na sortymenty), zł/t",
        "year": 2025,
        "price": 1601.7,
        "area": "Polska",
        "source": {
            "name": "GUS, Bank Danych Lokalnych, zmienna 5029",
            "url": "https://bdl.stat.gov.pl/bdl/metadane/cechy/5029"
        }
    },
    "method": "Mediana zatwierdzonych cen z ostatnich 6 miesięcy (cenniki składów i zgłoszenia czytelników po moderacji); jeden skład = jedna, najnowsza cena; ceny spoza wiarygodnych widełek i wartości odstające odrzucone; mediana od 3 cen. Średnie GUS to osobne dane i nie wchodzą do mediany.",
    "page": "https://skladyopalow.pl/ceny-opalu/ekogroszek/"
}

Przepisy antysmogowe

GET https://skladyopalow.pl/wp-json/so/v1/regulations

Stan prawny uchwał antysmogowych województw: akt, publikacja, tekst urzędowy, terminy jako dane i najbliższy termin. Z parametrem teryt albo kod - tylko województwo tej jednostki.

Parametry
NazwaTypOpis
teryt string TERYT dowolnej jednostki (gmina, powiat, województwo) - zwraca stan prawny jej województwa.
postcode string Kod pocztowy - zwraca stan prawny województwa, w którym leży.
voivodeship string Województwo: slug (np. malopolskie) albo 2-cyfrowy TERYT.

Jakie przepisy antysmogowe obowiązują w gminie Mińsk Mazowiecki?

GET /regulations?teryt=1412011
[
    {
        "voivodeship": "mazowieckie",
        "teryt": "14",
        "has_resolution": true,
        "resolution": {
            "title": "Uchwała nr 162/17 Sejmiku Województwa Mazowieckiego z dnia 24 października 2017 r. w sprawie wprowadzenia na obszarze województwa mazowieckiego ograniczeń i zakazów w zakresie eksploatacji instalacji, w których następuje spalanie paliw",
            "publication": "Dz. Urz. Woj. Mazowieckiego z 2017 r. poz. 9600 (ogłoszono 27 października 2017 r.); zmiana: Dz. Urz. Woj. Mazowieckiego z 2022 r. poz. 5147",
            "text": "https://edziennik.mazowieckie.pl/WDU_W/2017/9600/akt.pdf",
            "as_of": "2026-10-02",
            "summary": "W województwie mazowieckim obowiązuje uchwała antysmogowa nr 162/17, zmieniona raz uchwałą nr 59/22 z 2022 r. Kotły pozaklasowe są zakazane od 1 stycznia 2023 r., a kotły klasy 3 i 4 można eksploatować do 31 grudnia 2027 r. Od 1 października 2023 r. w Warszawie nie wolno stosować węgla kamiennego, a w gminach dziewięciu powiatów wokół stolicy zakaz węgla wchodzi w życie 1 stycznia 2028 r. W nowych budynkach możliwych do podłączenia do sieci ciepłowniczej nie wolno eksploatować kotłów na paliwa stałe.",
            "page": "https://skladyopalow.pl/przepisy/uchwala-antysmogowa-mazowieckie/",
            "next_deadline": {
                "date": "2028-01-01",
                "applies_to": "kotły klasy 3 i klasy 4 normy PN-EN 303-5:2012 uruchomione przed 11 listopada 2017 r. (całe województwo)",
                "description": "Można je eksploatować do 31 grudnia 2027 r. Od 1 stycznia 2028 r. dopuszczalne są wyłącznie instalacje spełniające wymagania ekoprojektu z rozporządzenia (UE) 2015/1189 (§ 10 pkt 2 lit. b)."
            },
            "deadlines": [
                {
                    "date": "2018-07-01",
                    "applies_to": "całe województwo - wszystkie instalacje (zakaz paliw z § 4)",
                    "description": "Od 1 lipca 2018 r. obowiązuje zakaz stosowania mułów, flotokoncentratów, węgla brunatnego, węgla kamiennego sypkiego 0-3 mm i paliw z biomasą o wilgotności powyżej 20%."
                },
                {
                    "date": "2023-01-01",
                    "applies_to": "kotły pozaklasowe (niespełniające klasy 3, 4 ani 5 normy PN-EN 303-5:2012) uruchomione przed 11 listopada 2017 r. oraz kominki i piece uruchomione przed tą datą",
                    "description": "Od 1 stycznia 2023 r. eksploatacja kotłów niespełniających wymagań klasy 3, 4 lub 5 jest zakazana (§ 10 pkt 2 lit. a). Kominki i piece uruchomione przed 11 listopada 2017 r. muszą od tego dnia spełniać wymagania ekoprojektu (rozporządzenie Komisji (UE) 2015/1185), chyba że zostały wyposażone w urządzenie redukujące emisję pyłu do wartości z pkt 2 lit. a załącznika II do tego rozporządzenia (§ 10 pkt 3)."
                },
                {
                    "date": "2023-01-02",
                    "applies_to": "cały obszar - nowo budowane budynki (wniosek o pozwolenie na budowę lub zgłoszenie złożone po 1 stycznia 2023 r., czyli od 2 stycznia 2023 r.)",
                    "description": "Zakazana jest eksploatacja instalacji na paliwa stałe w nowo budowanym budynku, jeśli istnieje techniczna możliwość podłączenia go do sieci ciepłowniczej na terenie bezpośrednio przylegającym do działki inwestora (§ 6a, dodany uchwałą 59/22). Brak takiej możliwości trzeba potwierdzić dokumentem operatora sieci albo oświadczeniem projektanta (§ 6b)."
                }
            ]
        },
        "requested_unit": {
            "name": "Mińsk Mazowiecki",
            "level": "municipality",
            "teryt": "1412011",
            "url": "https://skladyopalow.pl/sklady-opalu/mazowieckie/minski/minsk-mazowiecki/"
        }
    }
]

Co wolno palić pod kodem 31-001 (Kraków)?

GET /regulations?postcode=31-001
[
    {
        "voivodeship": "małopolskie",
        "teryt": "12",
        "has_resolution": true,
        "resolution": {
            "title": "Uchwała nr XXXII/452/17 Sejmiku Województwa Małopolskiego z dnia 23 stycznia 2017 r. w sprawie wprowadzenia na obszarze województwa małopolskiego ograniczeń i zakazów w zakresie eksploatacji instalacji, w których następuje spalanie paliw (z wyłączeniem Gminy Miejskiej Kraków) oraz Uchwała nr XVIII/243/16 Sejmiku Województwa Małopolskiego z dnia 15 stycznia 2016 r. w sprawie wprowadzenia na obszarze Gminy Miejskiej Kraków ograniczeń w zakresie eksploatacji instalacji, w których następuje spalanie paliw",
            "publication": "Dz. Urz. Woj. Małopolskiego z 2017 r. poz. 787 (ogłoszono 27 stycznia 2017 r.); zmiana: Dz. Urz. Woj. Małopolskiego z 2022 r. poz. 6497; uchwała dla Krakowa: Dz. Urz. Woj. Małopolskiego z 2016 r. poz. 812 (ogłoszono 1 lutego 2016 r.)",
            "text": "https://edziennik.malopolska.uw.gov.pl/WDU_K/2017/787/akt.pdf",
            "as_of": "2026-10-02",
            "summary": "W Małopolsce obowiązują dwie uchwały antysmogowe: dla Krakowa (od 1 września 2019 r. całkowity zakaz paliw stałych, dozwolony tylko gaz i lekki olej opałowy) oraz dla reszty województwa (uchwała nr XXXII/452/17, zmieniona w 2022 r.). Poza Krakowem kotły pozaklasowe są zakazane od 1 maja 2024 r., a kotły klasy 3 i 4 można eksploatować do 31 grudnia 2026 r. - od 1 stycznia 2027 r. dopuszczalne są tylko nowsze kotły spełniające ekoprojekt z automatycznym podawaniem paliwa albo kotły klasy 5 uruchomione przed 1 lipca 2017 r. Zakazane są też paliwa, w których udział węgla o uziarnieniu 0-3 mm przekracza 15%, oraz paliwa zawierające biomasę (np. drewno) o wilgotności powyżej 20%.",
            "page": "https://skladyopalow.pl/przepisy/uchwala-antysmogowa-malopolskie/",
            "next_deadline": {
                "date": "2027-01-01",
                "applies_to": "województwo poza Krakowem - kotły klasy 3 i klasy 4 normy PN-EN 303-5:2012 uruchomione przed 1 lipca 2017 r.",
                "description": "Można je eksploatować do 31 grudnia 2026 r. Od 1 stycznia 2027 r. dopuszczalne są wyłącznie instalacje spełniające wymagania ekoprojektu i umożliwiające tylko automatyczne podawanie paliwa albo - dla kotłów uruchomionych przed 1 lipca 2017 r. - kotły klasy 5. W sezonie grzewczym 2026/2027 kotły klasy 3 i 4 mogą więc pracować tylko do 31 grudnia 2026 r."
            },
            "deadlines": [
                {
                    "date": "2017-07-01",
                    "applies_to": "województwo poza Krakowem - nowo uruchamiane kotły, kominki i piece oraz wszystkie instalacje (zakaz paliw)",
                    "description": "Od 1 lipca 2017 r. obowiązuje zakaz paliw z § 3. Kotły uruchamiane od tego dnia muszą spełniać wymagania ekoprojektu (rozporządzenie Komisji (UE) 2015/1189) i umożliwiać wyłącznie automatyczne podawanie paliwa (wyjątek: kotły zgazowujące paliwo). Kominki i piece uruchamiane od tego dnia muszą spełniać wymagania ekoprojektu (rozporządzenie Komisji (UE) 2015/1185)."
                },
                {
                    "date": "2019-09-01",
                    "applies_to": "Kraków (granice administracyjne Gminy Miejskiej Kraków) - wszystkie instalacje spalania paliw",
                    "description": "Od 1 września 2019 r. w instalacjach spalania paliw wolno stosować wyłącznie gaz ziemny wysokometanowy lub zaazotowany (w tym skroplony), propan-butan, biogaz rolniczy lub inny rodzaj gazu palnego oraz lekki olej opałowy. Oznacza to całkowity zakaz paliw stałych. Uchwała dla Krakowa nie przewiduje okresów przejściowych po tej dacie."
                },
                {
                    "date": "2024-05-01",
                    "applies_to": "województwo poza Krakowem - kotły pozaklasowe (niespełniające wymagań klasy 3, 4 ani 5 normy PN-EN 303-5:2012) uruchomione przed 1 lipca 2017 r. oraz kominki i piece uruchomione przed 1 lipca 2017 r.",
                    "description": "Od 1 maja 2024 r. eksploatacja takich kotłów jest zakazana (pierwotnie termin wynosił 1 stycznia 2023 r.; przesunęła go uchwała nr LIX/842/22). Kominki i piece uruchomione przed 1 lipca 2017 r. muszą od tego dnia spełniać wymagania ekoprojektu, chyba że osiągają sprawność cieplną co najmniej 80% albo zostały wyposażone w urządzenie redukujące emisję pyłu do wartości z pkt 2 lit. a załącznika II do rozporządzenia (UE) 2015/1185."
                }
            ]
        },
        "requested_unit": {
            "name": "Kraków",
            "level": "municipality",
            "teryt": "1261011",
            "url": "https://skladyopalow.pl/sklady-opalu/malopolskie/krakow/"
        }
    }
]

Kalkulator dopłaty Czyste Powietrze

GET https://skladyopalow.pl/wp-json/so/v1/subsidy

Poziom dofinansowania (podstawowy, podwyższony, najwyższy), procent i maksymalne kwoty dotacji dla wybranych prac według programu Czyste Powietrze (progi i limity z dokumentów programu, wersja i data stanu w polu program). Wynik orientacyjny - decyduje WFOŚiGW. Przyjmuje też POST z tymi samymi parametrami (formularz serwisu używa POST, żeby dochód nie trafiał do adresu). Dochodu nie zapisujemy.

Parametry
NazwaTypOpis
people integer, 1-20 Liczba osób w gospodarstwie domowym (1 - gospodarstwo jednoosobowe). Wymagana razem z dochodem.
income number, 0-10 000 000 Przeciętny miesięczny dochód (zł) - na osobę albo całego gospodarstwa (parametr dochod_typ). Decyduje o poziomie podwyższonym i najwyższym. Nie jest zapisywany.
income_type string, domyślnie person Czy dochod to kwota na osobę (osoba), czy całego gospodarstwa (gospodarstwo - dzielimy przez osoby).
Wartości: person, household
benefit boolean Ustalone prawo do zasiłku stałego, okresowego, rodzinnego albo specjalnego zasiłku opiekuńczego - kwalifikuje do poziomu najwyższego.
annual_income number, 0-10 000 000 Roczny dochód wnioskodawcy (zł, PIT "Podstawa obliczenia podatku") - próg poziomu podstawowego. Nie jest zapisywany.
business boolean Wnioskodawca lub małżonek prowadzi działalność gospodarczą (także najem) - wynik dopisze limit przychodu.
current_heating string, domyślnie solid_fuel Obecne ogrzewanie: stale - tylko paliwo stałe poniżej 5 klasy; stale5 - kocioł klasy 5 lub ekoprojekt; inne - gaz, olej, prąd, pompa, sieć albo kilka źródeł.
Wartości: solid_fuel, solid_fuel_class5, other
eu string, domyślnie unknown Wskaźnik zapotrzebowania na energię użytkową do ogrzewania z audytu = rodzaj przedsięwzięcia: 1 - poniżej 80, 2 - od 80 do 140, 3 - powyżej 140 kWh/(m² rok); niewiem - wynik w trzech wariantach.
Wartości: unknown, 1, 2, 3
new_source string, domyślnie none Nowe źródło ciepła (Załącznik nr 2, tabela 2). Przy gruntowej pompie ciepła doliczamy dolne źródło.
Wartości: none, district_heating, heat_pump_air_water, heat_pump_air_air, heat_pump_ground, gasification_boiler, pellet_boiler, electric
central_heating_dhw boolean Nowa instalacja centralnego ogrzewania i ciepłej wody użytkowej.
ceiling number, 0-5000 Powierzchnia w m²: ocieplenie stropu lub dachu (Załącznik nr 2, tabela 3, lp. 1). Puste - poza zakresem.
floor number, 0-5000 Powierzchnia w m²: ocieplenie podłogi (Załącznik nr 2, tabela 3, lp. 2). Puste - poza zakresem.
walls number, 0-5000 Powierzchnia w m²: ocieplenie ścian (Załącznik nr 2, tabela 3, lp. 3). Puste - poza zakresem.
windows number, 0-5000 Powierzchnia w m²: okna (Załącznik nr 2, tabela 3, lp. 4). Puste - poza zakresem.
doors number, 0-5000 Powierzchnia w m²: drzwi zewnętrzne (Załącznik nr 2, tabela 3, lp. 5). Puste - poza zakresem.
gates number, 0-5000 Powierzchnia w m²: brama garażowa (Załącznik nr 2, tabela 3, lp. 6). Puste - poza zakresem.
ventilation boolean Wentylacja mechaniczna z odzyskiem ciepła (zestaw).
audit boolean Zwrot kosztu audytu energetycznego (audyt jest obowiązkowy).
energy_certificate boolean Zwrot kosztu świadectwa charakterystyki energetycznej po pracach.
cost_district_heating number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "sieć ciepłownicza". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_heat_pump_air_water number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "pompa ciepła powietrze/woda". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_heat_pump_air_air number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "pompa ciepła powietrze/powietrze". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_heat_pump_ground number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "gruntowa pompa ciepła". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_ground_source_loop number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "dolne źródło". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_gasification_boiler number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "kocioł zgazowujący drewno". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_pellet_boiler number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "kocioł na pellet". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_electric number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "ogrzewanie elektryczne". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_central_heating_dhw number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "instalacja c.o. i c.w.u.". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_ceiling number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "ocieplenie stropu lub dachu". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_floor number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "ocieplenie podłogi". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_walls number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "ocieplenie ścian". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_windows number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "okna". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_doors number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "drzwi zewnętrzne". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_gates number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "brama garażowa". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_ventilation number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "wentylacja z rekuperacją". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_audit number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "audyt energetyczny". Bez kosztu liczymy maksymalną kwotę dotacji.
cost_energy_certificate number, 0-10 000 000 Opcjonalnie: koszt netto (zł) pozycji "świadectwo energetyczne". Bez kosztu liczymy maksymalną kwotę dotacji.
html boolean Dołącz gotowe fragmenty HTML wyniku (używa ich formularz na stronie kalkulatora).

Ile dotacji na pompę ciepła i ocieplenie ścian dla 4 osób z dochodem 2000 zł na osobę?

GET /subsidy?people=4&income=2000&current_heating=solid_fuel&eu=3&new_source=heat_pump_air_water&central_heating_dhw=1&walls=140
{
    "level": "elevated",
    "level_name": "podwyższony",
    "condition": null,
    "intensity": 0.7,
    "household": "multi_person",
    "project_type": 3,
    "items": [
        {
            "item": "heat_pump_air_water",
            "name": "Pompa ciepła powietrze/woda o podwyższonej klasie efektywności",
            "clause": "Załącznik nr 2, tabela 2, lp. 2",
            "quantity": 1,
            "unit": "pcs",
            "limit_pln": 24640,
            "net_cost_pln": null,
            "subsidy_pln": 24640,
            "eligible": true
        },
        {
            "item": "central_heating_dhw",
            "name": "Instalacja centralnego ogrzewania i ciepłej wody użytkowej (w tym kolektory słoneczne)",
            "clause": "Załącznik nr 2, tabela 2, lp. 8",
            "quantity": 1,
            "unit": "pcs",
            "limit_pln": 14350,
            "net_cost_pln": null,
            "subsidy_pln": 14350,
            "eligible": true
        },
        {
            "item": "walls",
            "name": "Ocieplenie ścian",
            "clause": "Załącznik nr 2, tabela 3, lp. 3",
            "quantity": 140,
            "unit": "m2",
            "limit_pln": 27020,
            "net_cost_pln": null,
            "subsidy_pln": 27020,
            "eligible": true
        }
    ],
    "table_3_sum_pln": 27020,
    "table_3_limit_pln": 58100,
    "max_subsidy_pln": 67130,
    "own_contribution_net_pln": null,
    "audit_variants": [],
    "notes": [
        "Instalacja c.o. i c.w.u.: W limicie mieszczą się niezbędne prace towarzyszące (lp. 8a) - dotacja na nie to najwyżej 10% dotacji z kosztów instalacji."
    ],
    "conditions": [
        {
            "text": "Jesteś właścicielem lub współwłaścicielem domu od co najmniej 3 lat przed złożeniem wniosku. Wystarczy rok przy zakupie co najmniej 50% udziałów albo przy darowiźnie lub dożywociu od wstępnych (np. rodziców); przy spadku i zasiedzeniu okres nie obowiązuje. Przy współwłasności potrzebna jest zgoda pozostałych współwłaścicieli.",
            "clause": "program, ust. 8.1-8.3 pkt 1"
        },
        {
            "text": "Dom jednorodzinny jest oddany do użytkowania, a wniosek o pozwolenie na budowę albo zgłoszenie budowy złożono najpóźniej 31 grudnia 2020 r. Budynki używane sezonowo i gospodarcze nie dostaną dotacji.",
            "clause": "program, ust. 9.3.1 pkt 4 i 16"
        },
        {
            "text": "Do wniosku dołączasz dokument podsumowujący audyt energetyczny, podpisany przez osobę z rejestru uprawnionych do sporządzania świadectw charakterystyki energetycznej. Dofinansowanie obejmuje tylko prace z audytu, a dotacja należy się po wykonaniu całego wskazanego zakresu. Kosztu audytu program nie zwraca, jeśli dla domu skorzystano z bonu na audyt z gminy.",
            "clause": "program, ust. 9.3.1 pkt 18; Załącznik nr 2, tabela 1, przypis 1"
        }
    ],
    "disclaimer": "Wynik orientacyjny. O przyznaniu i wysokości dotacji decyduje wojewódzki fundusz ochrony środowiska i gospodarki wodnej (WFOŚiGW) na podstawie wniosku, audytu energetycznego i umowy o dofinansowanie. Dane: program w wersji od 20 lipca 2026, stan na 2 października 2026.",
    "program": {
        "version_from": "2026-07-20",
        "as_of": "2026-10-02"
    },
    "sources": [
        {
            "name": "Program priorytetowy Czyste Powietrze, wersja od 20 lipca 2026 r. (NFOŚiGW)",
            "url": "https://czystepowietrze.gov.pl/wez-dofinansowanie/dokumenty-programowe/dokumenty-obowiazujace/01_czyste_powietrze_program_priorytetowy_od_2026_07_20.pdf"
        },
        {
            "name": "Załącznik nr 2 do programu - koszty kwalifikowane oraz maksymalny poziom dofinansowania, wersja od 20 lipca 2026 r.",
            "url": "https://czystepowietrze.gov.pl/wez-dofinansowanie/dokumenty-programowe/dokumenty-obowiazujace/03_zalacznik_nr_2_do_programu_koszty_kwalifikowane_oraz_maksymymalny_poziom_dofinansowania_od_2026_07_20.pdf"
        }
    ],
    "page": "https://skladyopalow.pl/kalkulatory/doplata-czyste-powietrze/"
}

Treść stron w markdown

Każda indeksowana strona serwisu ma wariant markdown pod adresem strony bez końcowego ukośnika z dopiskiem .md, na przykład https://skladyopalow.pl/sklady-opalu/mazowieckie.md, /ceny-opalu/ekogroszek.md albo /przepisy.md. Na górze pliku są: adres kanoniczny, data "stan na", status danych i gotowy zapis do cytowania. Odpowiedź ma typ text/markdown i nagłówek Link z adresem kanonicznym strony HTML.

Spis serwisu dla modeli językowych: llms.txt, pełny kontekst w jednym pliku: llms-full.txt.

Zasady użycia

Dane udostępniamy do cytowania z podaniem źródła. Przy każdym użyciu podaj nazwę serwisu (Składy Opałów), adres strony, której dotyczy informacja (pole url albo page), i datę, na którą dane są aktualne.

Status danych i odpowiedzialność

Każdy wpis składu ma pole source.data_status: unverified (dane z otwartych źródeł, niepotwierdzone), verified (sprawdzone przez redakcję) albo owner (potwierdzone przez właściciela). Cytując skład, podawaj ten status. Godziny otwarcia, dostępność paliw i ceny mogą się zmienić - zawsze trzeba je potwierdzić w składzie. Ceny ze składów to mediany zatwierdzonych cen, a średnie GUS to osobne dane urzędowe - nie łącz ich w jednej liczbie.

Wersja demonstracyjna bez klucza

Bez klucza działa wersja demonstracyjna API - do sprawdzenia, jak wyglądają dane, i do cytowania pojedynczych informacji. Strony serwisu, ich warianty .md oraz llms.txt pozostają otwarte.

  • ceny (/prices, /prices/{fuel}) i przepisy (/regulations) - do 120 zapytań na godzinę z jednej sieci;
  • lista składów (/stores) tylko dla gminy (parametr teryt, 7 cyfr), najwyżej 5 wyników w skrócie: nazwa, gmina, paliwa, status danych i adres strony składu - bez identyfikatora i danych kontaktowych; do 20 zapytań na godzinę z jednej sieci, a błędne zapytanie liczy się potrójnie;
  • wspólny dzienny limit listy składów dla wszystkich użytkowników bez klucza - po jego wyczerpaniu demo odpowiada kodem 429 do końca dnia;
  • wyszukiwanie od kodu pocztowego albo punktu i pełny wpis składu (/stores/{id}) wymagają klucza.

Po przekroczeniu limitu API zwraca kod 429 z nagłówkiem Retry-After (za ile sekund spróbować ponownie). Liczymy zapytania i zapisujemy skrócony adres sieci (bez pełnego adresu IP).

Klucz API - pełny dostęp

Klucz daje wyszukiwanie od kodu pocztowego i punktu, listy do 20 wyników z identyfikatorem, pełne wpisy składów (adres, kontakt, godziny, cennik) i wyższe limity: domyślnie 1000 zapytań i 300 pełnych wpisów na dobę. Klucz wydajemy ręcznie - napisz na [email protected] i podaj nazwę firmy lub projektu, cel użycia i przewidywaną liczbę zapytań. Odpowiadamy zwykle w ciągu 3 dni roboczych.

Klucz przekazuj w nagłówku X-API-Key: twój-klucz (albo Authorization: Bearer twój-klucz), nigdy w adresie URL. Klucz jest ważny 12 miesięcy. Warunki: podawanie źródła przy każdym użyciu, zakaz odsprzedaży danych i budowania z nich konkurencyjnej bazy, zakaz przekazywania klucza innym osobom. Klucz możemy cofnąć w razie naruszenia tych warunków. Wpisy z OpenStreetMap podlegają licencji ODbL (niżej).

Pobieranie hurtem

Pobieranie całej bazy albo jej istotnej części, także w wielu mniejszych zapytaniach, ze stron serwisu albo przez API, tworzenie jej kopii i użycie komercyjne danych wymagają naszej zgody: [email protected]. Zastrzegamy też eksplorację tekstów i danych, w tym do trenowania modeli AI - szczegóły w regulaminie (pkt 11).

Licencje

  • Część danych o składach pochodzi z OpenStreetMap: © współtwórcy OpenStreetMap, licencja Open Database License (ODbL). Takie wpisy mają atrybucję w polu source.origin. Baza danych zbudowana z ich wykorzystaniem podlega warunkom ODbL, w tym obowiązkowi podania źródła i udostępnienia na tych samych zasadach.
  • Średnie ceny węgla, prądu i gazu pochodzą z Banku Danych Lokalnych GUS - przy każdej serii podajemy numer zmiennej i adres źródła.
  • Nazwy, kody i granice gmin pochodzą z rejestru TERYT (GUS) i Państwowego Rejestru Granic (GUGiK).
  • Teksty uchwał antysmogowych linkujemy do dzienników urzędowych województw.

Dane firm

W katalogu są wyłącznie firmy - nie publikujemy osób prywatnych. Danych kontaktowych składów nie wolno wykorzystywać do niezamówionej korespondencji handlowej. Właściciel składu może poprawić, przejąć albo usunąć swój wpis przez formularz Dodaj lub popraw skład.

Zmiany w API

Obecna wersja to so/v1. W odpowiedziach mogą pojawiać się nowe pola. Usunięcie pola albo zmianę jego znaczenia zapowiemy na tej stronie i w specyfikacji OpenAPI.

Zmiana z 9 października 2026 r.: bez klucza działa wersja demonstracyjna z limitami (lista składów tylko dla gminy, najwyżej 5 wyników, bez pola id); wyszukiwanie od kodu i punktu oraz /stores/{id} wymagają klucza API.

Zmiana z 3 października 2026 r.: lista składów zwraca skrót wpisu, najwyżej 20 wyników i tylko dla gminy (parametr teryt ma 7 cyfr) albo punktu. Pole id to stały identyfikator UUID, a pełny wpis jest pod /stores/{id}.