Program CPN · dane otwarte
Dane o cenach maksymalnych CPN: API, CSV i widget
Ceny maksymalne paliw z obwieszczeń Ministra Energii możesz pobrać jako JSON lub CSV albo osadzić na swojej stronie jako widget. Dane są otwarte, na licencji CC BY 4.0 — wystarczy podać źródło.
Widget
Widget pokazuje dzisiejsze ceny maksymalne Pb95, Pb98 i ON i sam się aktualizuje. Wklej kod w HTML swojej strony. Poniżej podgląd na żywo.
Kod widgetu (iframe)
<iframe src="https://radarpaliw.pl/program-cpn/widget" title="Ceny maksymalne paliw CPN" width="100%" height="240" style="border:0;max-width:420px" loading="lazy"></iframe>
Link tekstowy
Jeśli korzystasz z widgetu, dodaj proszę pod nim zwykły link tekstowy do programu CPN. Dzięki temu czytelnicy trafią do pełnych danych, a my możemy dalej utrzymywać serwis.
Kod linku (HTML)
<a href="https://radarpaliw.pl/program-cpn">Ceny maksymalne CPN – Radar Paliw</a>
API JSON
Jeden publiczny adres zwraca aktualne ceny na dziś i jutro oraz pełną historię limitów od startu III edycji programu. Nie wymaga klucza ani rejestracji.
Adres API (GET)
https://radarpaliw.pl/program-cpn/dane.json
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
| version | liczba | Wersja formatu odpowiedzi. Zmiany są wstecznie zgodne — nowa wersja dodaje pola, nie zmienia istniejących. |
| name, description, url | tekst | Nazwa i opis zbioru oraz adres strony programu CPN. |
| license | URL | Licencja danych (CC BY 4.0). |
| attribution | tekst | Gotowa formułka źródła, którą należy podać przy wykorzystaniu danych. |
| unit | tekst | Jednostka cen — PLN/l brutto. |
| updated | data ISO 8601 | Moment ostatniej zmiany danych w strefie Europe/Warsaw. |
| today | obiekt | Limit obowiązujący dziś (Europe/Warsaw) z pól date, pb95, pb98, on, source_name i source_url. |
| tomorrow | obiekt lub null | Limit na kolejny dzień. Pole status to official (jest obwieszczenie Ministra Energii) albo forecast (nasza nieoficjalna prognoza). Pola date, date_end (ostatni dzień obowiązywania, np. poniedziałek po piątku), pb95, pb98, on, source_name i source_url. Przy prognozie dochodzi hurt_date, czyli dzień ceny hurtowej Orlenu, z której liczymy limit. Brak danych daje null. |
| data | tablica | Wszystkie dzienne limity od 3.10.2026, od najstarszego. Każdy element ma pola date, pb95, pb98, on, source_name, source_url oraz url (strona dnia). |
| pb95, pb98, on | liczba lub null | Cena maksymalna w zł/l brutto (benzyna 95, benzyna 98, olej napędowy). Null, gdy brak ceny danego paliwa. |
| source_name, source_url | tekst lub null | Źródło ceny — obwieszczenie Ministra Energii albo serwis, z którego je przepisaliśmy. |
Przykładowa odpowiedź
Odpowiedź skrócona: tablica data zawiera 2 ostatnie wpisy z 47.
Przykładowa odpowiedź (skrócona)
{
"version": 1,
"name": "Ceny maksymalne paliw w programie CPN (Ceny Paliwa Niżej)",
"description": "Dzienne ceny maksymalne benzyny 95, benzyny 98 i oleju napędowego z obwieszczeń Ministra Energii, III edycja programu CPN.",
"url": "https://radarpaliw.pl/program-cpn",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "Źródło: Radar Paliw (radarpaliw.pl/program-cpn) na podstawie obwieszczeń Ministra Energii",
"unit": "PLN/l brutto",
"updated": "2026-11-18T08:11:46+01:00",
"today": {
"date": "2026-11-18",
"pb95": 5.99,
"pb98": 6.64,
"on": 7.57,
"source_name": "Ministerstwo Energii",
"source_url": "https://www.gov.pl/web/energia/maksymalna-cena-detaliczna-paliw-obowiazujaca-18-listopada-2026-r"
},
"tomorrow": {
"date": "2026-11-19",
"date_end": "2026-11-19",
"status": "forecast",
"pb95": 5.97,
"pb98": 6.62,
"on": 7.51,
"hurt_date": "2026-11-18",
"source_name": null,
"source_url": null
},
"data": [
{
"date": "2026-11-17",
"pb95": 6.02,
"pb98": 6.68,
"on": 7.64,
"source_name": "Ministerstwo Energii",
"source_url": "https://www.gov.pl/web/energia/maksymalna-cena-detaliczna-paliw-obowiazujaca-17-listopada-2026-r",
"url": "https://radarpaliw.pl/program-cpn/2026-11-17"
},
{
"date": "2026-11-18",
"pb95": 5.99,
"pb98": 6.64,
"on": 7.57,
"source_name": "Ministerstwo Energii",
"source_url": "https://www.gov.pl/web/energia/maksymalna-cena-detaliczna-paliw-obowiazujaca-18-listopada-2026-r",
"url": "https://radarpaliw.pl/program-cpn/2026-11-18"
}
]
}
Przykłady użycia
curl
curl -s https://radarpaliw.pl/program-cpn/dane.json
curl -s https://radarpaliw.pl/program-cpn/dane.json | jq '.today'
JavaScript (fetch)
const response = await fetch('https://radarpaliw.pl/program-cpn/dane.json');
const { today, tomorrow } = await response.json();
console.log(`Pb95 dziś: ${today.pb95} zł/l`);
if (tomorrow) {
console.log(`Pb95 jutro (${tomorrow.status}): ${tomorrow.pb95} zł/l`);
}
Home Assistant (configuration.yaml)
sensor:
- platform: rest
name: "CPN Pb95 dziś"
unique_id: cpn_pb95_dzis
resource: https://radarpaliw.pl/program-cpn/dane.json
method: GET
scan_interval: 3600
value_template: "{{ value_json.today.pb95 }}"
unit_of_measurement: "zł/l"
json_attributes_path: "$.today"
json_attributes:
- date
- pb98
- "on"
- source_name
W atrybutach sensora dostaniesz też cenę Pb98 i ON. Pole on jest w cudzysłowie, bo w YAML samo on oznacza „prawda”.
Atrybuty pobieramy tylko z obiektu today, bo cała odpowiedź jest za duża na atrybuty encji.
CORS i odświeżanie
-
Odpowiedź ma nagłówek
Access-Control-Allow-Origin: *, więc możesz pobierać dane bezpośrednio z przeglądarki, z dowolnej domeny. - Dane odświeżamy kilka razy dziennie — nowy limit pojawia się po obwieszczeniu Ministra Energii, zwykle po południu. Odpowiedź jest buforowana, więc częstsze zapytania nie dadzą świeższych danych.
- Prosimy, nie odpytuj API częściej niż co 15 minut.
CSV
Te same dzienne limity w formacie CSV (UTF-8, separator przecinek, kropka dziesiętna), gotowe do arkusza kalkulacyjnego.
Adres pliku CSV
https://radarpaliw.pl/program-cpn/dane.csv
Kolumny: data (RRRR-MM-DD), pb95, pb98, on (zł/l brutto),
zrodlo (nazwa źródła) i zrodlo_url (adres obwieszczenia lub serwisu).
Google Sheets
Wpisz w komórce formułę — arkusz sam pobierze i odświeży dane.
Formuła Google Sheets
=IMPORTDATA("https://radarpaliw.pl/program-cpn/dane.csv")
Excel
Wybierz Dane → Z sieci Web, wklej adres pliku CSV i zatwierdź. Dane odświeżysz przyciskiem Odśwież wszystko.
Licencja i cytowanie
Dane udostępniamy na licencji Creative Commons Uznanie autorstwa 4.0 (CC BY 4.0). Możesz je kopiować, przetwarzać i wykorzystywać także komercyjnie, pod warunkiem podania źródła z linkiem.
Formułka źródła
Źródło: Radar Paliw (radarpaliw.pl/program-cpn)
- Ceny maksymalne pochodzą z obwieszczeń Ministra Energii. Wiążąca jest zawsze treść obwieszczenia, a nie nasza kopia danych.
-
Prognozy (pole
tomorrowze statusemforecastoraz prognoza na 7 dni na stronie programu) są nieoficjalne i mają charakter szacunku.
Dla mediów
Piszesz o cenach paliw? Odpowiemy na pytania o zmiany limitu i naszą prognozę. Napisz na [email protected] — podaj redakcję i termin, na który potrzebujesz komentarza.
Jak zbieramy dane i oznaczamy prognozy, opisujemy w zasadach redakcyjnych. Aktualne ceny znajdziesz na stronie programu CPN.