Agriculture

Field-level parameters for growing decisions: reference evapotranspiration (ET0), vapour pressure deficit (VPD) and downward surface solar radiation (SSRD), plus lower and upper bound estimates for 24-hour and 7-day precipitation totals. Available hourly and daily.

Get an API key OpenAPI spec for AI assistantsJSON · 105 KB

Full API reference — quickstart, authentication, request limits and attribution.

Field-level parameters for growing decisions: reference evapotranspiration (ET0), vapour pressure deficit (VPD) and downward surface solar radiation (SSRD), plus lower and upper bound estimates for 24-hour and 7-day precipitation totals. Available hourly and daily.

Agriculture Operations
GET/api/v1/agriculture/forecast/hourly/{location}GET/api/v1/agriculture/forecast/daily/{location}

Endpoints

Hourly

Hourly agricultural forecast parameters.

Path Parameters

locationType: stringrequired

"Longitude,latitude" or location identifier (id) from the location endpoint

Query Parameters

periodsType: string

Number of time steps (default 24, maximum 168)

tzType: string

Time zone in response (IANA time zone database names)

GET/api/v1/agriculture/forecast/hourly/{location}Shell Curl
curl 'https://weatherapi.foreca.net/api/v1/agriculture/forecast/hourly/{location}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
200
{
  "forecast": [
    {
      "time": "2022-02-03T10:00+02:00",
      "ET0": 0.1,
      "VPD": 0.27,
      "SSRD": 300
    }
  ]
}
{
  "type": "object",
  "properties": {
    "forecast": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "time": {
            "type": "string",
            "example": "2022-02-03T10:00+02:00",
            "description": "ISO 8601 date and time"
          },
          "ET0": {
            "type": "number",
            "example": 0.1,
            "description": "Reference evapotranspiration rate (mm/h)"
          },
          "VPD": {
            "type": "number",
            "example": 0.27,
            "description": "Vapor pressure deficit (kPa)"
          },
          "SSRD": {
            "type": "number",
            "example": 300,
            "description": "Surface solar radiation downwards, W/m² (watts per square meter)"
          }
        }
      }
    }
  }
}
Success

Daily

Daily agricultural forecast parameters.

Path Parameters

locationType: stringrequired

"Longitude,latitude" or location identifier (id) from the location endpoint

Query Parameters

periodsType: string

Number of time steps (default 7, maximum 14)

GET/api/v1/agriculture/forecast/daily/{location}Shell Curl
curl 'https://weatherapi.foreca.net/api/v1/agriculture/forecast/daily/{location}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
200
{
  "forecast": [
    {
      "date": "2022-02-03",
      "ET0": 1.18,
      "VPD_max": 0.5,
      "VPD_min": 0.05,
      "VPD": 0.18,
      "SSRD": 2424,
      "precipSum24q10": 0.11,
      "precipSum24q90": 0.21,
      "precipSum168q10": 7.4,
      "precipSum168q90": 20.73
    }
  ]
}
{
  "type": "object",
  "properties": {
    "forecast": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "example": "2022-02-03",
            "description": "ISO 8601 date"
          },
          "ET0": {
            "type": "number",
            "example": 1.18,
            "description": "Reference evapotranspiration (mm)"
          },
          "VPD_max": {
            "type": "number",
            "example": 0.5,
            "description": "Maximum vapor pressure deficit (kPa)"
          },
          "VPD_min": {
            "type": "number",
            "example": 0.05,
            "description": "Minimum vapor pressure deficit (kPa)"
          },
          "VPD": {
            "type": "number",
            "example": 0.18,
            "description": "Vapor pressure deficit average (kPa)"
          },
          "SSRD": {
            "type": "number",
            "example": 2424,
            "description": "Surface solar radiation downwards (24h sum, Wh/m²)"
          },
          "precipSum24q10": {
            "type": "number",
            "example": 0.11,
            "description": "Lower bound estimate for precipitation sum during the day (10th percentile, mm)"
          },
          "precipSum24q90": {
            "type": "number",
            "example": 0.21,
            "description": "Higher bound estimate for precipitation sum during the day (90th percentile, mm)"
          },
          "precipSum168q10": {
            "type": "number",
            "example": 7.4,
            "description": "Lower bound estimate for 7-day precipitation sum during the day and 6 following days (10th percentile, mm)"
          },
          "precipSum168q90": {
            "type": "number",
            "example": 20.73,
            "description": "Higher bound estimate for 7-day precipitation sum during the day and 6 following days (90th percentile, mm)"
          }
        }
      }
    }
  }
}
Success