Forecast

Endpointhttps://api.precip.ai

Single-call weather forecast with hourly and daily values

Weather Forecast

GET

https://api.precip.ai

/api/v1/forecast

A single call forecast for one location: hourly temperature, feels-like temperature, precipitation amount, type and probability, wind, cloud cover, humidity, UV index, air quality and frost probability, plus daily highs, lows and totals.

Hours before now carry the observed analysis for temperature, precipitation and precipitation type. Later hours are the forecast, out to 10 days.

Defaults are Celsius and millimeters.

Weather Forecast › query Parameters

latitude

number · min: -90 · max: 90 · required

Latitude (WGS84). One location per request.

Default: 37.7575

longitude

number · min: -180 · max: 180 · required

Longitude (WGS84). One location per request.

Default: -122.42616

forecast_hours

integer · min: 1 · max: 252

Hours of forecast from the current hour. Default 168 (7 days), maximum 252.

Default: 168

past_hours

integer · min: 0 · max: 744

Hours of observed history before the current hour. Default 24, so today's daily values cover the whole day. For longer history, use the hourly and daily endpoints.

Default: 24

temperature_unit

string · enum

Unit for temperature, apparent_temperature and dailyTemps.

Enum values:

celsius

fahrenheit

Default: celsius

precipitation_unit

string · enum

Unit for precipitation amounts. With mm, snowfall is in cm. With inch, all amounts and snowfall are in inches.

Enum values:

inch

Default: mm

timeZoneId

string

IANA timezone for the hour labels and the daily boundaries, e.g. America/Chicago. Defaults to the timezone of the location.

Weather Forecast › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Weather Forecast › Responses

Successful Response

Daily maps are keyed by local date (`YYYY-MM-DD`). The first and last days only cover the hours in the request window.

object[]

object

Daily low and high temperature

Example: {"2026-10-20":{"min":5.9,"max":14.9}}

object

Daily precipitation total.

Example: {"2026-10-20":3.2}

object

Highest hourly chance of precipitation in the day (0-100 %)

Example: {"2026-10-20":70}

object

Daily low and high relative humidity (%)

object

Highest UV index in the day

GET/api/v1/forecast

curl --request GET \
  --url 'https://api.precip.ai/api/v1/forecast?latitude=37.7575&longitude=-122.42616' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "hourly": [
    {
      "time": "1 PM",
      "startTime": "2026-10-19T17:00Z",
      "temperature": 0,
      "apparent_temperature": 0,
      "precip": 0,
      "rain": 0,
      "snow_liquid": 0,
      "snowfall": 0,
      "slr": 10,
      "precip_type": "none",
      "precip_probability": 0,
      "weathercode": 0,
      "is_day": 0,
      "wind_speed": 0,
      "wind_speed_gust": 0,
      "wind_direction": 0,
      "cloud_cover": 0,
      "relative_humidity": 0,
      "uv_index": 0,
      "us_aqi": 0,
      "frost_probability_36f": 0,
      "frost_probability_32f": 0,
      "frost_probability_28f": 0
    }
  ],
  "dailyTemps": {
    "2026-10-20": {
      "min": 5.9,
      "max": 14.9
    }
  },
  "dailyPrecip": {
    "2026-10-20": 3.2
  },
  "dailyPoP": {
    "2026-10-20": 70
  },
  "dailyHumidity": {
    "key": {
      "min": 0,
      "max": 0
    }
  },
  "dailyUv": {
    "key": 0
  }
}

json

application/json

Precipitation Data

Precipitation & Weather Data API

Forecast

Endpointhttps://api.precip.ai

Single-call weather forecast with hourly and daily values

Weather Forecast

GET

https://api.precip.ai

/api/v1/forecast

Hours before now carry the observed analysis for temperature, precipitation and precipitation type. Later hours are the forecast, out to 10 days.

Defaults are Celsius and millimeters.

Weather Forecast › query Parameters

latitude

number · min: -90 · max: 90 · required

Latitude (WGS84). One location per request.

Default: 37.7575

longitude

number · min: -180 · max: 180 · required

Longitude (WGS84). One location per request.

Default: -122.42616

forecast_hours

integer · min: 1 · max: 252

Hours of forecast from the current hour. Default 168 (7 days), maximum 252.

Default: 168

past_hours

integer · min: 0 · max: 744

Hours of observed history before the current hour. Default 24, so today's daily values cover the whole day. For longer history, use the hourly and daily endpoints.

Default: 24

temperature_unit

string · enum

Unit for temperature, apparent_temperature and dailyTemps.

Enum values:

celsius

fahrenheit

Default: celsius

precipitation_unit

string · enum

Unit for precipitation amounts. With mm, snowfall is in cm. With inch, all amounts and snowfall are in inches.

Enum values:

inch

Default: mm

timeZoneId

string

IANA timezone for the hour labels and the daily boundaries, e.g. America/Chicago. Defaults to the timezone of the location.

Weather Forecast › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Weather Forecast › Responses

Successful Response

Daily maps are keyed by local date (`YYYY-MM-DD`). The first and last days only cover the hours in the request window.

object[]

object

Daily low and high temperature

Example: {"2026-10-20":{"min":5.9,"max":14.9}}

object

Daily precipitation total.

Example: {"2026-10-20":3.2}

object

Highest hourly chance of precipitation in the day (0-100 %)

Example: {"2026-10-20":70}

object

Daily low and high relative humidity (%)

object

Highest UV index in the day

GET/api/v1/forecast

curl --request GET \
  --url 'https://api.precip.ai/api/v1/forecast?latitude=37.7575&longitude=-122.42616' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "hourly": [
    {
      "time": "1 PM",
      "startTime": "2026-10-19T17:00Z",
      "temperature": 0,
      "apparent_temperature": 0,
      "precip": 0,
      "rain": 0,
      "snow_liquid": 0,
      "snowfall": 0,
      "slr": 10,
      "precip_type": "none",
      "precip_probability": 0,
      "weathercode": 0,
      "is_day": 0,
      "wind_speed": 0,
      "wind_speed_gust": 0,
      "wind_direction": 0,
      "cloud_cover": 0,
      "relative_humidity": 0,
      "uv_index": 0,
      "us_aqi": 0,
      "frost_probability_36f": 0,
      "frost_probability_32f": 0,
      "frost_probability_28f": 0
    }
  ],
  "dailyTemps": {
    "2026-10-20": {
      "min": 5.9,
      "max": 14.9
    }
  },
  "dailyPrecip": {
    "2026-10-20": 3.2
  },
  "dailyPoP": {
    "2026-10-20": 70
  },
  "dailyHumidity": {
    "key": {
      "min": 0,
      "max": 0
    }
  },
  "dailyUv": {
    "key": 0
  }
}

json

application/json

Precipitation Data