API for automatic access to weather forecasts.

To use the API requests, you must activate the token.

Just get an API token in your profile and make API requests.

Welcome to the GridForecast API documentation. Using the instructions and interactive code examples below you will be able to start making API requests in a matter of minutes.

The GridForecast API was built to deliver accurate weather data for any application and use case, from real-time and historical weather information all the way to 16-day weather forecasts, supporting all major programming languages. Our straightforward API design will make it easy to use the API — continue reading below to get started.

Description:

The Global Forecast System (GFS) climate model is used to build the weather forecasts. With a spatial resolution of 0.25 degrees. The time resolution for the next 72 hours is 1 hour, and further, up to 384 hours - 3 hours. The GFS model is updated four times a day (00:00, 06:00, 12:00 and 18:00 UTC). All forecasts are provided by the UTC timestamp from the current timestamp for a period of up to 16 days.

To obtain the weather forecast using this API, you must make a request for the URL using the GET method with the required parameters containing the required coordinates and the required timestamp. As a result, the response will be returned as a string in JSON format containing a list of heights and data related to these heights.

Parameters:

lat - Latitude, separator is a dot
lon - Longitude, separator is a dot
datetime - Time in the format YYYYmmddHHii. Where YYYY is the year, mm is the month, dd is the day, HH is the Hour, ii is the minute

 

Example of API call:

https://gridforecast.com/api/forecast/lat;lon/datetime
https://gridforecast.com/api/forecast/49.8479;35.6541/201912151100

 

Example of API response:

{"r": 60, "t": 19, "sp": 99779, "tp": 0, "hcy": 0, "lcy": 0, "mcy": 0, "vis": 24135, "lftx": 8, "aptmp": 19, "cpofp": -50, "dswrf": 0, "prmsl": 101691, "tdmax": 20, "tdmin": 13, "speed10": 3.9, "speed20": 5, "speed30": 5.2, "speed40": 5.7, "speed50": 6.3, "speed80": 7.8, "degree10": 269, "degree20": 270, "degree30": 270, "degree40": 270, "degree50": 270, "degree80": 271, "latitude": 49.75, "speed100": 8.5, "degree100": 271, "longitude": 35.75}

Parameters response:

r Relative humidity %
t Temperature °C
sp Surface pressure Pa
tp Total Precipitation kg/m^2
crain Categorical Rain 0 - No rain, 1 - Drizzle, 2 - Light rain, 3 - Moderate rain, 4 - Heavy rain, 5 - Violent rain
tstm Thunderstorm probability More than 0 - Thunderstorms unlikely, 0 to -4 - Thunderstorms probable, less than -6 - Violent thunderstorms, tornadoes possible
hcy High cloud layer %
lcy Low cloud layer %
mcy Middle cloud layer %
vis Visibility m
aptmp Apparent temperature °C
cpofp Percent frozen precipitation %
dswrf Downward short wave radiation flux W/m^2
prmsl Pressure Reduced to MSL Pa
tdmax Maximum temperature for the current day °C
tdmin Minimum temperature for the current day °C
speed* Wind speed on * meters m/s
degree* Wind degree on * meters Deg

Description:

The Global Forecast System (GFS) climate model is used to build the weather forecasts. With a spatial resolution of 0.25 degrees. The time resolution for the next 72 hours is 1 hour, and further, up to 384 hours - 3 hours. The GFS model is updated four times a day (00:00, 06:00, 12:00 and 18:00 UTC). All forecasts are provided by the UTC timestamp from the current timestamp for a period of up to 16 days.

To obtain the weather forecast using this API, you must make a request for the URL using the GET method with the required parameters containing the required coordinates and the required timestamp. As a result, the response will be returned as a string in JSON format containing a list of heights and data related to these heights.

Parameters:

lat - Latitude, separator is a dot
lon - Longitude, separator is a dot
datetime - Time in the format YYYYmmddHHii. Where YYYY is the year, mm is the month, dd is the day, HH is the Hour, ii is the minute

 

Example of API call:

https://gridforecast.com/api/forecast/lat;lon/datetime
https://gridforecast.com/api/forecast/49.8479;35.6541/201912151100

 

Example of API response:

{
  "height of meters above ground":{"parameter":value,"parameter":value,"parameter":value}
}

{
  "0":{"vis":24100,"gust":1.32,"hindex":2,"sp":99447,"orog":175.9,"t":5.2,"sdwe":0,"sde":0,"pevpr":20.98,"cpofp":-50,"cprat":0,"prate":0,"tp":0,"acpcp":0,"watr":0.2,"csnow":0,"cicep":0,"cfrzr":0,"crain":0,"lhtfl":6.70,"shtfl":12.2,"gflux":-49.92,"uflx":0.012,"vflx":0.01,"u-gwd":-0.00004,"v-gwd":0.0003,"wilt":0.066,"fldcp":0.29,"SUNSD":21600,"lftx":11.68,"cape":1,"cin":-0.05,"dswrf":160,"dlwrf":258.83,"uswrf":21,"ulwrf":331.003,"4lftx":9.94,"hpbl":351.42,"lsm":1,"ci":0,"al":12.84,"landn":1,"latitude":49.75,"longitude":35.75,"distance":"12.88 Km"},
  "2":{"q":0.004,"2d":2,"2r":83.7,"aptmp":3.9,"tmax":4.5,"tmin":1,"t":4.5},
  "10":{"speed":1.1,"degree":194},
  "80":{"t":3.6,"q":0.004,"pres":98475,"speed":1.3,"degree":196},
  "100":{"t":3.4,"speed":1.3,"degree":197},
  "125":{"gh":336.528,"t":2.7,"r":91.1,"w":0.022,"absv":0.00008,"clwmr":0,"speed":1.3,"degree":199,"isobaricInhPa":975},
  "375":{"gh":546.08,"t":1,"r":99.3,"w":0.03,"absv":0.00008,"clwmr":0.00005,"ICSEV":0,"speed":1.2,"degree":209,"isobaricInhPa":950},
  "575":{"gh":760.44,"t":0.6,"r":92.6,"w":0.042,"absv":0.000051,"clwmr":0,"speed":1,"degree":262,"isobaricInhPa":925},
  "825":{"gh":980.093,"t":-0.4,"r":90.3,"w":0.051,"absv":0.00005,"clwmr":0,"ICSEV":1,"speed":0.8,"degree":302,"isobaricInhPa":900},
  "1275":{"gh":1435.717937,"t":-2.1,"r":69.9,"w":0.10649121,"absv":0.00007,"clwmr":0,"ICSEV":0,"speed":0.6,"degree":316,"isobaricInhPa":850},
  "1654":{"t":-3.2,"speed":1.2,"degree":336},
  "1775":{"gh":1916.19,"t":-3.5,"r":54.5,"w":0.129,"absv":0.00008,"clwmr":0,"ICSEV":0,"speed":1.3,"degree":343,"isobaricInhPa":800},
  "2275":{"gh":2424,"t":-5.3,"r":43.6,"w":0.14,"absv":0.000094,"clwmr":0,"ICSEV":0,"speed":1.5,"degree":0,"isobaricInhPa":750},
  "2568":{"t":-6.9,"speed":1.3,"degree":5},
  "2825":{"gh":2963.01,"t":-8,"r":36.3,"w":0.195,"absv":0.00009,"clwmr":0,"ICSEV":0,"speed":1,"degree":13,"isobaricInhPa":700},
  "3000":{"hlcy":-13.25},
  "3425":{"gh":3534,"t":-11.4,"r":35.7,"w":0.23,"absv":0,"clwmr":0,"ICSEV":0,"speed":1.2,"degree":29,"isobaricInhPa":650},
  "3483":{"t":-12.3,"speed":1.3,"degree":30},
  "4025":{"gh":4143.47,"t":-15.7,"r":34.1,"w":0.2432,"absv":0.0001,"clwmr":0,"ICSEV":0,"speed":1.4,"degree":34,"isobaricInhPa":600},
  "4675":{"gh":4792.7495,"t":-20.5,"r":27.4,"w":0.2418,"absv":0.00021,"clwmr":0,"ICSEV":0,"speed":3.2,"degree":180,"isobaricInhPa":550},
  "5375":{"gh":5491.95,"t":-24.4,"r":13.7,"w":0.285,"absv":0.00027,"clwmr":0,"ICSEV":0,"5wavh":5482.57,"speed":13.5,"degree":192,"isobaricInhPa":500},
  "6000":{"ustm":-7.82,"vstm":0.46},
  "6175":{"gh":6252.763,"t":-28.9,"r":14.8,"w":0.418,"absv":0.00017,"clwmr":0,"ICSEV":0,"speed":21.9,"degree":195,"isobaricInhPa":450},
  "7025":{"gh":7084.78,"t":-34.9,"r":27.1,"w":0.412,"absv":0.00006805,"clwmr":0,"ICSEV":0,"o3mr":0.00000009,"speed":26.9,"degree":193,"isobaricInhPa":400},
  "7975":{"gh":8003.092,"t":-41.5,"r":45.7,"w":0.292,"absv":0.000037,"clwmr":0,"ICSEV":0,"o3mr":0.00000009,"speed":32.1,"degree":189,"isobaricInhPa":350},
  "8975":{"gh":9031.4218,"t":-48.9,"r":68.6,"w":0.211,"absv":0.00002138,"clwmr":0,"ICSEV":0,"o3mr":0.00000009,"speed":37.3,"degree":185,"isobaricInhPa":300},
  "10225":{"gh":10208.418,"t":-55.2,"r":53.3,"w":0.115,"absv":0.0001,"clwmr":0,"ICSEV":0,"o3mr":0.00000022,"speed":30.7,"degree":181,"isobaricInhPa": 250}
}

Parameters response:

2r  2 metre relative humidity    
4lftx  Best (4 layer) lifted index  
5wavh  5 wave geopotential height gpm   
absv  Absolute vorticity 1/s   
acpcp  Convective precipitation (water) kg/m^2   
al   Albedo (diffuse reflectivity of a surface)  
aptmp  Apparent temperature    
cape  Convective available potential energy J/kg   
cfrzr  Categorical freezing rain (yes=1; no=0)  
ci  Sea ice area fraction (0 - 1)    
cicep  Categorical ice pellets  
cin  Convective inhibition J/kg   
clwmr  Cloud mixing ratio kg/kg   
cpofp  Percent frozen precipitation  
cprat  Convective precipitation rate kg/m^2/s   
crain  Categorical rain  
csnow  Categorical snow  
cwat  Cloud water kg/m^2   
cwork  Cloud work function J/kg  The cloud work function, which is an integral measure of the buoyancy force in the clouds
degree  Wind degree Deg  
dlwrf  Downward long wave radiation flux W/m^2   
dswrf  Downward short wave radiation flux W/m^2   
fldcp  Field Capacity  Fraction   
gflux  Ground heat flux W/m^2   
gh  Geopotential Height gpm   
gust  Wind speed (gust) m/s   
hcy  High cloud layer Pa   
hindex  Haines Index Numeric   
hlcy  Storm relative helicity m^2/s^2   
hpbl  Planetary boundary layer height  
icaht  ICAO Standard Atmosphere reference height  
ICSEV  Icing severity non-dim   
isobaricInhPa  Pressure isobaric Pa   
landn  Land-sea coverage (nearest neighbor) [land=1 land=1,sea=0    
lcy  Low cloud layer Pa   
lftx  Surface lifted index  
lhtfl  Latent heat net flux W/m^2   
lsm  Land-sea mask    
mcy  Middle cloud layer Pa   
mslet  MSLP (Eta model reduction) Pa   
o3mr  Ozone mixing ratio kg/kg   
orog  Orography  
pevpr  Potential evaporation rate W/m^2   
plpl  Pressure of level from which parcel was lifted  Pa   
prate  Precipitation rate kg/m^2/s   
pres  Pressure Pa   
prmsl  Pressure reduced to MSL Pa   
pt  Potential temperature  
pwat  Precipitable water kg/m^2   
Specific humidity kg/kg   
Relative humidity  
sde  Snow depth  
sdwe  Water equivalent of accumulated snow depth kg/m^2   
shtfl  Sensible heat net flux W/m^2   
soilw  Volumetric soil moisture content Fraction   
sp  Surface pressure Pa   
speed  Wind speed m/s   
st  Soil Temperature  
sunsd  Sunshine Duration  
Temperature  
tcc  Total Cloud Cover  
tmax  Maximum temperature  
tmin  Minimum temperature  
tozne  Total ozone DU   
tp  Total Precipitation kg/m^2   
uflx  Momentum flux N/m^2   
u-gwd   Zonal flux of gravity wave stress N/m^2   
ulwrf  Upward long wave radiation flux W/m^2   
ustm  U component storm motion m/s   
uswrf  Upward short wave radiation flux W/m^2   
vflx  Momentum flux N/m^2   
v-gwd  Meridional flux of gravity wave stress N/m^2   
vis  Visibility  
VRATE  Ventilation Rate m^2/s   
vstm  V component storm motion m/s   
vwsh  Vertical speed shear 1/s   
Vertical velocity Pa/s   
watr  Water runoff kg/m^2   
wilt  Wilting Point Fraction