---
title: "Agriculture"
method: GET
path: "/agriculture.json"
tags: ["Agriculture"]
---

# Agriculture

`GET /agriculture.json`

## Request

- Base URL: `https://api.weatherapi.com/v1`
- URL: `https://api.weatherapi.com/v1/agriculture.json`
- Auth: API key in query parameter `key`

Farming indicators for up to 14 days: growing degree days, rain, ET0 and crop water use, water balance, chill/frost/heat stress hours, leaf wetness, disease risk, Smith Periods and hourly spray windows, with optional season-to-date totals. Business plan and above; other plans get 403 / error 2009. Invalid parameters return 400 with error 1012 (crop) or 1013 (other parameters).

## Query parameters

- `key` string, required
- `q` string, required
- `days` integer
- `crop` 'wheat' | 'barley' | 'maize' | 'corn' | 'soybean' | 'potato' | 'rice' | 'cotton' | 'tomato' | 'sunflower' | 'grape' | 'none'
- `gdd_base` number
- `gdd_upper` number
- `kc` number
- `heat_threshold` number
- `season_start` string, date

## Response `200`

Agriculture indicators

- AgricultureResponse
  - `location` Location: Location metadata returned with every weather response.
    - `name` string: Location name
    - `region` string: Region or state
    - `country` string: Country name
    - `lat` number, float: Latitude
    - `lon` number, float: Longitude
    - `tz_id` string: IANA timezone ID, e.g. Europe/London
    - `localtime_epoch` integer: Local time as Unix epoch
    - `localtime` string: Local date and time string
  - `crop` AgriCrop: Crop values used, including defaults.
    - `name` string
    - `gdd_base` number: GDD base temperature °C
    - `gdd_upper` number: GDD upper cut-off °C
    - `kc` number: Crop coefficient
    - `heat_threshold` number: Heat stress threshold °C
  - `season` AgriSeason
    - `start` string, date
    - `end` string, date
    - `days` integer
    - `gdd` number: Season GDD
    - `rain_mm` number: Rain mm
    - `et0_mm` number: ET0 mm
    - `etc_mm` number: Crop water use mm
    - `water_balance_mm` number: Rain minus ETc mm
  - `forecast` object
    - `forecastday` AgriForecastDay[]
      - `date` string, date
      - `date_epoch` integer
      - `day` AgriDay
        - `maxtemp_c` number: Max temperature °C
        - `mintemp_c` number: Min temperature °C
        - `gdd` number: Growing degree days
        - `gdd_cumulative` number: Season GDD plus forecast so far
        - `rain_mm` number: Rain mm
        - `et0_mm` number: ET0 mm
        - `etc_mm` number: Crop water use mm
        - `water_balance_mm` number: Rain minus ETc mm
        - `chill_hours` number: Hours 0-7.2 °C
        - `frost_hours` number: Hours <= 0 °C
        - `hard_frost_hours` number: Hours <= -2 °C
        - `heat_stress_hours` number: Hours >= heat_threshold
        - `leaf_wet_hours` number: Hours with wet leaves
        - `disease_risk` 'low' | 'moderate' | 'high'
        - `smith_period` 0 | 1
        - `spray_good_hours` number: Good spray hours
        - `spray_marginal_hours` number: Marginal spray hours
        - `soil` object: Enterprise only
          - `soil_temp_5cm` number: °C
          - `soil_moisture_5cm` number: m³/m³
          - `soil_moisture_25cm` number: m³/m³
          - `paw` number: Plant-available water
          - `workable_hours` number: Hours the soil is workable
      - `hour` AgriHour[]
        - `time_epoch` integer
        - `time` string
        - `period_hours` number: 1 to day 5, 3 after
        - `temp_c` number: °C
        - `humidity` number: %
        - `dewpoint_c` number: °C
        - `wind_kph` number: kph
        - `gust_kph` number: kph
        - `precip_mm` number: mm
        - `et0_mm` number: mm
        - `etc_mm` number: mm
        - `delta_t` number: Delta-T °C
        - `leaf_wet` 0 | 1
        - `spray` 'good' | 'marginal' | 'poor'
        - `spray_reason` '' | 'rain' | 'wind' | 'evaporation' | 'temperature' | 'inversion_risk' | 'high_humidity'

## Other responses

- `400`: Bad request — invalid parameter or location not found.
- `401`: Unauthorized — API key missing or invalid.
- `403`: Forbidden — API key quota exceeded, disabled, or plan does not include this resource.

## Changes

- **2026-10-17** `d6aef06554f3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/weatherapi/apis/weatherapi-com/changes/agriculture.json/get.md)

---

[API](https://skmtc.dev/weatherapi/apis/weatherapi-com.md) - [All operations](https://skmtc.dev/weatherapi/apis/weatherapi-com/llms.txt) - [OpenAPI document](https://skmtc.dev/weatherapi/apis/weatherapi-com/revisions/26c06925a7e0?raw)