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
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
Specify any customization requirements if needed
The following sections of and provide detailed information about each API endpoint, including usage instructions and parameter specifications.
Nubila API delivers hyperlocal, real-time weather data to power smarter decision-making across a wide range of industries and applications. Below are eight key sectors where Nubila’s weather intelligence creates tangible value, each with some practical examples. These examples highlight key sectors, but the capabilities of the Nubila API extend far beyond—limited only by your imagination and implementation needs.
Enable climate-resilient farming using hyperlocal, real-time weather data.
Adjust irrigation systems dynamically based on live humidity, rainfall, and evaporation data to reduce water waste.
Crop Disease Forecasting
Use humidity, temperature, and wet bulb readings to predict fungal disease outbreaks and take preventive actions.
Machinery Scheduling Optimization
Schedule planting or fertilization based on wind and rain forecasts to avoid downtime or crop damage.
Enhance risk prediction and pricing accuracy in financial services.
Agri-Insurance Risk Scoring
Leverage historical drought and rainfall patterns to assess risk for different cultivation zones.
Weather Derivatives Modeling
Feed temperature data into HDD/CDD models for weather-linked contracts and financial instruments.
Auto-Triggered Claims Processing
Use real-time wind or rainfall data to automatically initiate claim workflows after verified extreme weather events.
Improve daily convenience, safety, and home automation through contextual weather data.
Automated Curtain and Skylight Control
Close shades when UV is high or rain is approaching, using live weather updates.
Personalized Outfit & Travel Suggestions
Recommend attire or remind users to bring umbrellas based on local temperature and forecast.
Elderly & Child Care Alerts
Notify caregivers when strong winds or large temperature swings make outdoor activities risky.
Protect participants and enhance experience in recreational and competitive outdoor activities.
Optimal Exercise Time Suggestion
Recommend ideal training windows based on weather conditions such as wind and UV index.
Event Day Monitoring
Adapt race logistics (e.g., for marathons) using real-time heat, humidity, and storm alerts.
Extreme Weather Contingency Plans
Automatically monitor conditions and notify organizers if thresholds for postponement or cancellation are met.
Make smarter routing and planning decisions for both personal and commercial travel.
Flight Risk Assessment
Predict delays using real-time wind, pressure, and storm condition inputs at departure and arrival points.
Smart Road Trip Planner
Adapt travel routes based on up-to-the-hour precipitation, fog, or storm forecasts.
Tourist Experience Optimizer
Suggest outdoor vs indoor activities based on forecasted sunshine, wind, or rain for better visitor satisfaction.
Maintain control over sensitive environments and prevent disruptions across industrial sites.
Climate-Sensitive Goods Monitoring
Track real-time temperature and humidity in warehouses to protect pharmaceuticals, perishables, or electronics.
Wind Turbine Maintenance Scheduling
Use forecasted wind speed and direction data to plan safe and efficient turbine inspections or servicing.
Chemical Plant Safety Automation
Automatically trigger safety measures if rain or wind thresholds are exceeded near hazardous storage areas.
Minimize disruption and improve customer experience across delivery networks.
Cold Chain Transport Monitoring
Ensure temperature-sensitive goods remain within safe ranges during transit using external weather feeds.
Last-Mile Dispatch Optimization
Adjust delivery routes and ETAs based on real-time weather alerts like thunderstorms or heat waves.
Preemptive Rescheduling
Use forecast insights to plan for rerouting or pre-delivery communication ahead of adverse conditions.
Empower cities to respond to changing environmental conditions with precision.
Urban Flood Mitigation
Forecast intense rainfall and activate stormwater pumps or issue public alerts before critical thresholds are crossed.
Heat Island Detection & Cooling Strategy
Identify and monitor urban heat pockets to plan interventions like tree planting or misting systems.
Emergency Broadcast Integration
Push localized storm, wind, or heat warnings through integrated public communication channels.
Customization Support - Custom development services available based on specific requirements
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
X-Api-Keyhttps://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.
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.
X-Api-Keyhttps://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
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.
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.
curl -X GET \
--location "https://api.nubila.ai/api/v1/weather?lat=37.2144&lon=-121.8574" \
-H "X-Api-Key: 13...5c"curl -X GET --location "https://api.nubila.ai/api/v1/weather?lat=37.2144&lon=-121.8574" \
-H "X-Api-Key: 13...5c"{
"id": "0",
"created_at": "0001-01-01T00:00:00Z",
"updated_at": "0001-01-01T00:00:00Z",
"latitude": 37.2144,
"longitude": -121.8574,
"temperature": 9.7,
"temperature_min": 8.16,
"temperature_max": 10.66,
"feels_like": 7.36,
"pressure": 1016,
"humidity": 61,
"wind_speed": 4.63,
"wind_scale": 0,
"wind_speed_list": null,
"wind_scale_list": null,
"wind_direction": 0,
"condition": "Clouds",
"condition_desc": "overcast clouds",
"condition_code": 804,
"condition_icon": "04n",
"uv": 0,
"luminance": 0,
"elevation": 1016,
"rain": 0,
"wet_bulb": 0,
"timestamp": 1739325314,
"timezone": -28800,
"location_name": "Cambrian Park",
"address": "",
"tag": "",
"is_online": false,
"is_malfunction": false
}{
"ok": false,
"message": "Invalid longitude",
"error_code": 40000
}curl -X GET \
--location "https://api.nubila.ai/api/v1/forecast?lat=37.2144&lon=-121.8574" \
-H "X-Api-Key: 26...4e"curl -X GET --location "https://api.nubila.ai/api/v1/forecast?lat=37.2144&lon=-121.8574" \
-H "X-Api-Key: 26...4e"{
"data": [
{
"id": "0",
"created_at": "0001-01-01T00:00:00Z",
"updated_at": "0001-01-01T00:00:00Z",
"latitude": 37.2144,
"longitude": -121.8574,
"temperature": 11.54,
"temperature_min": 11.2,
"temperature_max": 11.54,
"feels_like": 10.55,
"pressure": 1011,
"humidity": 69,
"wind_speed": 2.22,
"wind_direction": 0,
"condition": "Clouds",
"condition_desc": "broken clouds",
"condition_code": 803,
"condition_icon": "04d",
"uv": 0,
"luminance": 0,
"sea_level": 1011,
"rain": 0,
"wet_bulb": 0,
"timestamp": 1739394000,
"timezone": -28800,
"location_name": "Cambrian Park, US",
"source": "o",
"tag": ""
},
{
"id": "0",
"created_at": "0001-01-01T00:00:00Z",
"updated_at": "0001-01-01T00:00:00Z",
"latitude": 37.2144,
"longitude": -121.8574,
"temperature": 11.24,
"temperature_min": 10.65,
"temperature_max": 11.24,
"feels_like": 10.3,
"pressure": 1011,
"humidity": 72,
"wind_speed": 2.24,
"wind_direction": 0,
"condition": "Clouds",
"condition_desc": "broken clouds",
"condition_code": 803,
"condition_icon": "04d",
"uv": 0,
"luminance": 0,
"sea_level": 1011,
"rain": 0,
"wet_bulb": 0,
"timestamp": 1739404800,
"timezone": -28800,
"location_name": "Cambrian Park, US",
"tag": ""
}
],
"ok": true
}{
"ok": false,
"message": "Invalid longitude",
"error_code": 40000
}Nubila API is a next-generation weather data service that revolutionizes how developers access meteorological information. Built on a unique decentralized network of tens of thousands of weather stations worldwide, Nubila delivers hyperlocal, real-time weather data with unprecedented accuracy and coverage.
Unlike traditional weather services that rely on sparse conventional stations, our distributed sensor network captures precise microclimate variations, providing you with actual on-site measurements rather than interpolated regional estimates. Whether you need current conditions or detailed forecasts, Nubila API offers comprehensive weather intelligence through simple, standardized endpoints.
What makes Nubila different:
Hyperlocal precision - Get weather data for exact coordinates, not approximated regions
Real-time accuracy - Access live measurements from our extensive sensor network
Global coverage - Reach locations traditionally underserved by conventional weather stations
Developer-friendly - Simple API key authentication with structured JSON responses
Ready to integrate superior weather data into your applications? Let's get started.