API-Dokumentation

Über die pollen.jetzt-API liest du den aktuellen Pollenflug, unsere Bewertung („heute geeignet oder nicht“), Luft- und Wetterwerte sowie den Jahresvergleich für jeden Ort in Deutschland maschinell aus. Antworten kommen als flaches JSON.

1. Schlüssel holen

Du brauchst ein kostenloses Konto (Anmeldung per E-Mail). Den API-Schlüssel erzeugst und verwaltest du in deinem Konto-Bereich. Er wird nur einmal im Klartext angezeigt — kopiere ihn sofort. Mit der Erstellung akzeptierst du die Nutzungsbedingungen.

2. Authentifizierung

Übergib den Schlüssel entweder als HTTP-Header oder als Query-Parameter:

Authorization: Bearer pk_dein_schluessel
# oder
https://pollen.jetzt/api/v1/pollen?q=33181&key=pk_dein_schluessel

3. Endpunkte

GET /api/v1/pollen

Aktuelle Pollenlage + Bewertung für einen Ort. Parameter: q (Stadt oder PLZ) oder lat & lon.

curl -H "Authorization: Bearer pk_dein_schluessel" \
  "https://pollen.jetzt/api/v1/pollen?q=Bad%20W%C3%BCnnenberg"

Beispielantwort (gekürzt):

{
  "ort": { "name": "Bad Wünnenberg", "plz": "33181", "lat": 51.52, "lon": 8.71 },
  "stand": "2026-06-24T14:00:00+00:00",
  "index": 2.0,
  "stufe_max": 2,
  "stufe_label": "mäßig",
  "dominant": "Gräser",
  "urteil": "bedingt",
  "urteil_text": "Kürzere Aktivitäten gehen, empfindliche Personen aufpassen.",
  "pollen": [ { "name": "Gräser", "slug": "graeser", "stufe": 2, "label": "mäßig", "wert": 29 } ],
  "beste_zeit": "...",
  "wetter": { "temp": 31, "wind": 5, "regen": 0, "feuchte": 52 },
  "luft": { "aqi": 29, "label": "gut" },
  "vorschau": [
    { "datum": "2026-06-24", "tmax": 32, "tmin": 16, "regen_prob": 0, "uv": 7.4,
      "dominant": "Gräser", "stufe": 2, "stufe_label": "mäßig" }
  ],
  "quelle": "DWD; Open-Meteo.com; Bewertung: pollen.jetzt",
  "ortsseite": "https://pollen.jetzt/suche?q=33181"
}

GET /api/v1/vergleich

Jahresvergleich aus unserem eigenen Archiv: diese Woche gegen die gleiche Woche vor einem Jahr. Parameter: q (oder lat/lon) und allergen (eines von graeser, birke, erle, beifuss, olive, ambrosia).

curl -H "Authorization: Bearer pk_dein_schluessel" \
  "https://pollen.jetzt/api/v1/vergleich?q=33181&allergen=graeser"

{ "allergen": "graeser", "name": "Gräser",
  "jetzt": 29, "jetzt_stufe": 2,
  "vorjahr": 28, "vorjahr_stufe": 2,
  "einordnung": "ähnlich wie vor einem Jahr" }

4. Limits & Statuscodes

Code	Bedeutung
200	OK — JSON-Antwort.
400	Parameter fehlen oder sind ungültig.
401	Schlüssel fehlt oder ist ungültig.
403	Schlüssel gesperrt.
404	Kein Datensatz/Vergleich für diesen Ort.
429	Tageslimit erreicht (500 Abrufe/Tag). `Retry-After` beachten.

Antworten dürfen zwischengespeichert werden (siehe Cache-Control). Ein einmal täglicher, gebündelter Abruf der benötigten Orte ist erwünscht; flächendeckendes Abgreifen ist nicht gestattet (Nutzungsbedingungen).

5. Attribution (Pflicht)

Gib bei jeder Anzeige die Quelle an: „Quelle: DWD; Wetter: Open-Meteo.com; Bewertung: pollen.jetzt“. Details in den Nutzungsbedingungen.

6. Widgets ohne Code

Wenn du nur eine fertige Anzeige für deine Website möchtest, brauchst du keine API: Erstelle im Konto-Bereich ein Widget und kopiere den Einbettungscode.