Nubila API provides a comprehensive set of endpoints for accessing weather data, enabling developers to easily retrieve weather information for specific geographical locations. The API offers two primary modes of data retrieval:
Current Weather Data - Get real-time weather conditions for a specific location
Weather Forecast Data - Access weather forecasts for a specific location
Our API delivers detailed weather information, including key meteorological data such as temperature, humidity, wind speed, and atmospheric pressure, along with additional information like weather conditions, UV index, and more. All data is returned in a standardized JSON format for seamless integration into various applications.
What sets Nubila apart is our unique decentralized weather data collection network. Unlike traditional weather APIs that rely on sparse conventional weather stations, Nubila leverages tens of thousands of decentralized weather stations distributed worldwide. This extensive network enables us to:
Provide Hyperlocal Data - Access precise weather information for specific locations rather than interpolated regional data
Deliver Real-Time Updates - Get current conditions from actual on-site measurements
Ensure Higher Accuracy - Benefit from dense sensor coverage that captures microclimate variations
Cover More Locations - Access data from areas traditionally underserved by conventional weather stations
Our decentralized approach to weather data collection results in more granular, accurate, and timely weather information compared to traditional meteorological services.
Simple Authentication - API Key-based authentication system
Standardized Format - All responses in structured JSON format
Precise Geolocation - Weather data based on exact latitude and longitude coordinates
Rich Weather Parameters - Comprehensive meteorological data points
Customization Support - Custom development services available based on specific requirements
We offer two service plans to meet different user needs:
Basic weather data access
Standard API functionality
Basic technical support
Full weather data access
Priority technical support
Custom development support
Advanced features
Note: Rate limits and usage restrictions on API calls may be implemented based on user requirements and service conditions. We recommend describing your intended use case and requirements during the application process so we can provide the most suitable solution.
To start using the Nubila API, follow these steps:
Request Access
Choose your preferred service plan (Free/Premium)
Submit the apply form with your e-mail and use case on our website
Specify any customization requirements if needed
Obtain Credentials
Receive your unique API Key
Review documentation and best practices
Begin Integration
Prepare the latitude and longitude coordinates for your locations of interest
Choose the appropriate endpoint for your needs:
/api/v1/weather for current weather data
/api/v1/forecast for weather forecasts
The following sections provide detailed information about each API endpoint, including usage instructions and parameter specifications.
The endpoint provides the user the ability to check the forecast of a location based on geographical coordinates.
Authentication is achieved by passing a custom header named X-Api-Key containing the API key.
https://api.nubila.ai/api/v1/forecast
Parameters
lat
Yes
number
Latitude value for the requested area
37.2144
lon
Yes
number
Longitude value for the requested area
-121.8574
Example Request
Example Response (success)
Example response (error)
ok (boolean): Indicates whether the request was successful.
message (string): In case of unsuccessful request, a message explaining why the request failed
error_code (number): System error code representing the error
data (array): Contains an array of objects, representing forecast for a given timestamp, at hourly intervals
data objects’ fieldsid (string): Unique identifier for the weather data record.
created_at (string, ISO 8601): Timestamp when the record was created.
updated_at (string, ISO 8601): Timestamp when the record was last updated.
tag (string): Custom tag (if applicable).
latitude (number): Latitude of the location.
longitude (number): Longitude of the location.
location_name (string): Name of the location.
sea_level (number): Elevation of the location in meters.
temperature (number): Current temperature in degrees Celsius.
temperature_min (number): Minimum recorded temperature in degrees Celsius.
temperature_max (number): Maximum recorded temperature in degrees Celsius.
feels_like (number): Perceived temperature in degrees Celsius (considering wind and humidity).
pressure (number): Atmospheric pressure in hPa (hectopascals).
humidity (number): Humidity percentage.
uv (number): Ultraviolet (UV) index.
luminance (number): Luminance level (exact unit depends on the source).
rain (number): Precipitation level in millimeters.
wet_bulb (number): Wet-bulb temperature in degrees Celsius (a measure of temperature considering humidity).
wind_speed (number): Wind speed in meters per second.
wind_direction (number): Wind direction in degrees (0-360, where 0 represents north).
condition (string): General weather condition (e.g., “Clouds”, “Rain”).
condition_desc (string): Detailed weather description (e.g., “overcast clouds”).
condition_code (number): Numeric code representing the weather condition.
condition_icon (string): Icon identifier for the weather condition.
timestamp (number): Unix timestamp (seconds since epoch) representing the time for which the weather is predicted.
timezone (number): Timezone offset in seconds from UTC.
source (string): Source of the weather data (e.g., “o” for OpenWeather).
The endpoint provides the user the ability to check the current weather based on geographical coordinates.
Authentication is achieved by passing a custom header named X-Api-Key containing the API key.
https://api.nubila.ai/api/v1/weather
Parameters
lat
Yes
Latitude value for the requested area
37.2144
lon
Yes
Longitude value for the requested area
-121.8574
Example Request
Example Response (success)
Example response (error)
ok (boolean): Indicates whether the request was successful. true indiciates successful request
message (string): In case of unsuccessful request, a message explaining why the request failed
error_code (number): System error code representing the error
data (object): Contains the weather information object
id (string): Unique identifier for the weather data record.
created_at (string, ISO 8601): Timestamp when the record was created.
updated_at (string, ISO 8601): Timestamp when the record was last updated.
latitude (number): Latitude of the location.
longitude (number): Longitude of the location.
location_name (string): Name of the location.
address (string): Address of the location (if available).
elevation (number): Elevation of the location in meters.
temperature (number): Current temperature in degrees Celsius.
temperature_min (number): Minimum recorded temperature in degrees Celsius.
temperature_max (number): Maximum recorded temperature in degrees Celsius.
feels_like (number): Perceived temperature in degrees Celsius (considering wind and humidity).
pressure (number): Atmospheric pressure in hPa (hectopascals).
humidity (number): Humidity percentage.
uv (number): Ultraviolet (UV) index.
luminance (number): Luminance level (exact unit depends on the source).
rain (number): Precipitation level in millimeters.
wet_bulb (number): Wet-bulb temperature in degrees Celsius (a measure of temperature considering humidity).
wind_speed (number): Wind speed in meters per second.
wind_scale (number): Wind scale (e.g., Beaufort scale).
wind_speed_list (array|null): List of wind speed values over time (if available).
wind_scale_list (array|null): List of wind scale values over time (if available).
wind_direction (number): Wind direction in degrees (0-360, where 0 represents north).
condition (string): General weather condition (e.g., “Clouds”, “Rain”).
condition_desc (string): Detailed weather description (e.g., “overcast clouds”).
condition_code (number): Numeric code representing the weather condition.
condition_icon (string): Icon identifier for the weather condition.
timestamp (number): Unix timestamp (seconds since epoch) representing the data retrieval time.
timezone (number): Timezone offset in seconds from UTC.
source (string): Source of the weather data (e.g., “o” for OpenWeather).
tag (string): Custom tag (if applicable).
is_online (boolean): Indicates whether the weather station or source is online.
is_malfunction (boolean): Indicates whether there is a malfunction in the data source.