https://api.darkskyapp.com/v1/forecast/APIKEY/LAT,LON
https://api.darkskyapp.com/v1/brief_forecast/APIKEY/LAT,LON

Returns a forecast for the next hour at a given location. LAT and LON should be in decimal degrees. The brief_forecast call is identical to the forecast call (described below), but omits the timezone, radarStation, hourPrecipitation, and dayPrecipitation fields.

Example

https://api.darkskyapp.com/v1/forecast/d41d8cd98f00b204e9800998ecf8427e/42.7243,-73.6927

Response

{
  "isPrecipitating": true,
  "minutesUntilChange": 25,
  "currentSummary": "rain",
  "hourSummary": "rain will stop in 25 min",
  "daySummary": "likely rain until tonight",
  "currentTemp": 65,
  "timezone": "America/New_York (EDT, -0400)",
  "checkTimeout": 750,
  "radarStation": "enx",

  "hourPrecipitation": [
    { "probability": 1.0,
      "intensity": 15.6,
      "error": 1.0,
      "type": "rain",
      "time": 1325607311 },
    
    { "probability": 0.84,
      "intensity": 12.0,
      "error": 2.34,
      "type": "rain",
      "time": 1325607431 },
      
    { "probability": 0.8,
      "intensity": 20.5,
      "error": 5.1,
      "type": "rain",
      "time": 1325607551 },

    ...
  ],

  "dayPrecipitation": [
    { "probability": 1.0,
      "type": "rain",
      "temp": 65,
      "time": 1325607311 },
      
    { "probability": 0.84,
      "type": "rain",
      "temp": 65,
      "time": 1325610911 },
    
    { "probability": 0.8,
      "type": "rain",
      "temp": 65,
      "time": 1325614511 },

    ...
  ]
}

Response Fields

isPrecipitating
A boolean representing whether it is currently precipitating or not.
minutesUntilChange
The number of minutes until it will start or stop precipitating. If this value is zero, then it means that the number of minutes is not confidently known.
currentSummary
An english language description of the current weather condition.
hourSummary
An english language text summary of the weather over the next hour.
daySummary
An english language text summary of the weather over the next 24 hours. NOTE: this feature is experimental.
currentTemp
The current temperature at this location in degrees Fahrenheit, or null if no data is available.
timezone
A string containing the IANA time zone of the requested latitude and longitude, followed by (in parenthesis) the abbreviated time zone name and the time zone offset from GMT (in [+-]HHMM). (Please note that our database does not take territorial waters into account. If you request a location that is just offshore, you will be given the timezone as if you were in international waters. It is unlikely that this will be off by more than an hour.)
checkTimeout
The number of seconds before you should re-query for the given location to be sure not to miss changes to the current conditions. This is provided solely for your convenience, so you can limit the number of API requests you need to make and be sure not to miss significant weather changes. It is not a rate limit or an expiry.
radarStation
The NEXRAD Station that covers the given location.
hourPrecipitation
An array of precipitation predictions for times over the next hour. Entries are generally spaced a minute or two apart.
dayPrecipitation
An array of lower-resolution precipitation predictions for the next 24 hours, at intervals of an hour. May be empty if no such predictions are available.
probability
The probability of precipitation at the given time.
intensity
The predicted intensity of precipitation, should it occur. Units are in dBZ, and range from 0 to 75. (no precip: 0-2, sporadic: 2-15, light: 15-30, moderate: 30-45, heavy: 45-75)
error
The 3-sigma error of the intensity value, conditional on precipitation. In other words, if there is precipitation, then 99.7% of the time the intensity value will be between intensity ± error.
type
The type of precipitation, should it occur. Either 'rain', 'snow', or 'sleet'.
temp
The temperature in degrees Fahrenheit at the given time. May be undefined if no data is available.
time
The time of the prediction as a UNIX GMT timestamp.