MeteoIntel

Location & Forecast length

Location:
Forecast length:

By default, we provide forecasts for 7 days, but you can access forecasts for up to 16 days.

Adjust 15-minute range with forecast_minutely_15 and past_minutely_15 below.

Panel orientation (GTI)

Used for global_tilted_irradiance (GTI). Leave default (e.g. 35° tilt, 0° south) if you only need horizontal irradiance (GHI/DNI/DHI).

Settings

API URL
https://api.meteointel.com/forecast?latitude=52.52&longitude=13.41&minutely_15=shortwave_radiation Open in new tab →

API Documentation

The /forecast endpoint returns JSON for any location. For energy and PV forecasting use minutely_15, hourly, and daily to get 15-minute, hourly, and daily data. Key variables: shortwave (GHI), direct/diffuse/DNI, GTI (with tilt and azimuth), cloud cover, and soiling-related (aerosol, dust, PM). Default: 7 days from midnight. Parameters:

latitude longitude Floating point Required
WGS84 latitude and longitude. Comma-separated for multiple locations.
minutely_15 String array
Comma-separated 15-minute variables (irradiance, cloud, soiling, etc.). Use forecast_minutely_15 / past_minutely_15 for range (number of 15-min intervals).
hourly String array
Comma-separated hourly variables (solar radiation, cloud, temperature, wind, etc.).
daily String array
Daily aggregations (e.g. shortwave_radiation_sum, sunshine_duration, sunrise, sunset). Requires timezone.
tilt azimuth Number Default: 35, 0
Panel orientation in degrees for global tilted irradiance (GTI). Tilt 0–90; azimuth 0° = south, -90° = east, 90° = west.
timezone String Default: GMT
IANA time zone for timestamps. Use auto to resolve from coordinates.
forecast_days past_days Integer Default: 7, 0
Number of forecast days (max 16) and past days to include.
temperature_unit wind_speed_unit precipitation_unit timeformat String
Units and time format. Same as Weather Forecast API.
api_key String
Your API key for authenticated requests.

Full parameter list matches the Weather Forecast API. Required parameters remain stable.

Variables overview

Solar: shortwave_radiation (GHI), direct_radiation, diffuse_radiation, direct_normal_irradiance (DNI), global_tilted_irradiance (GTI, needs tilt/azimuth), terrestrial_radiation. Instant variants end with _instant. Sun: sunshine_duration, uv_index, uv_index_clear_sky, is_day. Soiling / aerosols: aerosol_optical_depth, dust, pm10, pm2_5. Daily sums: e.g. shortwave_radiation_sum, sunshine_duration, sunrise, sunset.

15-minutely Parameter Definition

Available 15-minutely variables. Many are instantaneous; radiation and precipitation use preceding 15 min mean or sum.

shortwave_radiation Preceding 15 min mean W/m²
Shortwave solar radiation (GHI) as average of the preceding 15 minutes. Total global horizontal irradiation.
direct_radiation Preceding 15 min mean W/m²
Direct solar radiation as average of the preceding 15 minutes on the horizontal plane.
diffuse_radiation Preceding 15 min mean W/m²
Diffuse solar radiation (DHI) as average of the preceding 15 minutes.
direct_normal_irradiance Preceding 15 min mean W/m²
Direct normal irradiance (DNI) as average of the preceding 15 minutes, perpendicular to the sun.
global_tilted_irradiance Preceding 15 min mean W/m²
Total radiation on a tilted plane (GTI) as average of the preceding 15 minutes. Specify tilt and azimuth. Tilt 0–90°; azimuth 0° = south.
terrestrial_radiation Preceding 15 min mean W/m²
Long-wave terrestrial radiation as average of the preceding 15 minutes.
shortwave_radiation_instant Instant W/m²
Instantaneous shortwave solar radiation (GHI) at the interval time.
direct_radiation_instant Instant W/m²
Instantaneous direct solar radiation on the horizontal plane.
diffuse_radiation_instant Instant W/m²
Instantaneous diffuse solar radiation (DHI).
direct_normal_irradiance_instant Instant W/m²
Instantaneous direct normal irradiance (DNI).
global_tilted_irradiance_instant Instant W/m²
Instantaneous global tilted irradiance (GTI).
terrestrial_radiation_instant Instant W/m²
Instantaneous long-wave terrestrial radiation.
sunshine_duration Preceding 15 min sum s
Sunshine duration in seconds during the preceding 15 minutes.
uv_index Instant
UV index at the interval time, considering clouds.
uv_index_clear_sky Instant
UV index under clear-sky conditions.
is_day Instant
1 if the interval has daylight, 0 at night.
cloud_cover Instant %
Total cloud cover as an area fraction.
cloud_cover_low Instant %
Low-level clouds and fog up to 3 km altitude.
cloud_cover_mid Instant %
Mid-level clouds from 3 to 8 km altitude.
cloud_cover_high Instant %
High-level clouds from 8 km altitude.
weather_code Instant WMO code
Weather condition as a numeric code. Follow WMO weather interpretation codes.
temperature_2m Instant °C (°F)
Air temperature at 2 meters above ground.
apparent_temperature Instant °C (°F)
Apparent temperature is the perceived feels-like temperature combining wind chill factor, relative humidity and solar radiation.
dew_point_2m Instant °C (°F)
Dew point temperature at 2 meters above ground.
relative_humidity_2m Instant %
Relative humidity at 2 meters above ground.
wet_bulb_temperature_2m Instant °C (°F)
Wet-bulb temperature at 2 meters above ground.
wind_speed_10m Instant km/h (mph, m/s, knots)
Wind speed at 10 meters above ground.
wind_direction_10m Instant °
Wind direction at 10 meters above ground.
wind_gusts_10m Preceding 15 min max km/h (mph, m/s, knots)
Wind gusts at 10 meters above ground as maximum of the preceding 15 minutes.
precipitation Preceding 15 min sum mm (inch)
Total precipitation (rain, showers, snow) sum of the preceding 15 minutes.
rain Preceding 15 min sum mm (inch)
Rain from large-scale weather systems of the preceding 15 minutes.
showers Preceding 15 min sum mm (inch)
Showers from convective precipitation in the preceding 15 minutes.
snow_depth Instant m
Snow depth on the ground.
snowfall_height Instant m
Height of snowfall (snow level).
precipitation_probability Preceding 15 min probability %
Probability of precipitation with more than 0.1 mm. Based on ensemble weather models.
pm10 Instant μg/m³
Particulate matter with diameter smaller than 10 µm (PM₁₀) close to surface.
pm2_5 Instant μg/m³
Particulate matter with diameter smaller than 2.5 µm (PM₂.₅) close to surface.
carbon_monoxide Instant μg/m³
Carbon monoxide concentration close to surface (10 m above ground).
carbon_dioxide Instant ppm
Carbon dioxide concentration close to surface.
nitrogen_dioxide Instant μg/m³
Nitrogen dioxide concentration close to surface.
nitrogen_monoxide Instant μg/m³
Nitrogen monoxide concentration close to surface.
sulphur_dioxide Instant μg/m³
Sulphur dioxide concentration close to surface.
ozone Instant μg/m³
Ozone concentration close to surface.
ammonia Instant μg/m³
Ammonia concentration. Only available for Europe.
methane Instant μg/m³
Methane concentration close to surface.
aerosol_optical_depth Instant
Aerosol optical depth at 550 nm of the entire atmosphere. Relevant for soiling and irradiance attenuation.
dust Instant μg/m³
Saharan dust particles close to surface. Affects soiling and solar yield.
pm10_wildfires Instant μg/m³
PM₁₀ from wildfire smoke.
pm2_5_total_organic_matter Instant μg/m³
Organic matter component of PM₂.₅.
secondary_inorganic_aerosol Instant μg/m³
Secondary inorganic aerosol (e.g. sulphate, nitrate).
residential_elementary_carbon Instant μg/m³
Elementary carbon from residential combustion.
total_elementary_carbon Instant μg/m³
Total elementary carbon (black carbon).
sea_salt_aerosol Instant μg/m³
Sea salt aerosol concentration.
european_aqi Instant EAQI
European Air Quality Index. Consolidated index (max of individual indices). 0–20 good, 20–40 fair, 40–60 moderate, 60–80 poor, 80–100+ very poor.
us_aqi Instant USAQI
United States Air Quality Index. 0–50 good, 51–100 moderate, 101–150 unhealthy for sensitive groups, 151–200 unhealthy, 201–500 very unhealthy to hazardous.
european_aqi_ozone Instant EAQI
European AQI for ozone.
european_aqi_pm10 Instant EAQI
European AQI for PM₁₀.
european_aqi_pm2_5 Instant EAQI
European AQI for PM₂.₅.
european_aqi_nitrogen_dioxide Instant EAQI
European AQI for nitrogen dioxide.
european_aqi_sulphur_dioxide Instant EAQI
European AQI for sulphur dioxide.
formaldehyde Instant μg/m³
Formaldehyde concentration.
non_methane_volatile_organic_compounds Instant μg/m³
Non-methane volatile organic compounds (NMVOC).
peroxyacyl_nitrates Instant μg/m³
Peroxyacyl nitrates (PAN).
glyoxal Instant μg/m³
Glyoxal concentration (tracer for secondary organic aerosol).
alder_pollen Instant grains/m³
Alder pollen concentration. Only available in Europe (CAMS).
birch_pollen Instant grains/m³
Birch pollen concentration. Only available in Europe.
grass_pollen Instant grains/m³
Grass pollen concentration. Only available in Europe.
mugwort_pollen Instant grains/m³
Mugwort pollen concentration. Only available in Europe.
olive_pollen Instant grains/m³
Olive pollen concentration. Only available in Europe.
ragweed_pollen Instant grains/m³
Ragweed pollen concentration. Only available in Europe.
pressure_msl Instant hPa
Atmospheric air pressure reduced to mean sea level. Standard meteorological pressure.
surface_pressure Instant hPa
Atmospheric pressure at the surface. Decreases with elevation.
visibility Instant m
Viewing distance in meters. Influenced by low clouds, humidity and aerosols.
cape Instant J/kg
Convective available potential energy (CAPE).
lightning_potential Instant J/kg
Lightning potential index.
vapour_pressure_deficit Instant kPa
Vapour pressure deficit (VPD). High VPD (>1.6 kPa) increases plant transpiration; low (<0.4) decreases it.
et0_fao_evapotranspiration Preceding 15 min sum mm (inch)
ET₀ reference evapotranspiration (FAO-56 Penman-Monteith). Well-watered grass reference. Used for irrigation and moisture modelling.
evapotranspiration Preceding 15 min sum mm (inch)
Evapotranspiration from land surface and plants. Depends on available soil water.
freezing_level_height Instant m
Altitude above sea level of the 0°C level.
temperature_80m Instant °C (°F)
Air temperature at 80 meters above ground (e.g. for wind turbines).
temperature_120m Instant °C (°F)
Air temperature at 120 meters above ground.
temperature_180m Instant °C (°F)
Air temperature at 180 meters above ground.
soil_temperature_0cm Instant °C (°F)
Soil temperature at 0 cm (surface). On water, equals water surface temperature.
soil_temperature_6cm Instant °C (°F)
Soil temperature at 6 cm depth.
soil_temperature_18cm Instant °C (°F)
Soil temperature at 18 cm depth.
soil_temperature_54cm Instant °C (°F)
Soil temperature at 54 cm depth.
soil_moisture_0_to_1cm Instant m³/m³
Average soil water content (volumetric) in the 0–1 cm layer.
soil_moisture_1_to_3cm Instant m³/m³
Average soil water content in the 1–3 cm layer.
soil_moisture_3_to_9cm Instant m³/m³
Average soil water content in the 3–9 cm layer.
soil_moisture_9_to_27cm Instant m³/m³
Average soil water content in the 9–27 cm layer.
soil_moisture_27_to_81cm Instant m³/m³
Average soil water content in the 27–81 cm layer.

JSON return object

On success the API returns a JSON object with minutely_15, hourly, daily (and optional current), each containing time and the requested variable arrays. Structure is the same as the Weather Forecast API.

{
    "latitude": 52.52,
    "longitude": 13.419,
    "elevation": 44.812,
    "generationtime_ms": 2.2119,
    "utc_offset_seconds": 0,
    "timezone": "Europe/Berlin",
    "timezone_abbreviation": "CEST",
    "hourly": {
        "time": ["2022-07-01T00:00", "2022-07-01T01:00", "2022-07-01T02:00", ...],
        "temperature_2m": [13, 12.7, 12.7, 12.5, 12.5, 12.8, 13, 12.9, 13.3, ...]
    },
    "hourly_units": {
        "temperature_2m": "°C"
    }
}

Errors

On invalid or missing parameters the API returns a JSON error object with HTTP 400.

{
    "error": true, 
    "reason": "Cannot initialize WeatherVariable from invalid String value
	    temperature_2m for key hourly" 
}