• API Overview
  • API Reference
  • C Library
  • Web Application
  • Knowledge Base
  • Back to meteonorm.com
Getting startedAuthenticationDemo locationsList of parametersQuerying climate dataQuerying observationsQuerying forecastsHorizon and altitudeChangelog APIChangelog algorithms & data
powered by Zudoku
API Overview

Querying Climate Data

There are two ways to query climate data from the Meteonorm API:

  1. /climate/tmy. Typical meteorological years, based on climatological data.
  2. /climate/amy. Actual meteorological years, based on obvervations (ground stations and satellites) and reanalysis data.

TMYs

Here's how you generate a TMY for:

  • a south-facing (180°) surface with a tilt of 30°,
  • a temporal resolution (frequency) of 1 minute,
  • parameters global horizontal and tilted irradiance, PV production, and temperature,
  • taking into account shading caused by the surrounding terrain/horizon.
TerminalCode
PARAMETERS="global_horizontal_irradiance,\
global_horizontal_irradiance_with_shading,\
global_tilted_irradiance,\
global_tilted_irradiance_with_shading,\
pv_production,\
pv_production_with_shading,\
temperature"

curl -H "Authorization: Bearer demo0000-0000-0000-0000-000000000000" \
    --get \
    --data "lat=50" \
    --data "lon=10" \
    --data "surface_azimuth=180" \
    --data "surface_tilt=30" \
    --data "horizon=auto" \
    --data "frequency=1_minute" \
    --data "parameters=$PARAMETERS" \
    "https://demo.meteonorm.com/v1/climate/tmy"

To generate a TMY for, e.g. the year 2060 based on climate change scenario SSP245, use the arguments future_scenario and future_year:

TerminalCode
curl -H "Authorization: Bearer demo0000-0000-0000-0000-000000000000" \
    --get \
    --data "lat=50" \
    --data "lon=10" \
    --data "future_scenario=ssp2_45" \
    --data "future_year=2060" \
    --data "parameters=global_horizontal_irradiance,temperature,precipitation" \
    "https://demo.meteonorm.com/v1/climate/tmy"

See the API Reference for a complete list of options.

Note: These examples use our demo API URL. No registration required! See Free lat/lon locations for more information on how you can test the Meteonorm API free of charge. For operational use, replace demo.meteonorm.com with api.meteonorm.com.

AMYs

Because Actual Meteorological Years are based on observations, you have to specify the start month (YYYY-MM) of the desired year. Here's how you query an AMY for the year 2022:

TerminalCode
PARAMETERS="global_horizontal_irradiance,\
global_horizontal_irradiance_with_shading,\
global_tilted_irradiance,\
global_tilted_irradiance_with_shading,\
pv_production,\
pv_production_with_shading,\
temperature"

curl -H "Authorization: Bearer demo0000-0000-0000-0000-000000000000" \
    --get \
    --data "start=2022-01" \
    --data "lat=50" \
    --data "lon=10" \
    --data "surface_azimuth=180" \
    --data "surface_tilt=30" \
    --data "horizon=auto" \
    --data "frequency=1_hour" \
    --data "parameters=$PARAMETERS" \
    "https://demo.meteonorm.com/v1/climate/amy"

Note: These examples use our demo API URL. No registration required! See Free lat/lon locations for more information on how you can test the Meteonorm API free of charge. For operational use, replace demo.meteonorm.com with api.meteonorm.com.

Last modified on September 8, 2026
List of parametersQuerying observations
On this page
  • TMYs
  • AMYs