Precipitation & Weather Data API

Atmospheric Data

Endpointhttps://api.precip.ai

Endpoints for hourly atmospheric variables: temperature, humidity, wind, clouds

Air Temperature

GET

https://api.precip.ai

/api/v1/temperature-hourly

Hourly near-surface air temperature in Celsius (°C)

Air Temperature › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Air Temperature › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Air Temperature › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/temperature-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/temperature-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Specific Humidity

GET

https://api.precip.ai

/api/v1/specific-humidity-hourly

Hourly specific humidity (kg/kg)

Specific Humidity › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Specific Humidity › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Specific Humidity › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/specific-humidity-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/specific-humidity-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Relative Humidity

GET

https://api.precip.ai

/api/v1/relative-humidity-hourly

Hourly relative humidity as a percentage (0-100%)

Relative Humidity › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-01

Default: 2025-10-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-31

Default: 2025-10-31

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Relative Humidity › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Relative Humidity › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/relative-humidity-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/relative-humidity-hourly?start=2025-10-01&end=2025-10-31&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Wind Speed

GET

https://api.precip.ai

/api/v1/wind-speed-hourly

Hourly near-surface wind speed in meters per second (m/s)

Wind Speed › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Wind Speed › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Wind Speed › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/wind-speed-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/wind-speed-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Wind Gusts

GET

https://api.precip.ai

/api/v1/wind-speed-gust-hourly

Hourly wind gust speed in meters per second (m/s)

Wind Gusts › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Wind Gusts › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Wind Gusts › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/wind-speed-gust-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/wind-speed-gust-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Wind Direction

GET

https://api.precip.ai

/api/v1/wind-direction-hourly

Hourly wind direction in compass degrees (0-360)

Wind Direction › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Wind Direction › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Wind Direction › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/wind-direction-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/wind-direction-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Cloud Cover

GET

https://api.precip.ai

/api/v1/cloud-cover-hourly

Hourly cloud cover fraction (0-1, where 0 is clear and 1 is overcast)

Cloud Cover › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-01

Default: 2025-10-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-31

Default: 2025-10-31

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Cloud Cover › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Cloud Cover › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/cloud-cover-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/cloud-cover-hourly?start=2025-10-01&end=2025-10-31&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Solar Radiation

GET

https://api.precip.ai

/api/v1/solar-radiation-hourly

Hourly downward short-wave radiation flux in watts per square meter (W/m²)

Solar Radiation › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-15

Default: 2025-10-15

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-31

Default: 2025-10-31

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Solar Radiation › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Solar Radiation › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/solar-radiation-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/solar-radiation-hourly?start=2025-10-15&end=2025-10-31&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Soil Data Bulk Export

Precipitation & Weather Data API

Atmospheric Data

Endpointhttps://api.precip.ai

Endpoints for hourly atmospheric variables: temperature, humidity, wind, clouds

Air Temperature

GET

https://api.precip.ai

/api/v1/temperature-hourly

Hourly near-surface air temperature in Celsius (°C)

Air Temperature › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Air Temperature › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Air Temperature › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/temperature-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/temperature-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Specific Humidity

GET

https://api.precip.ai

/api/v1/specific-humidity-hourly

Hourly specific humidity (kg/kg)

Specific Humidity › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Specific Humidity › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Specific Humidity › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/specific-humidity-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/specific-humidity-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Relative Humidity

GET

https://api.precip.ai

/api/v1/relative-humidity-hourly

Hourly relative humidity as a percentage (0-100%)

Relative Humidity › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-01

Default: 2025-10-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-31

Default: 2025-10-31

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Relative Humidity › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Relative Humidity › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/relative-humidity-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/relative-humidity-hourly?start=2025-10-01&end=2025-10-31&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Wind Speed

GET

https://api.precip.ai

/api/v1/wind-speed-hourly

Hourly near-surface wind speed in meters per second (m/s)

Wind Speed › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Wind Speed › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Wind Speed › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/wind-speed-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/wind-speed-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Wind Gusts

GET

https://api.precip.ai

/api/v1/wind-speed-gust-hourly

Hourly wind gust speed in meters per second (m/s)

Wind Gusts › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Wind Gusts › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Wind Gusts › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/wind-speed-gust-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/wind-speed-gust-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Wind Direction

GET

https://api.precip.ai

/api/v1/wind-direction-hourly

Hourly wind direction in compass degrees (0-360)

Wind Direction › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Wind Direction › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Wind Direction › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/wind-direction-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/wind-direction-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Cloud Cover

GET

https://api.precip.ai

/api/v1/cloud-cover-hourly

Hourly cloud cover fraction (0-1, where 0 is clear and 1 is overcast)

Cloud Cover › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-01

Default: 2025-10-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-31

Default: 2025-10-31

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Cloud Cover › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Cloud Cover › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/cloud-cover-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/cloud-cover-hourly?start=2025-10-01&end=2025-10-31&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Solar Radiation

GET

https://api.precip.ai

/api/v1/solar-radiation-hourly

Hourly downward short-wave radiation flux in watts per square meter (W/m²)

Solar Radiation › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-15

Default: 2025-10-15

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-10-31

Default: 2025-10-31

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Solar Radiation › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Solar Radiation › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/solar-radiation-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/solar-radiation-hourly?start=2025-10-15&end=2025-10-31&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Soil Data Bulk Export