Current Weather
The Current Weather section delivers an up‑to‑the‑minute snapshot of atmospheric conditions at any specified location. Observational data are pulled from a network of ground stations, satellite-derived estimates and high‑resolution numerical models, then bias‑corrected and spatially interpolated to provide a coherent, real‑time view. Updates occur every 10–15 minutes (depending on data availability), ensuring you always have the freshest information at hand.
Each parameter is returned as a single “now” value reflecting the latest measurement or short‑term average:
- Temperature, humidity and pressure are instantaneous readings, corrected for known sensor biases.
- Wind speed and direction represent an average over the prior 10 minutes to smooth out gusts while preserving meaningful trends.
- Precipitation is reported as the accumulated total over the last hour.
Request Parameters
slug|latandlon: Location parameters.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 |