Hourly Weather (1h)

Time-resolved weather forecast with hourly detail for short-term planning.

GET /v2/forecast/by-hours/

Returns hourly forecast and astronomy data. You must provide either slug or lat+lon.

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.

Query Parameters

NameTypeRequiredDescription
slugstringnoCity/location slug. Alternative to lat+lon.
latnumber (double)noLatitude. Used with lon as an alternative to slug.
lonnumber (double)noLongitude. Used with lat as an alternative to slug.
daysintegernoNumber of forecast days
unitstring (metric | imperial)noUnit system

Example

curl --location 'https://api.meteoflow.com/v2/forecast/by-hours/?slug=united-kingdom-london&days=1&unit=metric'
curl --location 'https://api.meteoflow.com/v2/forecast/by-hours/?lat=51.50&lon=-0.12&days=1&unit=metric'

200 Response Schema

Response type: object.

Top-level fields:

FieldTypeRequiredDescription
placeobjectyes-
astronomyarrayno-
forecastarrayno-

place

FieldTypeRequiredDescription
countrystringyes-
timezone_offsetintegeryes-
latitudenumber (double)yes-
longitudenumber (double)yes-
city_namestringyes-
country_namestringyes-
region_namestring | nullno-

astronomy[]

FieldTypeRequiredDescription
datestring (date)yes-
sunrisestring (date-time)yes-
sunsetstring (date-time)yes-
day_lengthinteger (int64)yes-
moon_angleintegeryes-
moon_illuminationintegeryes-
moon_phase_codeintegeryes-

forecast[]

FieldTypeRequiredDescription
datestring (date-time)yes-
temperature_airnumber (double)yes-
temperature_air_feels_likenumber (float)yes-
descriptionstringyes-
precipitationobjectyes-
cloudinessobjectyes-
iconobjectyes-
uvindexobjectyes-
pressureintegeryes-
humidityintegeryes-
visibilityinteger | nullno-
windobjectyes-

forecast[].precipitation

FieldTypeRequiredDescription
typestring (none | rain | snow)yes-
mmnumber (float) | nullyes-

forecast[].cloudiness

FieldTypeRequiredDescription
typestring (clear | partly cloudy | cloudy)yes-

forecast[].icon

FieldTypeRequiredDescription
codestringyes-
urlstringyes-

forecast[].uvindex

FieldTypeRequiredDescription
valintegeryes-
descriptionstring (low | moderate | high | very high | extreme)yes-

forecast[].wind

FieldTypeRequiredDescription
speednumber (double)yes-
degreeintegeryes-
gustnumber (double)yes-

Error Responses

StatusDescription
400Invalid request parameters
404Data/route not found
500Internal server error

Error object fields:

FieldTypeRequiredDescription
status_codeintegeryes-
messagestringyes-
detailstringyes-