Historical Ag-Weather API

This API returns historical weather data specific to the Agriculture industry. With this API, you can retrieve soil temperature, soil moisture, evapotranspiration, and more!

NOTICE: Data is currently only available from Jan 1st, 2017.

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/history/agweather
HTTPS: https://api.weatherbit.io/v2.0/history/agweather
Supported Methods: GET

Request Parameters

key=[key] (REQUIRED)
  • key - Your API Key.
start_date=[YYYY-MM-DD] (REQUIRED)
end_date=[YYYY-MM-DD] (REQUIRED)
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, start_date, end_date &lat=38.123&lon=-78.543&start_date=2018-12-11&end_date=2018-12-12

Example Request:

https://api.weatherbit.io/v2.0/history/agweather?lat=38.0&lon=-78.0&start_date=2018-12-11&end_date=2018-12-12&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,
                 "precip_gpm":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 [gauge based] precipitation (mm).
    • precip_gpm: Accumulated [satellite based] 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).
  • ... ]