Ag-Weather Forecast API

This API returns an 8 day forecast for weather data specific to the Agriculture industry. With this API, you can retrieve forecasted soil temperature, soil moisture, evapotranspiration, and more!

This API is available to the following plans (See: pricing):

  • Advanced plan
  • Agweather API plan

All parameters should be supplied to the Weather API as query string parameters.

Base URL

HTTP: http://api.weatherbit.io/v2.0/forecast/agweather
HTTPS: https://api.weatherbit.io/v2.0/forecast/agweather
Supported Methods: GET

Request Parameters

key=[key] (REQUIRED)
  • key - Your API Key.
units=[units](optional)
  • M - [DEFAULT] Metric (Celcius, m/s, mm)
  • S - Scientific (Kelvin, m/s, mm)
  • I - Fahrenheit (F, mph, in)
callback=[function] (optional: JSON-P callback)

API Endpoints

Description Required Parameters Example(s)
Get data by lat/lon lat, lon &lat=38.123&lon=-78.543

Example Request:

https://api.weatherbit.io/v2.0/forecast/agweather?lat=38.0&lon=-78.0&key={API_KEY}

Example Response (JSON):


        {
           "data":[
              {
                 "date":"2018-01-02",
                 "bulk_soil_density":1390,
                 "skin_temp_max":34.5,
                 "skin_temp_avg":26.5,
                 "skin_temp_min":13.5,
                 "temp_2m_avg":22.1,
                 "precip":0,
                 "specific_humidity":0.0032899952493608,
                 "evapotranspiration":0.925,
                 "pres_avg":918.072,
                 "wind_10m_spd_avg":2.877,
                 "dlwrf_avg":350.53,
                 "dlwrf_max":600.53,
                 "dswrf_avg":473.555,
                 "dswrf_max":870.555,
                 "dswrf_net":-23.408,
                 "dlwrf_net":416.075,
                 "soilm_0_10cm":14.804,
                 "soilm_10_40cm":53.016,
                 "soilm_40_100cm":112.557,
                 "soilm_100_200cm":200.732,
                 "v_soilm_0_10cm":0.148,
                 "v_soilm_10_40cm":0.177,
                 "v_soilm_40_100cm":0.188,
                 "v_soilm_100_200cm":0.201,
                 "soilt_0_10cm":19.9,
                 "soilt_10_40cm":15,
                 "soilt_40_100cm":14.2,
                 "soilt_100_200cm":14.6
              } ... 
           ],
           "lat":34.035,
           "lon":-117.846191
        }

        

Field Decriptions:

  • lat: Latitude (Degrees).
  • lon: Longitude (Degrees).
  • data: [
    • valid_date: Date (YYYY-MM-DD).
    • bulk_soil_density: Bulk Soil Density (kg/m^3).
    • skin_temp_max: Max skin temperature (C).
    • skin_temp_avg: Average skin temperature (C).
    • skin_temp_min: Min skin temperature (C).
    • temp_2m_avg: 2 meter temperature (C).
    • precip: Accumulated precipitation (mm).
    • specific_humidity: Average specific humidity (kg/kg).
    • evapotranspiration: Accumulated evapotranspiration (mm).
    • pres_avg: Surface pressure (mb).
    • wind_10m_spd_avg: 10 meter wind speed (m/s).
    • dlwrf_avg: Average downward long-wave solar radiation (W/m^2).
    • dlwrf_max: Maximum downward long-wave solar radiation (W/m^2).
    • dswrf_avg: Average downward short-wave solar radiation (W/m^2).
    • dswrf_max: Maximum downward short-wave solar radiation (W/m^2).
    • dlwrf_net: Net longwave solar radiation (W/m^2).
    • dswrf_net: Net shortwave solar radiation (W/m^2).
    • soilm_0_10cm: Soil moisture content 0 to 10 cm depth (mm).
    • soilm_10_40cm: Soil moisture content 10 to 40 cm depth (mm).
    • soilm_40_100cm: Soil moisture content 40 to 100 cm depth (mm).
    • soilm_100_200cm: Soil moisture content 100 to 200 cm depth (mm).
    • v_soilm_0_10cm: Volumetric soil moisture content 0 to 10 cm depth (fraction).
    • v_soilm_10_40cm: Volumetric soil moisture content 10 to 40 cm depth (fraction).
    • v_soilm_40_100cm: Volumetric soil moisture content 40 to 100 cm depth (fraction).
    • v_soilm_100_200cm: Volumetric soil moisture content 100 to 200 cm depth (fraction)
    • soilt_0_10cm: Soil temperature at 0 to 10 cm depth (C).
    • soilt_10_40cm: Soil temperature at 10 to 40 cm depth (C).
    • soilt_40_100cm: Soil temperature at 40 to 100 cm depth (C).
    • soilt_100_200cm: Soil temperature at 100 to 200 cm depth (C).
  • ... ]