Open-Meteo API reference

Both endpoints are completely free and require no API key or account registration.

Sky AI Forecast calls two Open-Meteo endpoints. First, the geocoding endpoint resolves a city name to coordinates. Those coordinates are then passed to the forecast endpoint to retrieve weather data.

Geocoding endpoint

GET https://geocoding-api.open-meteo.com/v1/search

Converts a city name into geographic coordinates plus display metadata.

Parameters

string

required

City name to search for (e.g. London, Tokyo, New York).

integer

default:"1"

Maximum number of results to return. Sky AI Forecast always passes count=1 to take the single best match.

Example request

GET https://geocoding-api.open-meteo.com/v1/search?name=London&count=1

Example response

{
  "results": [
    {
      "name": "London",
      "country": "United Kingdom",
      "latitude": 51.5085,
      "longitude": -0.1257
    }
  ]
}

Response fields used by the app

The app reads results[0] and extracts the following fields:

object[]

Array of matching locations. The app always reads index 0.

Show properties

string

required

Display name of the city, shown in the UI.

string

required

Full country name, shown alongside the city name.

number

required

Latitude in decimal degrees. Passed to the forecast endpoint.

number

required

Longitude in decimal degrees. Passed to the forecast endpoint.

Forecast endpoint

GET https://api.open-meteo.com/v1/forecast

Returns current conditions, hourly data, and a 16-day daily outlook for a given location.

Full URL built by the app

https://api.open-meteo.com/v1/forecast?latitude=LAT&longitude=LON&current=temperature_2m,relative_humidity_2m,weather_code&hourly=temperature_2m,weather_code&daily=temperature_2m_max,temperature_2m_min,weather_code&forecast_days=16&timezone=auto

Parameters

number

required

Latitude of the location, taken from the geocoding result.

number

required

Longitude of the location, taken from the geocoding result.

string

required

Comma-separated list of current-condition variables to include. The app requests: temperature_2m, relative_humidity_2m, weather_code.

string

required

Comma-separated list of hourly variables to include. The app requests: temperature_2m, weather_code.

string

required

Comma-separated list of daily aggregate variables to include. The app requests: temperature_2m_max, temperature_2m_min, weather_code.

integer

default:"16"

Number of days of forecast data to return. Fixed at 16.

string

default:"auto"

Timezone for time values. Set to auto so Open-Meteo infers the local timezone from the coordinates.

Response fields used by the app

object

Current weather conditions at the time of the request.

Show properties

number

required

Current air temperature at 2 m height, in °C.

number

required

Current relative humidity at 2 m height, in %.

integer

required

WMO weather interpretation code describing current conditions. See the Weather codes reference.

object

Hourly data arrays. Each array is ordered chronologically and shares the same index with hourly.time.

Show properties

string[]

required

ISO 8601 timestamp for each hour (e.g. "2024-06-01T14:00").

number[]

required

Hourly air temperature at 2 m height, in °C.

integer[]

required

WMO weather code for each hour.

object

Daily aggregate arrays. Each array is ordered by date and shares the same index with daily.time.

Show properties

string[]

required

Date string for each day (e.g. "2024-06-01").

number[]

required

Daily high temperature, in °C. Displayed in the 16-day outlook.

number[]

Daily low temperature, in °C. Fetched but not currently displayed in the UI.

integer[]

required

WMO weather code for each day.

Get Started

Features

Customization

Reference

Geocoding endpoint

Parameters

Example request

Example response

Response fields used by the app

Forecast endpoint

Full URL built by the app

Parameters

Response fields used by the app

​Geocoding endpoint

​Parameters

​Example request

​Example response

​Response fields used by the app

​Forecast endpoint

​Full URL built by the app

​Parameters

​Response fields used by the app

Geocoding endpoint

Parameters

Example request

Example response

Response fields used by the app

Forecast endpoint

Full URL built by the app

Parameters

Response fields used by the app