REST API

REST API#

Wetterdienst has an integrated REST API which can be started by invoking:

wetterdienst restapi

There’s also a hosted version at wetterdienst.eobs.org.

Web Frontend#

The REST API is complemented by a modern web frontend built with Nuxt.js, providing an interactive interface for exploring weather data.

Features#

  • Interactive Explorer: Browse and query weather data with an intuitive UI

    • Map-based station selection with search and filtering

    • Parameter selection across multiple providers and networks

    • Real-time data visualization with tables and charts

    • Date range selection for historical data

  • Comprehensive Settings: Full access to all backend API parameters

    • General: Humanize parameters, unit conversion, custom unit targets

    • Values mode: Data shape (long/wide), skip empty stations, drop nulls

    • Interpolation mode: Station distances, nearby station distance, gain thresholds

  • Climate Stripes: Visual representation of temperature trends

  • Customization: Primary color themes and dark mode support

  • Export: Download data in CSV, JSON, or GeoJSON formats

Access#

Visit wetterdienst.eobs.org to use the web interface.

The following examples use httpie to demonstrate the usage of the REST API.

Examples#

Coverage#

http localhost:7890/api/coverage

Stations#

# Acquire list of DWD OBS stations.
http localhost:7890/api/stations provider==dwd network==observation parameters==daily/kl periods==recent all==true

# Filter stations by name (fuzzy, case-insensitive).
http localhost:7890/api/stations provider==dwd network==observation parameters==daily/kl periods==recent name==Darmstadt

# Filter by name with custom threshold (0–1, default 0.8).
http localhost:7890/api/stations provider==dwd network==observation parameters==daily/kl periods==recent name==Darmstatt name_threshold==0.85

# Query list of stations with SQL.
http localhost:7890/api/stations provider==dwd network==observation parameters==daily/kl periods==recent sql=="lower(name) LIKE lower('%dresden%');"

# Acquire list of DWD DMO stations.
http localhost:7890/api/stations provider==dwd network==dmo parameters==hourly/icon/temperature_air_mean_2m periods==recent all==true

Issues (available model-run datetimes)#

# List available MOSMIX-L run datetimes for a station.
http localhost:7890/api/issues provider==dwd network==mosmix station==10147

# List available DMO ICON run datetimes for a station.
http localhost:7890/api/issues provider==dwd network==dmo station==10147

Values#

# Acquire observations.
http localhost:7890/api/values provider==dwd network==observation parameters==daily/kl periods==recent station==1048,4411

# Observations for specific date.
http localhost:7890/api/values provider==dwd network==observation parameters==daily/kl periods==recent station==1048,4411 date==2020-08-01

# Observations for date range.
http localhost:7890/api/values provider==dwd network==observation parameters==daily/kl periods==recent station==1048,4411 date==2020-08-01/2020-08-05

# Observations with SQL.
http localhost:7890/api/values provider==dwd network==observation parameters==daily/kl periods==recent station==1048,4411 shape=="wide" sql=="temperature_air_max_2m < 2.0;"

# Acquire ICON data.
http localhost:7890/api/values provider==dwd network==dmo parameters==hourly/icon/temperature_air_mean_2m station==01001 date==2024-05-27