Joel's APIs

A collection of useful APIs for developers and data enthusiasts.

Frost Date API

Get frost date predictions for any US location based on NOAA Climate Normals data. Returns first and last frost dates with probability percentages to help with garden planning and agricultural decisions.

Endpoint

GET apis.joelgrant.dev/api/v1/frost/{zip_code}

Example Request

curl --location 'apis.joelgrant.dev/api/v1/frost/68923'

Response Format

{
  "zip_code": "68923",
  "data": {
    "zip_code": "68923",
    "location": {
      "city": "Atlanta",
      "state": "NE",
      "latitude": 40.35909,
      "longitude": -99.46833
    },
    "weather_station": {
      "station_id": "USC00253910",
      "name": "HOLDREGE, NE US",
      "latitude": 40.4517,
      "longitude": -99.3803,
      "distance_km": 12.71
    },
    "frost_dates": {
      "first_frost_32f": {
        "10%": "09/28",
        "20%": "10/01",
        "30%": "10/05",
        "40%": "10/08",
        "50%": "10/11",
        "60%": "10/13",
        "70%": "10/16",
        "80%": "10/19",
        "90%": "10/22"
      },
      "last_frost_32f": {
        "10%": "05/15",
        "20%": "05/10",
        "30%": "05/07",
        "40%": "05/04",
        "50%": "05/02",
        "60%": "04/30",
        "70%": "04/27",
        "80%": "04/23",
        "90%": "04/17"
      }
    }
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2025-08-22T22:53:14Z",
    "data_source": "NOAA Climate Normals 1991-2020"
  }
}

How It Works

  • Location Lookup: Uses zip code to find the exact coordinates and nearest weather station
  • Climate Data: Pulls from NOAA Climate Normals 1991-2020 dataset for historical accuracy
  • Probability Calculations: Returns frost dates at different probability levels (10% = earliest likely, 90% = latest likely)
  • First Frost: Probability of first 32°F temperature in fall/winter
  • Last Frost: Probability of last 32°F temperature in spring

Perfect for: Garden planning, agricultural timing, outdoor event scheduling, and climate research.

Try It Now

Test the API using our interactive Postman collection:

📋 Interactive Postman Collection

Test the API with our pre-configured Postman collection including example requests and different ZIP codes.

🚀 Open Postman Collection
Quick Test with cURL:
curl "https://apis.joelgrant.dev/api/v1/frost/68923"

Replace 68923 with any US ZIP code

💡 About the Postman Collection:
• Pre-configured with example ZIP codes and requests
• Full interactive documentation and testing interface
• Copy requests to your own Postman workspace
• Perfect for developers exploring the API

Data Attribution

Frost date predictions are based on historical climate data from the National Oceanic and Atmospheric Administration (NOAA).

Data Source: NOAA Climate Normals 1991-2020
U.S. Climate Normals provide a 30-year average of temperature, precipitation, and other climate variables for weather stations across the United States.

Joel's APIs

A collection of useful APIs for developers and data enthusiasts.

Frost Date API

Get frost date predictions for any US location based on NOAA Climate Normals data. Returns first and last frost dates with probability percentages to help with garden planning and agricultural decisions.

Endpoint

GET apis.joelgrant.dev/api/v1/frost/{zip_code}

Example Request

curl --location 'apis.joelgrant.dev/api/v1/frost/68923'

Response Format

{
  "zip_code": "68923",
  "data": {
    "zip_code": "68923",
    "location": {
      "city": "Atlanta",
      "state": "NE",
      "latitude": 40.35909,
      "longitude": -99.46833
    },
    "weather_station": {
      "station_id": "USC00253910",
      "name": "HOLDREGE, NE US",
      "latitude": 40.4517,
      "longitude": -99.3803,
      "distance_km": 12.71
    },
    "frost_dates": {
      "first_frost_32f": {
        "10%": "09/28",
        "20%": "10/01",
        "30%": "10/05",
        "40%": "10/08",
        "50%": "10/11",
        "60%": "10/13",
        "70%": "10/16",
        "80%": "10/19",
        "90%": "10/22"
      },
      "last_frost_32f": {
        "10%": "05/15",
        "20%": "05/10",
        "30%": "05/07",
        "40%": "05/04",
        "50%": "05/02",
        "60%": "04/30",
        "70%": "04/27",
        "80%": "04/23",
        "90%": "04/17"
      }
    }
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2025-08-22T22:53:14Z",
    "data_source": "NOAA Climate Normals 1991-2020"
  }
}

How It Works

Perfect for: Garden planning, agricultural timing, outdoor event scheduling, and climate research.

Try It Now

Test the API directly in your browser using this interactive Postman collection:

📋 Interactive Postman Collection

Test the API with our pre-configured Postman collection including example requests and different ZIP codes.

Open Postman Collection
Quick Test with cURL:
curl "https://apis.joelgrant.dev/api/v1/frost/68923"

Replace 68923 with any US ZIP code

� Interactive Collection: The Postman collection should load above. If you see a "refused to connect" error, you can open it in a new tab for the full interactive experience.

Data Attribution

Frost date predictions are based on historical climate data from the National Oceanic and Atmospheric Administration (NOAA).

Data Source: NOAA Climate Normals 1991-2020
U.S. Climate Normals provide a 30-year average of temperature, precipitation, and other climate variables for weather stations across the United States.