{
  "name": "Frost Dates & Planting Zone API",
  "status": "ok",
  "version": "1.0.0",
  "description": "Keyless US gardening data: USDA plant-hardiness zone, average last-spring / first-fall frost dates, frost-free growing-season length, and a frost-anchored planting calendar — from a US ZIP or address.",
  "coverage": {
    "zipCodes": 40502,
    "frostStations": 6517,
    "note": "Every US ZIP with a 2023 USDA hardiness zone; ~99% also carry NOAA frost dates from a nearest station with a distance-based confidence label."
  },
  "endpoints": {
    "/frost-dates": {
      "method": "GET",
      "params": {
        "zip": "US ZIP (optional)",
        "address": "US address (optional)"
      },
      "note": "Provide zip OR address.",
      "example": "/frost-dates?zip=20500"
    },
    "/planting-calendar": {
      "method": "GET",
      "params": {
        "zip": "US ZIP (optional)",
        "address": "US address (optional)",
        "crop": "optional crop key (27 supported)",
        "year": "optional reference year"
      },
      "note": "Omit crop for the full-garden calendar.",
      "example": "/planting-calendar?zip=20500&crop=tomato",
      "crops": [
        "tomato",
        "pepper",
        "eggplant",
        "cucumber",
        "zucchini",
        "wintersquash",
        "pumpkin",
        "beans",
        "corn",
        "melon",
        "basil",
        "okra",
        "sweetpotato",
        "peas",
        "spinach",
        "lettuce",
        "kale",
        "broccoli",
        "cabbage",
        "cauliflower",
        "onion",
        "carrot",
        "beet",
        "radish",
        "chard",
        "potato",
        "turnip"
      ]
    },
    "/health": {
      "method": "GET",
      "note": "Same as this document; returns status ok."
    }
  },
  "dataSources": {
    "hardinessZone": "2023 USDA Plant Hardiness Zone Map, ZIP listing published by PRISM Climate Group, Oregon State University (public / freely reproducible).",
    "frostDates": "NOAA/NCEI 1991–2020 U.S. Climate Normals — annual/seasonal freeze/frost normals (public domain).",
    "geocoding": "U.S. Census geocoder + 2023 Census ZCTA Gazetteer centroids (public domain)."
  },
  "docs": "/api-docs.html"
}