Publiczne API

Open data · CC BY 4.0 · bez kluczy

Państwo to nie czarna skrzynka

Wszystkie dane, które widzisz w PINGGLE, możesz pobrać sam. Bez logowania, bez kluczy, bez limitów per-IP. Cache 10 min na CDN, CORS dla każdej domeny.

Endpointy v1

/api/public/v1/
Indeks endpointów + metadane.
JSON
/api/public/v1/mp-ranking
Ranking 460 posłów: frekwencja, lojalność klubowa, sumy głosów.
JSONCSV
/api/public/v1/processes
Procesy legislacyjne X kadencji.
JSONCSV?limit=1..200
/api/public/v1/finance
NBP (kursy + RPP), GUS (CPI), MF (dług SP).
JSON
/api/public/v1/budget
Budżet państwa 2025 + demografia (GUS).
JSONCSV
/api/public/v1/market
Tickery live: Brent/WTI, gaz, metale, kursy NBP, złoto (Stooq + NBP).
JSON
/api/public/v1/fuel
Ceny paliw Pb95/ON/LPG z pełnym rozbiciem podatkowym (akcyza, opłata paliwowa, emisyjna, VAT).
JSON
/api/public/v1/clubs
Statystyki klubów parlamentarnych (frekwencja, lojalność, dyscyplina).
JSONCSV

Przykład

# JSON
curl https://pinggle.app/api/public/v1/mp-ranking

# CSV
curl https://pinggle.app/api/public/v1/mp-ranking?format=csv -o ranking.csv

# JS (CORS działa)
fetch("/api/public/v1/finance").then(r => r.json()).then(console.log)

Licencja i atrybucja

Dane oryginalne pochodzą od instytucji publicznych (NBP, GUS, MF, Sejm RP, GPW) – domena publiczna lub warunki ich licencji. Nasze obliczenia, agregacje i widoki publikujemy na licencji Creative Commons CC BY 4.0: używaj komercyjnie, modyfikuj, ale podaj źródło – pinggle.app.

Bez kluczy API. Bez limitów per-IP.
JSON + CSV (BOM dla Excela).
CORS: Access-Control-Allow-Origin: *

Embedy

Gotowe widgety do osadzenia w dowolnym serwisie (iframe, bez JS):

<!-- Poseł -->
<iframe
  src="https://pinggle.org/embed/posel/12"
  width="100%" height="240"
  style="border:0;border-radius:14px"
  loading="lazy" title="PINGGLE – poseł #12"></iframe>

<!-- Klub parlamentarny -->
<iframe
  src="https://pinggle.org/embed/klub/KO"
  width="100%" height="240" loading="lazy"
  style="border:0;border-radius:14px" title="PINGGLE – klub KO"></iframe>

<!-- Budżet państwa -->
<iframe
  src="https://pinggle.org/embed/budzet"
  width="100%" height="200" loading="lazy"
  style="border:0;border-radius:14px" title="PINGGLE – budżet"></iframe>

<!-- Ceny paliw + rozbicie podatkowe -->
<iframe
  src="https://pinggle.org/embed/koszyk"
  width="100%" height="320" loading="lazy"
  style="border:0;border-radius:14px" title="PINGGLE – paliwa"></iframe>

Bug? Pomysł na endpoint? Pisz na api@pinggle.app lub PR na GitHub (wkrótce).