Overview

The Infoplaza Weather Forecast API provides weather forecast data for a specified location. The API returns weather forecast information based on the provided latitude and longitude coordinates.

Authentication

To use the API, a token is required for authentication. Include the token as a query parameter in your request.

Request

gethttps://api.infoplaza.com/weather/v1/forecast

Get forecast data for a specific location

Parameters

latitude
number
required
Latitude coordinate
longitude
number
required
Longitude coordinate
token
string
required
Authentication token

Endpoint structure

GET https://api.infoplaza.com/weather/v1/forecast?latitude={latitude}&longitude={longitude}&token={token}

Responses

200Successful response
latitude
number
The latitude coordinate
longitude
number
The longitude coordinate
location
string
The name of the location
country
string
The name of the country
timezone
string
The timezone indentifier for this location
currently
object
None of the keys are guaranteed to be available, always check for missing keys. If there are no nearby observations the API will try to provide you with a forecast for the current time, which should approximate current conditions.
time
integer
Timestamp the data is valid
icon
string
Reference to a weather icon
precipIntensity
number
Precipitation rate in millimeters per hour
precipProbability
number
Chance of precipitation in a fraction (0-1). If this data is from an actual observation this is either 0 or 1 (eg. there was no precipitation OR there was)
temperature
number
Temperature in Celsius
apparentTemperature
number
Feels like temperature
dewPoint
number
Dewpoint in Celsius
humidity
number
Relative humidity (0-1)
pressure
number
Sea level pressure in hPa
windSpeed
number
Wind speed in m/s
windGust
number
Wind gust in m/s
windBearing
number
Bearing of wind in degrees (0-359)
cloudCover
number
Cloud cover (0-1)
visibility
number
Horizontal visibility in meters
nearerstStormDistance
number
Distance to nearest thunderstorm in kilometers
nearestStormBearing
number
Bearing to nearest thunderstorm in degrees (0-359)
isForecast
boolean
Whether this data is a forecast or an actual measurement
minutely
array
Contains 24 items with an interval of 5 minutes between items.
time
integer
Timestamp the data is valid
precipIntensity
number
Precipitation rate in millimeters per hour
precipProbability
number
Chance of precipitation in a fraction (0-1). If this data is from an actual observation this is either 0 or 1 (eg. there was no precipitation OR there was)
precipType
string
The type of precipitation, options are rain, snow, ice and mix.
hourly
array
None of the keys are guaranteed to be available, always check for missing keys. Will return a 7 day forecast; 168 items. This is not a guarantee, always check for availability.
time
integer
Timestamp the data is valid
icon
string
Reference to a weather icon
iconExtended
string
Reference to a weather icon from the extended set
precipIntensity
number
Precipitation rate in millimeters per hour
precipProbability
number
Chance of precipitation in a fraction (0-1). If this data is from an actual observation this is either 0 or 1 (eg. there was no precipitation OR there was)
precipType
string
The type of precipitation, options are rain, snow, ice and mix.
temperature
number
Temperature in Celsius
apparentTemperature
number
Feels like temperature
dewPoint
number
Dewpoint in Celsius
humidity
number
Relative humidity (0-1)
pressure
number
Sea level pressure in hPa
windSpeed
number
Wind speed in m/s
windGust
number
Wind gust in m/s
windBearing
number
Bearing of wind in degrees (0-359)
cloudCover
number
Cloud cover (0-1)
visibility
number
Horizontal visibility in meters
daily
array
Returns a 15 day forecast per day. None of the keys are guaranteed to be available, always check for missing keys.
time
integer
Timestamp the data is valid
icon
string
Reference to a weather icon
iconExtended
string
Reference to a weather icon from the extended set
precipSum
number
Precipitation sum in millimeters (or cm in case of snow)
precipProbability
number
Chance of precipitation in a fraction (0-1). If this data is from an actual observation this is either 0 or 1 (eg. there was no precipitation OR there was)
precipType
string
The type of precipitation, options are rain, snow, ice and mix.
apparentTemperature
number
Day feels like temperature in Celsius
temperatureHigh
number
Maximum temperature in Celsius
temperatureLow
number
Minimum temperature in Celsius
dewPoint
number
Dewpoint in Celsius
humidity
number
Relative humidity (0-1)
pressure
number
Sea level pressure in hPa
windSpeed
number
Wind speed in m/s averaged
windBearing
number
Bearing of wind in degrees (0-359)
cloudCover
number
Cloud cover (0-1)
uvIndex
number
UV index during the day
400Bad Request
status
string
message
string
404Location not found
status
string
message
string

Example

Request

GET https://api.infoplaza.com/weather/v1/forecast?latitude=52.2&longitude=4.18&token=ip-5c126f7a-1bd0-4d28-8220-8735ae296f2a

Response

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 { "latitude": 52.105, "longitude": 4.276, "location": "Scheveningen", "country": "Nederland", "timezone": "Europe/Amsterdam", "currently": { "time": 1701183000, "icon": "B", "iconExtended": "A002D", "precipIntensity": 0, "precipProbability": 0, "temperature": 5, "apparentTemperature": 5, "dewPoint": -0.3, "humidity": 0.68, "pressure": 1007.95, "windSpeed": 2, "windGust": 3.3, "windBearing": 239.5, "cloudCover": 0.01, "visibility": 46000, "nearestStormDistance": 1505, "nearestStormBearing": 130 }, "minutely": [ // 24 items { "time": 1701180300, "precipIntensity": 0, "precipProbability": 0, "precipType": "rain" }, ... { "time": 1701180600, "precipIntensity": 0, "precipProbability": 0, "precipType": "rain" } ], "hourly": [ // 168 items { "time": 1701176400, "icon": "B", "iconExtended": "A002D", "precipIntensity": 0, "precipProbability": 0, "precipType": "rain", "temperature": 5, "apparentTemperature": 4, "dewPoint": -1, "humidity": 0.62, "pressure": 1007.7, "windSpeed": 1.9, "windGust": 3.1, "windBearing": 270, "cloudCover": 0.36, "visibility": 16588 }, ... { "time": 1701180000, "icon": "B", "iconExtended": "A002D", "precipIntensity": 0, "precipProbability": 0, "precipType": "rain", "temperature": 4, "apparentTemperature": 2, "dewPoint": -1, "humidity": 0.69, "pressure": 1007.6, "windSpeed": 2.4, "windGust": 3.9, "windBearing": 247.5, "cloudCover": 0.31, "visibility": 15395 } ], "daily": [ // 15 items { "time": 1701212400, "icon": "F", "iconExtended": "C002D", "precipIntensity": 4.7, "precipProbability": 0.85, "precipType": "rain", "temperatureHigh": 5, "temperatureLow": 0, "apparentTemperature": -2, "dewPoint": 0.6, "humidity": 0.79, "pressure": 1002.3, "windSpeed": 9, "windBearing": 285, "cloudCover": 0.78, "uvIndex": 0 }, ... { "time": 1701298800, "icon": "E", "iconExtended": "B002D", "precipIntensity": 0.3, "precipProbability": 0.05, "precipType": "mix", "temperatureHigh": 2, "temperatureLow": -1, "apparentTemperature": -4, "dewPoint": -1.5, "humidity": 0.9, "pressure": 1004.3, "windSpeed": 2, "windBearing": 71, "cloudCover": 0.65, "uvIndex": 0 } ] }

Rate Limit

The current rate limit is set to 100 requests per minute. If you exceed this limit, your requests will be throttled, and you will receive an error response.

If your use case requires a higher rate limit, please contact the Infoplaza support team to discuss potential options or to upgrade your plan.