3 Hourly Weather

The 3-Hour Interval Forecast endpoint provides weather predictions broken down into 3-hour time steps. It is tailored for use cases requiring medium-resolution forecasts, such as agriculture, logistics, or event planning. The predictions are based on high-resolution numerical weather models, refined to ensure consistency and accuracy.

Each time block in the forecast contains the following weather parameters:

Air temperature, humidity, and pressure forecasted for the 3-hour interval.
Wind speed and direction averaged for the interval.
Type and volume of expected precipitation.
UV index and cloud conditions.
Astronomy data is supplied per day as an array.

Request Parameters

slug | lat and lon: 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:

curl

php

python

curl --location 'https://api.meteoflow.com/v2/forecast/by-3hours/?slug=united-kingdom-london&days=4&key=TOKEN'

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:

curl

php

python

curl --location 'https://api.meteoflow.com/v2/forecast/by-3hours/?lat=51.5072&lon=-0.1275&days=4&key=TOKEN'

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.

Field	Description	Format
`place`	Locality.	Object
`forecast`	Current weather.	Object
`astronomy`	Astronomy.	Object

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

Daily Weather Forecast

Hourly Weather