Przejdź do treści
Radar Paliw

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.

<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

Pola odpowiedzi API dane.json
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 tomorrow ze statusem forecast oraz 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.