Introduction

Weather Ruse is a unified NWP API — 7 operational models, consistent endpoints, CF-standard variables.

What is Weather Ruse?

Weather Ruse gives you access to 7 operational NWP models through a single, consistent REST API. One auth header, one response schema — swap models with a query parameter.

GET https://api.weather-ruse.com/point
  ?model=ecmwf-ifs
  &vars=air_temperature_2m,wind_u_10m,wind_v_10m
  &lat=48.85
  &lon=2.35
  &init_time=2026-06-23T06:00:00Z
  &lead_from=0
  &lead_to=48
Authorization: Bearer wr-<your-key>

Supported models

Model ID	Provider	Resolution	Coverage	Update cycle
`gfs`	NOAA	~13 km	Global	Every 6 h
`ecmwf-ifs`	ECMWF	~9 km	Global	Every 12 h
`hrrr`	NOAA	3 km	CONUS	Every 1 h
`nam`	NOAA	12 km	North America	Every 6 h
`icon-global`	DWD	~13 km	Global	Every 6 h
`icon-eu`	DWD	6.5 km	Europe	Every 3 h
`arome`	Météo-France	1.3 km	France + borders	Every 3 h

Endpoints

Endpoint	Description
`GET /point`	Point forecast — single lat/lon, one or more variables, arbitrary lead range
`GET /bbox`	Grid forecast — bounding box, returns a 2-D field; supports JSON and NetCDF output
`GET /profile`	Vertical profile — pressure-level stack at a single point
`GET /llm`	Natural language query — parse a weather question and return a structured answer
`GET /collections/{model}/position`	OGC EDR position query
`GET /collections/{model}/area`	OGC EDR area query

All endpoints are OGC API — Environmental Data Retrieval compliant. Responses from the /collections routes use CoverageJSON and are interoperable with any OGC client.

Variables

All variable names follow the CF convention. Units are fixed per variable; no conversion flags.

Variable	Unit	Notes
`air_temperature_2m`	K
`dewpoint_temperature_2m`	K
`relative_humidity_2m`	%
`wind_u_10m`, `wind_v_10m`	m s⁻¹	Standard hub height
`wind_gust_10m`	m s⁻¹
`wind_u_80m`, `wind_v_80m`	m s⁻¹	Energy hub height
`wind_u_100m`, `wind_v_100m`	m s⁻¹	Energy hub height
`mean_sea_level_pressure`	Pa
`total_precipitation`	kg m⁻²
`total_cloud_cover`	%
`low_cloud_cover`, `mid_cloud_cover`, `high_cloud_cover`	%
`cape`	J kg⁻¹	Convective available potential energy
`visibility`	m
`snow_depth`	m

Industry use cases

Wind energy — Pull wind_u_80m / wind_v_80m from HRRR at turbine coordinates every hour to feed short-term production forecasts. Switch to ECMWF-IFS for 10-day ahead dispatch planning.

Solar / grid operations — Combine total_cloud_cover, low_cloud_cover, and air_temperature_2m across a GFS grid to drive irradiance models for utility-scale solar fleet optimization.

Aviation — Query wind_u_10m, visibility, cape, and mean_sea_level_pressure from ICON-EU for aerodrome briefings and turbulence risk scoring along flight paths.

Maritime — Use the /bbox endpoint with ECMWF-IFS to pull a full North Atlantic grid for route optimization, integrating wind_gust_10m and total_precipitation into voyage planning.

Agriculture — Combine air_temperature_2m, dewpoint_temperature_2m, total_precipitation, and snow_depth from AROME for frost alerts and irrigation scheduling across field polygons.

Severe weather — Monitor cape and wind_gust_10m from HRRR (1-hour update cycle, 3 km resolution) for convective hazard alerts over CONUS.

Authentication

All requests require a Bearer token. Create a key at console.weather-ruse.com.

Authorization: Bearer wr-<your-key>

Keys are scoped per project in the console. Rotate or revoke them without changing your base URL or code.

Base URL

https://api.weather-ruse.com

Next steps

Quickstart — working request in under 5 minutes
API reference — /point
API reference — /bbox
API reference — /llm
Models
Variables