docs / weather-intel

Weather & Hazards API

base /weather-intel/v19 endpoints

post/weather-intel/v1/environment_current3 credits

premium combined snapshot: current weather + AQ + active alerts + nearby hazards + risk_summary{level,reasons,confidence} for a coordinate

Parameter		Allowed / range	Description
lat	required	-90–90	Latitude in decimal degrees (WGS84), -90..90.
lon	required	-180–180	Longitude in decimal degrees (WGS84), -180..180.
units = metric	optional	metric · imperial	Unit system for temperatures, wind speeds and precipitation.
include	optional	—	Comma-separated blocks to include: weather, air_quality, alerts, hazards. Default: all.
radius_km = 300	optional	1–2000	Search radius in km around the point for nearby hazards (1..2000).

Try in playground →

post/weather-intel/v1/forecast1 credit

global point forecast (MET Norway, ~9 days): hourly steps + daily aggregates with normalized weather-code, feels-like, sunrise/sunset/moon. Optional source=us_nws returns the US-official National Weather Service forecast for US coordinates (api.weather.gov, public domain)

Parameter		Allowed / range	Description
lat	required	-90–90	Latitude in decimal degrees (WGS84), -90..90.
lon	required	-180–180	Longitude in decimal degrees (WGS84), -180..180.
units = metric	optional	metric · imperial	Unit system for temperatures, wind speeds and precipitation.
hours = 24	optional	1–90	Number of forecast steps to return (hourly for ~2.5 days, then 6-hourly to ~day 9 — each step carries its timestamp).
days = 7	optional	1–10	Number of days (1..10).
source = auto	optional	auto · met · us_nws	Forecast source. 'us_nws' returns the US-official NWS gridpoint forecast (US coordinates only); 'met'/'auto' use MET Norway global.

Try in playground →

post/weather-intel/v1/air_quality1 credit

nearest-station air quality (OpenAQ v3): pollutants + computed AQI-US/EAQI-EU + station distance + measurement freshness; honest insufficient_data when no station

Parameter		Allowed / range	Description
lat	required	-90–90	Latitude in decimal degrees (WGS84), -90..90.
lon	required	-180–180	Longitude in decimal degrees (WGS84), -180..180.
radius_km = 10	optional	1–25	Search radius in km around the point for monitoring stations (1..25).

Try in playground →

post/weather-intel/v1/alerts1 credit

official severe-weather warnings by country/US-state or coordinate: EU MeteoAlarm (39 countries) AND US NWS (api.weather.gov, all 50 states + territories + marine zones, via Webshare). The source is chosen automatically from the location; coverage/coverage_note name exactly which authority answered

Parameter		Allowed / range	Description
country	optional	—	MeteoAlarm member country (EU) — slug or ISO2 — OR a US state/marine code (e.g. CA, TX, NY) which routes to NWS api.weather.gov. Alternative to lat/lon.
lat	optional	-90–90	Latitude (alternative to country) — resolved to a MeteoAlarm country (EU) or NWS coverage (US).
lon	optional	-180–180	Longitude (alternative to country).
severity_min	optional	yellow · orange · red	Minimum awareness color (MeteoAlarm yellow/orange/red).
active_only = true	optional	—	Only warnings active NOW (onset<=now<expires). false = full feed.
limit = 50	optional	1–200	Maximum records to return (1..200).

Try in playground →

post/weather-intel/v1/hazards_nearby1 credit

GDACS multi-hazard events (earthquake/cyclone/flood/volcano/wildfire/drought) within a radius of a coordinate, distance-sorted

Parameter		Allowed / range	Description
lat	required	-90–90	Latitude in decimal degrees (WGS84), -90..90.
lon	required	-180–180	Longitude in decimal degrees (WGS84), -180..180.
radius_km = 500	optional	1–5000	Search radius in km around the point for hazard events (1..5000).
days = 14	optional	1–365	Number of days (1..365).
types	optional	—	Comma-separated disaster types: earthquake, tropical_cyclone, flood, volcano, wildfire, drought (or GDACS codes EQ/TC/FL/VO/WF/DR). Default: all.
min_alert_level = green	optional	green · orange · red	Minimum GDACS alert level to include.
limit = 50	optional	1–200	Maximum records to return (1..200).

Try in playground →

post/weather-intel/v1/disasters1 credit

global GDACS disaster events with type/alert-level/date/bbox filters, or a single-event detail via event_id+event_type

Parameter		Allowed / range	Description
types	optional	—	Comma-separated disaster types: earthquake, tropical_cyclone, flood, volcano, wildfire, drought (or GDACS codes EQ/TC/FL/VO/WF/DR). Default: all.
min_alert_level = green	optional	green · orange · red	Minimum GDACS alert level to include.
days = 30	optional	1–365	Number of days (1..365).
bbox	optional	—	Bounding-box filter 'min_lon,min_lat,max_lon,max_lat' applied to event coordinates.
country	optional	—	Filter by GDACS country name or ISO3 (case-insensitive substring).
limit = 100	optional	1–300	Maximum records to return (1..300).
event_id	optional	—	GDACS event id — returns the single-event detail (use with event_type code, e.g. EQ).
event_type	optional	EQ · TC · FL · VO · WF · DR	GDACS event type code for event_id detail lookups.

Try in playground →

post/weather-intel/v1/earthquakes1 credit

USGS earthquake catalog (earthquake.usgs.gov, public domain): filter by magnitude, radius, time window, depth, and PAGER alert — includes small and medium-magnitude events that disaster aggregators like GDACS omit. Results are distance-sorted around a coordinate. Pass event_id for a single-event detail.

Parameter		Allowed / range	Description
lat	optional	-90–90	Latitude for a radius search (with lon + radius_km).
lon	optional	-180–180	Longitude for a radius search.
radius_km = 500	optional	1–20000	Search radius in km around the point for earthquake epicentres (1..20000).
min_magnitude	optional	-1–10	Minimum earthquake magnitude (USGS). Omit for the full catalog (includes micro-quakes M<2.5 that GDACS never lists).
max_magnitude	optional	-1–10	Maximum earthquake magnitude (USGS).
days = 7	optional	1–365	Number of days (1..365).
start	optional	—	ISO start time (overrides days), e.g. 2026-06-01.
end	optional	—	ISO end time.
min_depth_km	optional	-100–1000	Minimum hypocenter depth (km).
max_depth_km	optional	-100–1000	Maximum hypocenter depth (km).
order = time	optional	time · time-asc · magnitude · magnitude-asc	Sort order for the USGS earthquake catalog.
pager_alert	optional	green · yellow · orange · red	Filter to quakes with at least this USGS PAGER impact alert.
limit = 100	optional	1–1000	Maximum records to return (1..1000).
event_id	optional	—	USGS event id — returns the single-event detail.

Try in playground →

post/weather-intel/v1/natural_events1 credit

NASA EONET natural-event catalog (eonet.gsfc.nasa.gov, NASA open data): wildfires, severe storms, volcanoes, floods, icebergs, dust/haze — a second independent hazard source alongside GDACS. Filter by category, status, and date range; optionally list the full EONET category taxonomy.

Parameter		Allowed / range	Description
category	optional	drought · dustHaze · earthquakes · floods · landslides · manmade · seaLakeIce · severeStorms · snow · tempExtremes · volcanoes · waterColor · wildfires	NASA EONET natural-event category filter.
status = open	optional	open · closed · all	EONET event status: open (ongoing), closed, or all.
days = 60	optional	1–365	Number of days (1..365).
bbox	optional	—	Bounding-box filter 'min_lon,min_lat,max_lon,max_lat' applied to event coordinates.
limit = 50	optional	1–200	Maximum records to return (1..200).
list_categories = false	optional	—	Return the EONET category taxonomy instead of events.

Try in playground →

post/weather-intel/v1/fires1 credit

Live wildfire and thermal-anomaly hotspots from NASA FIRMS (firms.modaps.eosdis.nasa.gov, NASA open data): pixel-level VIIRS (375 m) and MODIS (1 km) near-real-time detections — the raw sensor data that disaster aggregators like GDACS and EONET do not include. Query by a coordinate radius or a bounding box; each hotspot includes brightness, Fire Radiative Power (FRP), confidence, day/night flag, and the exact acquisition timestamp.

Parameter		Allowed / range	Description
lat	optional	-90–90	Latitude for a radius search (with lon + radius_km); alternative to bbox.
lon	optional	-180–180	Longitude for a radius search; alternative to bbox.
radius_km = 100	optional	1–1000	Search radius in km around the point for active-fire hotspots (1..1000).
bbox	optional	—	Bounding box 'min_lon,min_lat,max_lon,max_lat' — alternative to lat/lon/radius_km (FIRMS area query).
sensor = viirs_snpp	optional	viirs_snpp · viirs_noaa20 · viirs_noaa21 · modis	Satellite sensor for fire detection. VIIRS (375 m resolution) gives the finest detail; MODIS (1 km) covers the longest historical record. All feeds are near-real-time (NRT) from NASA FIRMS.
days = 1	optional	1–10	Look-back window in days (1..10) for NRT detections.
min_confidence	optional	low · nominal · high	Minimum detection confidence (VIIRS low/nominal/high; MODIS percent mapped to the same bands at 30/80).
min_frp	optional	0–100000	Minimum Fire Radiative Power in megawatts — filters out the smallest thermal anomalies.
limit = 200	optional	1–1000	Maximum records to return (1..1000).

Try in playground →

Example request · environment_current

curl -X POST https://api.reefapi.com/weather-intel/v1/environment_current \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"lat":52.52,"lon":13.405}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}