Dark Sky
By darkskyapis
Updated 4 months ago

Dark Sky API Documentation

The easiest, most advanced, weather API on the web.

Learn more about this API
GETTime Machine

A Forecast Request returns the current weather conditions, a minute-by-minute forecast for the next hour (where available), an hour-by-hour forecast for the next 48 hours, and a day-by-day forecast for the next week.

Header Parameters
Required Parameters
REQUIREDThe latitude of a location (in decimal degrees). Positive is north, negative is south.
REQUIREDThe longitude of a location (in decimal degrees). Positive is east, negative is west.
Optional Parameters
OPTIONALReturn summary properties in the desired language. (Note that units in the summary will be set according to the units parameter, so be sure to set both parameters appropriately.) language should be 2-letter language code. English is default
OPTIONALWhen extend=hourly, return hour-by-hour data for the next 168 hours, instead of the next 48. When using this option, we strongly recommend enabling HTTP compression.
OPTIONALReturn weather conditions in the requested units. [units] should be one of the following: auto: automatically select units based on geographic location ca: same as si, except that windSpeed and windGust are in kilometers per hour uk2: same as si, except that nearestStormDistance and visibility are in miles, and windSpeed and windGust in miles per hour us: Imperial units (the default) si: SI units
OPTIONALExclude some number of data blocks from the API response. This is useful for reducing latency and saving cache space. The value blocks should be a comma-delimeted list (without spaces) of any of the following: currently, minutely, hourly, daily, alerts, flags
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication