Public API

Travel RiskMap stellt zwei Read-only-JSON-Endpoints bereit: aktuelle Warnstufen und ausführliche Sicherheitstexte des Auswärtigen Amts für 199 Länder. Kein API-Key, kein Rate-Limit-Header — bitte fair nutzen und mit Quellenangabe verlinken.

Endpoints

GET/api/warnings

Aktuelle Warnstufen pro Land aus dem OpenData-Feed des Auswärtigen Amts. Aktualisierung zweimal täglich.

Antwort-Schema

{
  "lastUpdated": "2026-05-04T12:00:07.254Z",
  "source": "live",
  "count": 199,
  "data": {
    "TH": {
      "level": 0,
      "warning": false,
      "partialWarning": false,
      "countryName": "Thailand",
      "notice": true,
      "regions": { "TH-BD": 1 },
      "borderWarnings": { "MM": 2 }
    },
    ...
  }
}

Feld	Typ	Bedeutung
`level`	0–3	0 = keine Warnung · 1 = Teilwarnung/Hinweise · 2 = Verschärft · 3 = Reisewarnung
`notice`	bool	Level 0 mit nicht-trivialem Sicherheitstext (z.B. Wetter, Naturgefahren)
`regions`	object	ISO-3166-2-Code → Level (z.B. `"TH-BD": 1`)
`borderWarnings`	object	Nachbar-ISO2 → Level (z.B. `"MM": 2` = Hinweis zur Grenze nach Myanmar)
`countryName`	string	Deutscher Country-Name vom Auswärtigen Amt

GET/api/texts

Ausführliche Sicherheitstexte pro Land. Aktualisierung montags und mittwochs (Vollscrape + Klassifikation).

Antwort-Schema

{
  "lastUpdated": "2026-05-04T12:00:07.254Z",
  "count": 195,
  "data": {
    "TH": {
      "level": 1,
      "security": "Punktuelle Hinweise zu Grenzgebieten…",
      "entry": "Reisepass mit 6 Monaten Restgültigkeit…",
      "regions": { "TH-BD": 1 },
      "borderWarnings": { "MM": 2 },
      "reasoning": "…",
      "autoBumped": false,
      "updatedAt": "2026-05-04T12:00:07.254Z"
    },
    ...
  }
}

Caching & Rate Limits

Beide Endpoints senden Cache-Control: max-age=60 — bitte clientseitig oder per Edge-Cache mindestens 60 Sekunden cachen. Aggressives Polling unter dieser TTL bringt keinen Datenvorteil und belastet die Plattform unnötig. Bei sehr hoher Last reservieren wir uns das Recht, IP-basiert zu limitieren.

Die Daten ändern sich realistisch zweimal täglich (Warnstufen) bzw. zweimal pro Woche (Texte). Empfohlenes Polling-Intervall: stündlich oder seltener.

Attribution & Lizenz

Datenherkunft

Die Daten stammen aus dem OpenData-Feed des Auswärtigen Amts der Bundesrepublik Deutschland und stehen unter der Datenlizenz Deutschland — Namensnennung — Version 2.0 (dl-de/by-2-0). Bei Verwendung bitte Auswärtiges Amt als Original-Quelle nennen.

Travel RiskMap als Aggregator

Die zusätzliche Klassifikation pro Region und Grenze ist eine Eigenleistung von Travel RiskMap. Bei API-Nutzung bitten wir um eine sichtbare Attribution mit Verlinkung auf travelriskmap.de, z. B. „Daten via Travel RiskMap (Quelle: Auswärtiges Amt)" oder „Powered by Travel RiskMap".

Beispiel — Browser / curl

curl -s https://www.travelriskmap.de/api/warnings | jq '.data.TH'

curl -s https://www.travelriskmap.de/api/texts | jq '.data.TH.security'

Hinweis zur Verbindlichkeit

Diese API ersetzt keine offizielle Beratung. Verbindlich sind allein das Auswärtige Amt sowie die Botschaft oder das Konsulat des Reiselandes. Travel RiskMap übernimmt keine Gewähr für Aktualität, Vollständigkeit oder Richtigkeit und keine Haftung für Reise-Entscheidungen, die auf Basis dieser Daten getroffen werden.

Kontakt & Bug-Reports

Bug-Reports, Schema-Wünsche oder Reichweitenanfragen: siehe Impressum.