Widget i API
Darmowy widget pogodowy na stronę www
Wklej jeden znacznik <iframe>, a Twoja strona pokaże prognozę na dziś i jutro oraz wczorajsze rozliczenie trafności — dokładnie te same dane, które serwujemy na trafnapogoda.pl. Widget nie ustawia cookies i nie ładuje żadnych skryptów na Twojej stronie.
<iframe src="https://trafnapogoda.pl/embed/warszawa" width="320" height="190" style="border:0" loading="lazy" title="Pogoda Warszawa — Trafna Pogoda"></iframe>
<div style="width:320px;max-width:100%;font:11px/1.4 Arial,sans-serif;text-align:right"><a href="https://trafnapogoda.pl/pogoda/warszawa" target="_blank" rel="noopener">Prognoza: Trafna Pogoda</a></div>Darmowe API pogodowe JSON — 396 miast Polski
Wszystkie dane serwisu są dostępne jako statyczne pliki JSON z nagłówkami CORS (Access-Control-Allow-Origin: *) — działają z przeglądarki, botów i asystentów. Bez klucza i bez rejestracji.
| Endpoint | Co zwraca |
|---|---|
/data/cities/<slug>.json | pełne dane miasta: prognoza dziś/jutro, godzinowa (48 h), ostrzeżenia IMGW |
/data/national.json | skrót krajowy: 396 miast (temperatury, kody pogody, ostrzeżenia) — także discovery slugów; pole day3 (pojutrze: max/min/pop/code) obecne, gdy dostępny jest dłuższy horyzont |
/data/accuracy_yesterday.json | wczorajsza sprawdzalność: % miast trafionych ±2°C, średni błąd, gotowe zdanie PL |
/data/accuracy.json | backtest 90 dni: ranking 12 modeli i 5 metod (MAE, ±1/±2°C) |
/data/headline.json | nagłówek dnia (krajowe „czytanie pogody”) |
Slug miasta: małe litery, bez polskich znaków, spacje jako myślnik (np. zielona-gora, gorzow-wlkp). Pełną listę slugów zbudujesz z national.json (pole cities[].name).
curl -s https://trafnapogoda.pl/data/cities/gdansk.json \
| jq '{miasto: .name, dzis: .forecast.today.max, jutro: .forecast.tomorrow.max}'Zasady uczciwego użycia
- Darmowe, bez klucza. Prosimy o podanie źródła — link do
trafnapogoda.pl. - Nie odpytuj częściej niż co ~5 minut — dane zmieniają się najwyżej co ~20 minut.
- Pola opisane wyżej traktujemy jako stabilny kontrakt (v0); pozostałe mogą się zmieniać bez zapowiedzi.
- Metodę prognozy i weryfikację trafności opisujemy na stronie Analiza trafności.
Pytania o API i widget
Czy API pogodowe jest darmowe i czy wymaga klucza?
Tak, jest darmowe i nie wymaga klucza ani rejestracji: dane to statyczne pliki JSON z nagłówkami CORS, więc działają z przeglądarki, botów i asystentów. Prosimy tylko o podanie źródła (link do trafnapogoda.pl) i odpytywanie nie częściej niż co ~5 minut.
Jak osadzić widget pogodowy na stronie www?
Wybierz miasto w generatorze na tej stronie i wklej jeden znacznik iframe — widget pokaże prognozę na dziś i jutro oraz wczorajsze rozliczenie trafności; nie ustawia cookies i nie ładuje żadnych skryptów na Twojej stronie.