Weather Alerts API
Active official severe weather warnings as JSON, no API key: all US National Weather Service alerts (tornado, flood, winter storm, heat, fire weather, marine) and all German DWD warnings in one CAP-style schema: event, severity, urgency, certainty, onset, expires, headline, instructions, area and states. Filter by state, severity or event, or check up to 25 lat,lon points per call. Monitor mode returns only new warnings.
Example request
curl -X POST https://radarbg.com/v1/weather-alerts-api \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"mode": "area", "country": "US", "states": ["TX", "CA", "FL"], "includeGeometry": false}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
mode | string | area = every active warning in a country (US or DE), optionally only some states; point = warnings that cover one or more lat,lon locations (US and Germany). |
country | string | For area: US (National Weather Service: states, territories, coastal waters) or DE (Germany, Deutscher Wetterdienst). |
states | array | For area: optional state filter. US: TX, FL or Texas; Germany: BY, NW or Bavaria. Empty = whole country. |
lat | number | For point: latitude, e.g. 39.7392. |
lon | number | For point: longitude, e.g. -104.9903. |
locations | array | For point: up to 25 places as 'lat,lon', e.g. 29.7604,-95.3698. A place with no warning returns one row with activeAlerts 0. |
minSeverity | string | Only warnings at this level or higher (CAP severity: Minor < Moderate < Severe < Extreme). Empty = all. |
events | array | Only warnings whose event or headline contains one of these words, e.g. tornado, flood, winter, frost, Gewitter. |
includeGeometry | boolean | Add the warning polygon (GeoJSON) when the source has one (NWS storm-based warnings). |
includeTests | boolean | Also return NWS test/keep-alive messages (normally hidden). |
limit | integer | Maximum rows returned, most severe first. Between 1 and 5000. |
onlyNew | boolean | Return only warnings not returned before for this Monitor ID. Schedule every 5-15 minutes to get each new warning once. |
monitorId | string | Name of the watch for only-new mode, e.g. warehouse-texas. Each Monitor ID keeps its own memory. |
Price
Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.