Hourly Weather
The Hourly Forecast endpoint delivers time-resolved weather predictions in hourly steps for a specific location. Forecasts are generated from high-resolution numerical weather models and post-processed to ensure spatial and temporal consistency. This method is ideal for short-term planning, offering granular insight into upcoming weather developments.
Each forecasted hour contains detailed meteorological parameters:
- Air temperature, humidity, and pressure projected for the hour.
- Wind speed and direction as forecasted average values.
- Precipitation type and expected amount for each hour.
- UV index and cloud coverage.
- Astronomy data is provided for each day included in the forecast as an array.
Request Parameters
slug|latandlon: Location parameters.days: The number of days for which the forecast is requested. For instance, the value 4 means that data will be provided for four days, starting from the current day. The maximum allowable value depends on your tariff plan and the data provided by the service.key: Your unique API token required to authorize the request. The API token can be obtained from your personal account after registration and token creation.
Search Methods
Search by Slug
This method uses the slug parameter to specify a unique location identifier.
Example:
Description:
A unique, string‑encoded location identifier. For example, united-kingdom-london represents London, United Kingdom. This parameter lets the API unambiguously identify the exact city or region for which the current weather data is requested.
A list of all available slug values can be found in the Geography API section, which lists all supported locations.
Search by Coordinates
This method allows you to specify the location using geographic coordinates.
Parameters:
lat: Latitude in decimal degrees.lon: Longitude in decimal degrees.
Example:
Description:
By providing the lat and lon parameters, you directly specify the exact location for which the forecast is required.
Description of the Response Structure
All successful API responses return with an HTTP status of 200 OK and contain data in JSON format.
Object place
| Field | Description | Format |
|---|---|---|
country | Country code. | String |
timezone_offset | Timezone offset from UTC in seconds. | Number |
latitude | Longitude. | Number |
longitude | Latitude. | Number |
city_name | Name of the locality. | String |
country_name | Country name. | String |
region_name | Region name. | String |
Object current
The current object provides a real‑time snapshot of weather conditions at a given location, including key parameters such as temperature, humidity, atmospheric pressure, wind speed and direction, precipitation rate, and other indicators reflecting the present moment.
| Field | Description | Format |
|---|---|---|
date | Date. | String |
temperature_air | Air temperature. | Number |
temperature_air_feels_like | Air temperature feels like. | Number |
description | Description of the current weather. | String |
precipitation | Precipitation. | Object |
cloudness | Cloudiness. | Object |
icon | Icon. | Object |
uvindex | UV index. | Object |
pressure | Pressure. | Number |
humidity | Humidity. | Number |
visibility | Visibility. | Number |
wind | Wind. | Object |
Object precipitation
| Field | Description | Format |
|---|---|---|
type | Type of precipitation. Possible values:none – no precipitation.rain – rain.rain-snow – rain with snow.snow – snow. | String |
mm | Amount of precipitation in millimeters. | Number | Null |
Object cloudness
| Field | Description | Format |
|---|---|---|
type | Cloudiness. Possible values:clear – clear.partly cloudy – partly cloudy.cloudy – overcast. | String |
Object icon
| Field | Description | Format |
|---|---|---|
code | Symbolic code for the weather icon. | String |
url | URL of the weather icon. | String |
Object uvindex
| Field | Description | Format |
|---|---|---|
val | Value. | Number |
description | Description. | String |
Object wind
| Field | Description | Format |
|---|---|---|
speed | The average wind speed over the past 10 minutes. | Number |
degree | Wind direction in meteorological degrees (0° = North, 90° = East, 180° = South, 270° = West). | Number |
gust | The maximum wind gust speed recorded over the past 10 minutes. | Number |
Object astronomy
| Field | Description | Format |
|---|---|---|
sunrise | Sunrise time in UTC format (ISO 8601), indicating the exact moment the day begins. | Number |
sunset | Sunset time in UTC format (ISO 8601), indicating the moment when daylight ends. | Number |
day_length | Duration of the daylight in minutes, calculated as the difference between sunset and sunrise. | Number |
moon_angle | The current angle of the Moon in the sky, measured in degrees (0° to 360°). | Number |
moon_illumination | The percentage of the Moon's surface illuminated by the Sun (0% = new moon, 100% = full moon). | Number |
moon_phase_code | Numeric code for the Moon's phase (0–7). | Number |
moon_phase_desc | Textual description of the Moon's phase. | string |