Tomorrow.io Weather API Documentation
This documentation serves as a structured reference for Large Language Models (LLMs) to understand and generate accurate code for the Tomorrow.io Weather API. Each endpoint is documented on its own page with comprehensive information about API structure, parameters, and response formats.
API Reference Overview
Tomorrow.io's Weather API provides developers with access to comprehensive weather data including forecasts, real-time conditions, historical data, and customized timelines. The API is available through several specialized endpoints, each designed for specific weather data needs.
Available Weather APIs
Tomorrow.io provides specialized weather APIs organized by use case and data type. Each endpoint is optimized for specific weather data needs.
Real-Time Weather
Get current weather conditions and immediate forecasts
Weather Forecasting
Access detailed weather predictions and forecast data
Historical Weather
Access past weather data for analysis and research
Data Layers & References
Comprehensive references for weather data fields and codes
Comprehensive overview of 80+ weather data fields including weather, air quality, pollen, and fire index with timestep availability and field descriptors
Specialized Services
Advanced weather services for specific use cases
Authentication
All API requests require authentication using an API key. You can obtain an API key by signing up at Tomorrow.io.
API keys should be included as the apikey parameter in all requests:
https://api.tomorrow.io/v4/weather/forecast?location=london&apikey=[YOUR_API_KEY]Common Parameters
The following parameters are common across multiple API endpoints:
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
location | String | [Number, Number] | Required | Address, city name, ZIP code, or lat,lon coordinates | london or 40.7128,74.0060 |
units | String | Optional | Units for the response data (imperial or metric) | imperial |
apikey | String | Required | Your Tomorrow.io API key | YOUR_API_KEY |
Reference Documentation
Data Fields Reference
Comprehensive documentation for weather data fields available across different APIs.
Weather Data Layers
Comprehensive overview of 80+ weather data fields with timestep availability and field descriptors
Core Data Fields
Standard weather fields available across forecast and real-time APIs
Historical Data Fields
Complete field reference for historical weather data with availability and aggregation options
Additional Resources
Supporting documentation and implementation guides.