Migrate from Dark Sky API to OpenWeather One Call API 3.0

With our One Call API 3.0 you can easily migrate from the Dark Sky API and get access to main weather data such as current weather, forecast and historical weather with only one call to the API.

Features of OpenWeather One Call API 3.0

One Call API 3.0 contains 4 endpoints and provides access to various data:
- Current weather and forecasts:
  - minute forecast for 1 hour
  - hourly forecast for 48 hours
  - daily forecast for 8 days
  and government weather alerts
- Weather data for any timestamp for 45+ years historical archive and 4 days ahead forecast
- Daily aggregation of weather data for 45+ years archive and 1.5 years ahead forecast
- Weather overview with a human-readable weather summary for today and tomorrow's forecast
Matching parameters of Dark Sky API and OpenWeather One Call API 3.0

To match Dark Sky API parameters to the equivalent OpenWeather One Call API 3.0 parameters, please use this table.

How to start using One Call API 3.0

There are 3 simple steps:

Sign up

You will receive a welcome email that contains endpoints and instructions.
Get API key

On the account page find the "API key" tab and get the API key. Please use your API key in each API call.
Call API
- Getting current, minute, hourly and daily forecast weather data
  
  https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&exclude={part}&appid={API key}
- Getting weather data by specified timestamp from 1st January 1979 till 4 days ahead forecast
  
  https://api.openweathermap.org/data/3.0/onecall/timemachine?lat={lat}&lon={lon}&dt={time}&appid={API key}
- Getting daily aggregation weather data by specified timestamp from 2st January 1979 till 1.5 years ahead forecast
  
  https://api.openweathermap.org/data/3.0/onecall/day_summary?lat={lat}&lon={lon}&date={date}&appid={API key}
- Getting weather overview with a human-readable weather summary for today and tomorrow's forecast, utilizing OpenWeather AI technologies
  
  https://api.openweathermap.org/data/3.0/onecall/overview?lat={lat}&lon={lon}&appid={API key}

Parameters
`lat`	required	Latitude of coordinates
`lon`	required	Longitude of coordinates
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)
`dt`	required	Timestamp (Unix time, UTC time zone), e.g. dt=1586468027. Data is available from January 1st, 1979 till 4 days ahead
`date`	required	Date in the `YYYY-MM-DD` format for which data is requested. Date is available for 45+ years archive (starting from 1979-01-02) up to the 1,5 years ahead forecast to the current date
`exclude`	optional	By using this parameter you can exclude some parts of the weather data from the API response. It should be a comma-delimited list (without spaces). Available values: `current` `minutely` `hourly` `daily` `alerts`

One Call API 3.0 documentation (complete description of API calls and parameters in API response, with examples).

One Call API documentation

Matching parameters

One Call API	Dark Sky API	Description
`timezone`	`timezone`	Time zone name of the requested location
Current weather (parameters of current weather and weather data by timestamp are the same)
`dt`	`time`	UTC time zone
`sunrise`	`sunriseTime`	Sunrise time, unix, UTC
`sunset`	`sunsetTime`	Sunset time, unix, UTC
`temp`	`temperature`	Temperature. Unit Default: Kelvin. How to change units format
`feels_like`	`apparentTemperature`	Feels like. Unit Default: Kelvin. How to change units format
`pressure`	`pressure`	Atmospheric pressure on the sea level, hPa
`humidity`	`humidity`	Humidity, %
`dew_point`	`dewPoint`	Dew point. Unit Default: Kelvin. How to change units format
`clouds`	`cloudCover`	Cloudiness, %
`wind_speed`	`windSpeed`	Wind speed. Unit Default: meter/sec. How to change units format
`wind_gust`	`windGust`	Wind gust. Unit Default: meter/sec. How to change units format
`wind_deg`	`windBearing`	Wind direction, degrees (meteorological)
`weather.description`	`summary`	Weather condition within the group. Full list of weather conditions You can get the output in your language. Learn more
`weather.icon`	`icon`	Weather icon id. How to get icons
`rain`	`precipIntensity`	Precipitation volume, mm
`snow`	`precipIntensity`	Snow volume, mm
`uvi`	`uvIndex`	UV index
`visibility`	`visibility`	Average visibility, meters
Minute forecast for 1 hour
`dt`	`time`	Time of forecasted data, unix, UTC
`precipitation`	`precipIntensity`	Precipitation volume, mm
Hourly forecast for 48 hours (parameters of hourly forecast and weather data by timestamp are the same)
`dt`	`time`	Time of forecasted data, unix, UTC
`temp`	`temperature`	Temperature. Unit Default: Kelvin. How to change units format
`feels_like`	`apparentTemperature`	Feels like. Unit Default: Kelvin. How to change units format
`pressure`	`pressure`	Atmospheric pressure on the sea level, hPa
`humidity`	`humidity`	Humidity, %
`dew_point`	`dewPoint`	Dew point. Unit Default: Kelvin. How to change units format
`clouds`	`cloudCover`	Cloudiness, %
`wind_speed`	`windSpeed`	Wind speed. Unit Default: meter/sec. How to change units format
`wind_gust`	`windGust`	Wind gust. Unit Default: meter/sec. How to change units format
`wind_deg`	`windBearing`	Wind direction, degrees (meteorological)
`weather.description`	`summary`	Weather condition within the group. Full list of weather conditions You can get the output in your language. Learn more
`weather.icon`	`icon`	Weather icon id. How to get icons
`rain`	`precipIntensity`	Precipitation volume, mm
`snow`	`precipIntensity`	Snow volume, mm
`visibility`	`visibility`	Average visibility, meters
Daily forecast for 8 days
`dt`	`time`	Time of data forecasted, unix, UTC
`sunrise`	`sunriseTime`	Sunrise time, unix, UTC
`sunset`	`sunsetTime`	Sunset time, unix, UTC
`summary`	`data.summary`	Human-readable description of the weather conditions for the day
`temp.day`	`temperatureHigh`	Day temperature. Unit Default: Kelvin. How to change units format
`temp.night`	`temperatureLow`	Night temperature. Unit Default: Kelvin. How to change units format
`temp.morn`	-	Morning temperature. Unit Default: Kelvin. How to change units format
`temp.eve`	-	Evening temperature. Unit Default: Kelvin. How to change units format
`temp.min`	`temperatureMin`	Unit Default: Kelvin. How to change units format
`temp.max`	`temperatureMax`	Unit Default: Kelvin. How to change units format
`feels_like.day`	`apparentTemperatureHigh`	Unit Default: Kelvin. How to change units format
`feels_like.night`	`apparentTemperatureLow`	Unit Default: Kelvin. How to change units format
`feels_like.morn`	-	Unit Default: Kelvin. How to change units format
`feels_like.eve`	-	Unit Default: Kelvin. How to change units format
`pressure`	`pressure`	Atmospheric pressure on the sea level, hPa
`humidity`	`humidity`	Humidity, %
`dew_point`	`dewPoint`	Unit Default: Kelvin. How to change units format
`clouds`	`cloudCover`	Cloudiness, %
`wind_speed`	`windSpeed`	Wind speed. Unit Default: meter/sec. How to change units format
`wind_gust`	`windGust`	Wind gust. Unit Default: meter/sec. How to change units format
`wind_deg`	`windBearing`	Wind direction, degrees (meteorological)
`weather.description`	`summary`	Weather condition within the group. Full list of weather conditions You can get the output in your language. Learn more
`weather.icon`	`icon`	Weather icon id. How to get icons
`rain`	`precipIntensity`	Precipitation volume, mm
`snow`	`precipIntensity`	Snow volume, mm
`uvi`	`uvIndex`	UV index
`visibility`	`visibility`	Average visibility, meters

How to migrate from Dark Sky API to OpenWeather One Call API 3.0

Features of OpenWeather One Call API 3.0

How to start using One Call API 3.0

Matching parameters