How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

APIFreaks - API Hub for Developers Weather APIs API

The Weather APIs API from APIFreaks - API Hub for Developers — 7 operation(s) for weather apis.

APIFreaks - API Hub for Developers Weather APIs API is one of 27 APIs that APIFreaks - API Hub for Developers publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Weather APIs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

This API exposes 8 operations across 7 paths, and defines 66 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.apifreaks.com/v1.0/weather.

8 operations 7 paths 66 schemas 7 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.apifreaks.com/v1.0/
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

APIFreaks - API Hub for Developers Weather APIs API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-apiKey (ApiKeyAuthHeader). An API key is passed in the query as apiKey (ApiKeyAuthQuery). By default, every request must be authenticated.

  • ApiKeyAuthHeader — Pass your API key via the X-apiKey request header.
  • ApiKeyAuthQuery — Pass your API key via the apiKey query parameter.

Paths & Operations 8

Across 7 paths, the API surfaces 8 operations — 7 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Weather APIs 8
GET
/air-quality
Air pollution monitoring and quality forecasts
getAirQuality 8 params → 200400404
POST
/current
Get real-time weather data for multiple locations, coordinates, or IP addresses
bulkLiveWeather 2 params body → 200400
GET
/current
Real-time weather conditions for any location on demand
getLiveWeather 5 params → 200400404
GET
/flood
Get flood risk and river discharge forecast
getFloodForecast 9 params → 200400404
GET
/historical
Retrieve historical weather conditions for a specific past date and location, coordinates, or IP address
getHistoricalData 8 params → 200400404
GET
/marine
Dive into detailed marine weather forecasts for coastal and offshore locations
getMarineWeather 9 params → 200400404
GET
/time-series
Get historical weather data across a date range
getTimeSeriesData 9 params → 200400
GET
/forecast
Retrieve daily, hourly, or minutely weather forecasts for up to 16 days ahead
getWeatherForecast 10 params → 200400

Schemas 66

The contract defines 66 schemas that model the data the API accepts and returns. The most detailed are ForecastDaily (34 properties), HistoricalDaily_2 (29 properties), HistoricalDaily (29 properties), ForecastHourly (26 properties). Each schema is shown below with its type and property counts.

BulkCurrentResponse
object
Bulk weather response containing an array of per-location current weather results.
1 property 1 required
LocationByCoordinates
object
Location data when the target is specified by GPS coordinates (lat/long).
9 properties 7 required
ForecastDay
object
Forecast data for a single day. Contains an astronomy block plus exactly one of daily/hourly/minutely, chosen by the precision parameter.
4 properties 1 required
WeatherLocation_4
object
Location information. The shape of this object varies by lookup method.
LocationByIP_5
object
Location data when the target is inferred from an IP address.
18 properties 12 required
ForecastData
object
Forecast data keyed by calendar date (YYYY-MM-DD). Each key is a date string and the value is a ForecastDay object.
LocationByAddress
object
Location data when the target is specified by a city name or address string.
10 properties 8 required
FloodForecastDay
object
Flood forecast data for a single day, containing river discharge metrics.
1 property 1 required
WeatherLocation_6
object
Location information. The shape of this object varies by lookup method.
LocationByAddress_2
object
Location data when the target is specified by a city name or address string.
10 properties 8 required
BulkWeatherItemError
object
Per-item error, returned in place of a weather result when an individual location could not be resolved.
1 property 1 required
MarineForecastData
object
Forecast data keyed by date (YYYY-MM-DD). Each key is a forecast date and its value is a MarineForecastDay.
FloodForecastData
object
Flood forecast data object keyed by date (YYYY-MM-DD); each key's value is a FloodForecastDay object.
LocationByCoordinates_8
object
Location data when the target is specified by GPS coordinates (lat/long).
9 properties 7 required
LocationByAddress_5
object
Location data when the target is specified by a city name or address string.
10 properties 8 required
WeatherLocation_3
object
Location information. The shape of this object varies by lookup method.
LocationByCoordinates_2
object
Location data when the target is specified by GPS coordinates (lat/long).
9 properties 7 required
AirQualityForecast
object
Forecast data object keyed by date (YYYY-MM-DD), one key per day in the requested startDate/endDate range. The key names are dynamic dates, not a fixed schema…
ForecastMinutely
object
Minute-by-minute forecast reading with temperature, precipitation, wind, and radiation data. Present only when precision is minutely.
18 properties 18 required
ForecastHourly
object
Hourly forecast reading with temperature, precipitation, wind, and radiation data. Present only when precision is hourly.
26 properties 26 required
HistoricalDaily
object
Daily historical weather summary with temperature, precipitation, wind, and radiation statistics.
29 properties 29 required
CurrentWeatherResponse
object
Current weather response containing location data and current weather conditions.
2 properties 2 required
LocationByCoordinates_6
object
Location data when the target is specified by GPS coordinates (lat/long).
9 properties 7 required
AirQuality
object
Air quality metrics including European and US AQI indices plus individual pollutant concentrations.
13 properties 13 required
BulkCurrentRequest
object
Request body for bulk live weather lookup, containing an array of location specifications.
1 property 1 required
HistoricalHourly
object
Hourly historical weather reading with temperature, precipitation, and wind data.
22 properties 22 required
LocationByIP
object
Location data when the target is inferred from an IP address.
18 properties 12 required
MarineHourly
object
Hourly marine weather reading with wave, swell, and sea surface data for a single hour.
16 properties 16 required
FloodResponse
object
Flood forecast response containing location data and date-keyed river discharge forecasts.
2 properties 2 required
LocationByIP_6
object
Location data when the target is inferred from an IP address.
18 properties 12 required
HistoricalData
object
Historical weather data for the requested date, containing an astronomy block plus one of daily or hourly readings depending on the precision parameter. It is…
3 properties 1 required
LocationByAddress_6
object
Location data when the target is specified by a city name or address string.
10 properties 8 required
HistoricalHourly_2
object
Hourly historical weather reading with temperature, precipitation, and wind data.
22 properties 22 required
CurrentWeather
object
Current weather conditions including temperature, humidity, precipitation, wind, pressure, astronomy, and air quality.
17 properties 17 required
ForecastDaily
object
Daily forecast summary with temperature, precipitation, wind, UV, and radiation statistics. Present only when precision is daily (the default).
34 properties 34 required
MarineMinutely
object
Minute-by-minute marine data point for ocean current and sea level measurements.
4 properties 4 required
LocationByCoordinates_4
object
Location data when the target is specified by GPS coordinates (lat/long). countryname, stateprov, and city are omitted when the coordinates do not resolve to a…
9 properties 4 required
LocationByAddress_8
object
Location data when the target is specified by a city name or address string.
10 properties 8 required
MarineResponse
object
Marine weather response. current and forecast are mutually exclusive: current is returned when startDate/endDate are omitted, forecast is returned when both ar…
3 properties 1 required
LocationByIP_8
object
Location data when the target is inferred from an IP address. Private/reserved IPs resolve to placeholder "ZZ"/empty values instead of an error.
18 properties 12 required
Astronomy
object
Astronomical data including sunrise, sunset, solar noon, day length, moon phase, and moon times.
13 properties 13 required
AirQualityResponse
object
Air quality response containing location data plus either current observations or date-keyed forecast data. current and forecast are mutually exclusive — a sin…
3 properties 1 required
Astronomy_3
object
Astronomical data including sunrise, sunset, solar noon, day length, moon phase, and moon times. Always present for every requested day, regardless of precisio…
13 properties 13 required
LocationByCoordinates_5
object
Location data when the target is specified by GPS coordinates (lat/long).
9 properties 7 required
TimeSeriesData
object
Time-series data object keyed by date (YYYY-MM-DD). Each key is a date and the value is a TimeSeriesDay containing daily aggregates, hourly readings, and astro…
1 property 1 required
AirQualityForecastDay
object
Air quality forecast data for a single day, containing hourly readings.
1 property 1 required
MarineDaily
object
Daily marine forecast summary with wave, wind-wave, and swell statistics for one day.
12 properties 12 required
AirQualityHourly
object
Hourly air quality forecast reading with pollutant concentrations and UV index.
12 properties 12 required
HistoricalDaily_2
object
Daily historical weather summary with temperature, precipitation, wind, and radiation statistics.
29 properties 29 required
CurrentMarine
object
Current marine weather conditions including wave, swell, sea level, and current data. For locations with no nearby ocean data (inland/landlocked), every field…
16 properties 16 required
WeatherLocation_5
object
Location information. Shape depends on how the location was resolved (coordinates, IP, or address/city name).
MarineForecastDay
object
Marine forecast for a single day. Exactly one of daily, hourly, or minutely is present, matching whichever precision value was requested (default daily) — the…
3 properties
HistoricalResponse
object
Historical weather response containing location data and historical weather data for the requested date.
2 properties 2 required
Astronomy_2
object
Astronomical data including sunrise, sunset, solar noon, day length, moon phase, and moon times. Time fields are HH:MM by default; when the timezone query para…
13 properties 13 required
LocationByIP_4
object
Location data when the target is inferred from an IP address.
18 properties 12 required
ForecastResponse
object
Weather forecast response containing location and forecast data for the requested date range.
2 properties 2 required
CurrentWeatherResponse_2
object
Current weather response containing location data and current weather conditions.
2 properties 2 required
ErrorResponse
object
Standard error envelope returned by the API on failed requests.
5 properties 1 required
TimeSeriesDay
object
Time-series weather data for a single day. Contains astronomy data plus exactly one of daily or hourly, depending on the request's precision parameter — the ot…
3 properties 1 required
WeatherLocation
object
Location information
FloodDaily
object
Daily river discharge forecast data with discharge statistics and percentiles.
8 properties 8 required
WeatherLocation_2
object
Location information. The shape of this object varies by lookup method.
BulkLocationItem
object
Each object specifies one location using exactly one of the supported lookup methods: location alone, lat+long together, or ip alone. None of these fields is r…
4 properties
LocationByIP_2
object
Location data when the target is inferred from an IP address.
18 properties 12 required
LocationByAddress_4
object
Location data when the target is specified by a city name or address string.
10 properties 8 required
TimeSeriesResponse
object
Time-series weather response containing location data and date-keyed time-series data.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

apifreaks-api-hub-for-developers-weather-apis-api-openapi.yml Raw ↑

Other APIs APIFreaks - API Hub for Developers publishes across the network.

APIFreaks MCP Server
APIFreaks - API Hub for Developers Commodity APIs API
APIFreaks - API Hub for Developers Currency APIs API
APIFreaks - API Hub for Developers DNS APIs API
APIFreaks - API Hub for Developers Domain APIs API
APIFreaks - API Hub for Developers Email Validation APIs API
APIFreaks - API Hub for Developers Financial APIs API
APIFreaks - API Hub for Developers Flags APIs API
APIFreaks - API Hub for Developers General APIs API
APIFreaks - API Hub for Developers Geocoder APIs API
APIFreaks - API Hub for Developers GeoDB APIs API
APIFreaks - API Hub for Developers IP Geolocation APIs API
Where this information came from

This is an independent, third-party profile of APIFreaks - API Hub for Developers Weather APIs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.