models.json returns the forecast from named weather models side by side, and ensemble ranges that show how sure the forecast is:
NOAA GFS and ECMWF IFS (open data) as they come from each model, and the 10th, 50th and 90th percentiles from the NOAA GEFS ensemble
(31 members). Use it to compare models, to show a range instead of one number, or to plan for the worst case.
Values are raw model output on a 0.5° grid (about 55 km), every 3 hours to 6 days and every 6 hours to 10 days: temperature,
wind, gust (where the model has it) and precipitation over each period. Percentiles are estimated from the ensemble mean and spread
(a normal approximation; precipitation never below 0). For a forecast tuned to the location, use forecast.json.
Available on Business plan and above. Keys on other plans receive error code 2009. Each request counts as one API call.
Example request
https://api.weatherapi.com/v1/models.json?key=<YOUR_API_KEY>&q=Chicago&models=gfs,ecmwf,gefs&days=5
Request parameters
| Parameter | Required | Description |
|---|
| key | Yes | Your API key. |
| q | Yes | Location. |
| models | No | Comma-separated: gfs, ecmwf, gefs (the ensemble ranges). Default all three. |
| days | No | 1 to 10. Default 3. |
Response
models.list: one entry per model with id, name, run (yyyyMMddHH, UTC) and run_epoch, and hours: time_epoch, time (local), temp_c, wind_kph, gust_kph, precip_mm and period_hours (the precipitation period).
models.ensemble: the GEFS run and hours with temp_c, wind_kph and precip_mm, each as p10, p50 and p90.
A model whose run isn't available yet has available: false.
Attribution: "NOAA GFS and GEFS; ECMWF open data (CC BY 4.0)".