Tomorrow.io website screenshot

Tomorrow.io

Tomorrow.io is a weather and climate intelligence platform exposing a unified v4 HTTP API. The API combines real-time observations, hyperlocal forecast timelines (minutely / hourly / daily), 20+ years of historical data, climate normals, weather-on-routes, configurable insights and event detection, per-location alerts with webhook delivery, and raster map tiles. 60+ data layers cover core weather, air quality, pollen, fire, flood, soil, solar, aviation, maritime, and lightning.

Tomorrow.io publishes 11 APIs on the APIs.io network, including Alerts API, Climate API, Events API, and 8 more. Tagged areas include Weather, Climate, Forecast, Historical Weather, and Air Quality.

The Tomorrow.io catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Tomorrow.io’s developer surface includes authentication, documentation, pricing, signup flow, status page, engineering blog, support, and 16 more developer resources.

54.3/100 developing ▼ -6.1 Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
11 APIs
WeatherClimateForecastHistorical WeatherAir QualityPollenFireFloodRoutesMap TilesAviationMaritimePublic APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 54.3/100 · developing
Contract Quality 15.0 / 25
Developer Ergonomics 6.1 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 6.8 / 13
Governance 8.3 / 12
Discoverability 8.2 / 10
Agent readiness — 37/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/tomorrow: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

Tomorrow.io Alerts API

Persistent alerts linked to one or more locations with webhook delivery.

Tomorrow.io Climate API

30-year climate normals for a location.

Tomorrow.io Events API

Query events matching insights at a location or buffered geometry.

Tomorrow.io Forecast API

Hourly and daily forecast timelines via a simple GET interface.

Tomorrow.io Historical API

Historical weather data for a point or polygon, up to 20 years back.

Tomorrow.io Insights API

Define threshold rules over weather fields to detect business-significant events.

Tomorrow.io Locations API

CRUD over monitored point / polygon / polyline locations with tags.

Tomorrow.io Map Tiles API

Raster tile endpoint for weather field overlays.

Tomorrow.io Realtime API

Current-conditions snapshot for a single location.

Tomorrow.io Routes API

Weather along a polyline / list of waypoints with arrival-time interpolation.

Tomorrow.io Timelines API

Advanced multi-step (minutely / hourly / daily / current) forecast and historical timelines.

Scroll for all 11

Postman Collections 11

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 11

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Tomorrow.io Weather API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Tomorrow Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Tomorrow Weather Api Context

27 classes · 84 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Tomorrow.io API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Tomorrow.io API Rules

48 rules · 19 errors 27 warnings 2 info

SPECTRAL

JSON Schema 27

Standalone JSON Schema definitions for this provider's data models.

AlertCreateRequest

6 properties

JSON SCHEMA

AlertLocationLinkRequest

1 properties

JSON SCHEMA

Alert

8 properties

JSON SCHEMA

ClimateNormalsRequest

3 properties

JSON SCHEMA

ClimateNormalsResponse

1 properties

JSON SCHEMA

Event

5 properties

JSON SCHEMA

EventsRequest

3 properties

JSON SCHEMA

EventsResponse

1 properties

JSON SCHEMA

ForecastResponse

2 properties

JSON SCHEMA

GeoJSONGeometry

2 properties

JSON SCHEMA

HistoricalRequest

7 properties

JSON SCHEMA

InsightCondition

3 properties

JSON SCHEMA

InsightCreateRequest

6 properties

JSON SCHEMA

Insight

9 properties

JSON SCHEMA

LocationCreateRequest

3 properties

JSON SCHEMA

Location

6 properties

JSON SCHEMA

LocationTagsRequest

2 properties

JSON SCHEMA

LocationUpdateRequest

3 properties

JSON SCHEMA

RealtimeWeatherResponse

2 properties

JSON SCHEMA

RouteRequest

3 properties

JSON SCHEMA

RouteResponse

1 properties

JSON SCHEMA

RouteWaypoint

2 properties

JSON SCHEMA

TimelineInterval

2 properties

JSON SCHEMA

Timeline

4 properties

JSON SCHEMA

TimelinesRequest

8 properties

JSON SCHEMA

TimelinesResponse

1 properties

JSON SCHEMA

WeatherValues

37 properties

JSON SCHEMA

Scroll for all 27

JSON Structure 27

JSON Structure definitions describing this provider's data shapes.

Alert Create Request Structure

6 properties

JSON STRUCTURE

Alert Location Link Request Structure

1 properties

JSON STRUCTURE

Alert Structure

8 properties

JSON STRUCTURE

Climate Normals Request Structure

3 properties

JSON STRUCTURE

Climate Normals Response Structure

1 properties

JSON STRUCTURE

Event Structure

5 properties

JSON STRUCTURE

Events Request Structure

3 properties

JSON STRUCTURE

Events Response Structure

1 properties

JSON STRUCTURE

Forecast Response Structure

2 properties

JSON STRUCTURE

Geo Jsongeometry Structure

2 properties

JSON STRUCTURE

Historical Request Structure

7 properties

JSON STRUCTURE

Insight Condition Structure

3 properties

JSON STRUCTURE

Insight Create Request Structure

6 properties

JSON STRUCTURE

Insight Structure

9 properties

JSON STRUCTURE

Location Create Request Structure

3 properties

JSON STRUCTURE

Location Structure

6 properties

JSON STRUCTURE

Location Tags Request Structure

2 properties

JSON STRUCTURE

Location Update Request Structure

3 properties

JSON STRUCTURE

Realtime Weather Response Structure

2 properties

JSON STRUCTURE

Route Request Structure

3 properties

JSON STRUCTURE

Route Response Structure

1 properties

JSON STRUCTURE

Route Waypoint Structure

2 properties

JSON STRUCTURE

Timeline Interval Structure

2 properties

JSON STRUCTURE

Timeline Structure

4 properties

JSON STRUCTURE

Timelines Request Structure

8 properties

JSON STRUCTURE

Timelines Response Structure

1 properties

JSON STRUCTURE

Weather Values Structure

37 properties

JSON STRUCTURE

Scroll for all 27

Examples 27

Example request and response payloads for these APIs.

Alert Example

8 fields

EXAMPLE

Event Example

5 fields

EXAMPLE

Events Request Example

3 fields

EXAMPLE

Events Response Example

1 fields

EXAMPLE

Forecast Response Example

2 fields

EXAMPLE

Geo Jsongeometry Example

2 fields

EXAMPLE

Insight Condition Example

3 fields

EXAMPLE

Insight Example

9 fields

EXAMPLE

Location Example

6 fields

EXAMPLE

Route Request Example

3 fields

EXAMPLE

Route Response Example

1 fields

EXAMPLE

Route Waypoint Example

2 fields

EXAMPLE

Timeline Example

4 fields

EXAMPLE

Timeline Interval Example

2 fields

EXAMPLE

Timelines Request Example

8 fields

EXAMPLE

Weather Values Example

37 fields

EXAMPLE

Scroll for all 27

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Tomorrow Authentication

apiKey · 1 scheme

SECURITY

Tomorrow Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Tomorrow Agentic Access

32 operations · 20 acting

32 operations · 20 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 3

Authentication, authorization, and security posture

Operate 5

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: tomorrow
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/tomorrow.png
name: Tomorrow.io
description: Tomorrow.io is a weather and climate intelligence platform exposing a unified v4 HTTP API. The API combines real-time
  observations, hyperlocal forecast timelines (minutely / hourly / daily), 20+ years of historical data, climate normals,
  weather-on-routes, configurable insights and event detection, per-location alerts with webhook delivery, and raster map
  tiles. 60+ data layers cover core weather, air quality, pollen, fire, flood, soil, solar, aviation, maritime, and lightning.
url: https://docs.tomorrow.io
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-30'
x-type: company
x-source: public-apis/public-apis
x-category: Weather
x-tier: 2
x-tier-reason: enriched-full-pipeline
tags:
- Weather
- Climate
- Forecast
- Historical Weather
- Air Quality
- Pollen
- Fire
- Flood
- Routes
- Map Tiles
- Aviation
- Maritime
- Public APIs
apis:
- aid: tomorrow:tomorrow-alerts-api
  name: Tomorrow.io Alerts API
  description: Persistent alerts linked to one or more locations with webhook delivery.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Alerts
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-alerts-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-climate-api
  name: Tomorrow.io Climate API
  description: 30-year climate normals for a location.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Climate
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-climate-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-events-api
  name: Tomorrow.io Events API
  description: Query events matching insights at a location or buffered geometry.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-events-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-forecast-api
  name: Tomorrow.io Forecast API
  description: Hourly and daily forecast timelines via a simple GET interface.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Forecast
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-forecast-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-historical-api
  name: Tomorrow.io Historical API
  description: Historical weather data for a point or polygon, up to 20 years back.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Historical
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-historical-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-insights-api
  name: Tomorrow.io Insights API
  description: Define threshold rules over weather fields to detect business-significant events.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Insights
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-insights-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-locations-api
  name: Tomorrow.io Locations API
  description: CRUD over monitored point / polygon / polyline locations with tags.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Locations
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-locations-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-map-tiles-api
  name: Tomorrow.io Map Tiles API
  description: Raster tile endpoint for weather field overlays.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Map Tiles
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-map-tiles-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-realtime-api
  name: Tomorrow.io Realtime API
  description: Current-conditions snapshot for a single location.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Realtime
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-realtime-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-routes-api
  name: Tomorrow.io Routes API
  description: Weather along a polyline / list of waypoints with arrival-time interpolation.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Routes
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-routes-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
- aid: tomorrow:tomorrow-timelines-api
  name: Tomorrow.io Timelines API
  description: Advanced multi-step (minutely / hourly / daily / current) forecast and historical timelines.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Timelines
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-timelines-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: Postman
    url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  - type: Signup
    url: https://app.tomorrow.io/signup
  - type: Authentication
    url: https://app.tomorrow.io/development/keys
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  - type: CodeExamples
    url: https://github.com/Tomorrow-IO-API/climate-normals
  - type: WeatherIcons
    url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  - type: MapAssets
    url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/tomorrowio/overview
- type: AgenticAccess
  url: agentic-access/tomorrow-agentic-access.yml
- type: DomainSecurity
  url: security/tomorrow-domain-security.yml
- type: Authentication
  url: authentication/tomorrow-authentication.yml
- type: Website
  url: https://www.tomorrow.io
- type: Documentation
  url: https://docs.tomorrow.io
- type: Pricing
  url: https://www.tomorrow.io/weather-api/
- type: Signup
  url: https://app.tomorrow.io/signup
- type: Authentication
  url: https://app.tomorrow.io/development/keys
- type: GitHubOrganization
  url: https://github.com/Tomorrow-IO-API
- type: GitHubOrganization
  url: https://github.com/tomorrowio
  title: Tomorrow.io (corporate org)
- type: Status
  url: https://tomorrowio.statuspage.io
- type: Blog
  url: https://www.tomorrow.io/blog/
- type: Community
  url: https://github.com/Tomorrow-IO-API/tomorrow-community
- type: Support
  url: https://www.tomorrow.io/support/
- type: ReleaseNotes
  url: https://docs.tomorrow.io/changelog
- type: PublicAPIsListing
  url: https://github.com/public-apis/public-apis
- type: Plans
  url: plans/tomorrow-plans-pricing.yml
- type: RateLimits
  url: rate-limits/tomorrow-rate-limits.yml
- type: FinOps
  url: finops/tomorrow-finops.yml
- type: SpectralRuleset
  url: rules/tomorrow-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/tomorrow-vocabulary.yml
- type: JSONLDContext
  url: json-ld/tomorrow-weather-api-context.jsonld
features:
- name: 60+ Data Layers
  description: Core weather plus air quality (EPA/MEP indices, particulates, pollutants), pollen (tree species, grass, weed),
    fire (FWI), solar (GHI/DIF/DIR), lightning, soil moisture/temperature, marine swell and wave, aviation ceiling/visibility,
    and road conditions.
- name: Forecast Timelines
  description: Single endpoint returns minutely (1m/5m/15m/30m), hourly (1h), daily (1d) and current timesteps for any combination
    of fields. Up to 14 days out on paid plans, 5 days on Free.
- name: Historical Data
  description: Up to 20 years of historical observations for the same field universe as the forecast, retrievable by point
    or polygon.
- name: Climate Normals
  description: 30-year climate normals (monthly averages) for any location, useful for anomaly detection and climate-trend
    reporting.
- name: Weather on Routes
  description: POST a polyline or list of waypoints and receive weather along the route at each segment with arrival-time
    interpolation.
- name: Map Tiles
  description: Raster tile endpoint `/map/tile/{z}/{x}/{y}/{field}/{timeFormat}` for Mapbox, Google Maps, Leaflet, OpenLayers,
    Cesium overlays.
- name: Custom Insights and Events
  description: Define threshold rules (e.g. windSpeed > 15 m/s AND precipitationProbability > 50%) against any field, then
    poll the Events endpoint for matches at a location or buffer.
- name: Alerts with Webhooks
  description: Persistent alert resources linked to one or more locations; activations fire to a webhook destination so downstream
    systems can react in real time.
- name: Locations Management
  description: CRUD on point, polygon, and polyline locations with tag-based grouping, so monitored assets can be addressed
    by ID instead of repeated geometry.
use_cases:
- name: Aviation Operations
  description: Airlines use ceiling, visibility, wind shear, and storm cells along the route to make ground-stop, diversion,
    and de-icing decisions.
- name: Logistics and Routing
  description: Trucking, last-mile delivery, and rail use route-weather and lightning tracking to reroute shipments and reschedule
    outdoor crews.
- name: Energy and Utilities
  description: Wind, solar (GHI/DIF/DIR), and lightning data feed renewable forecasting, grid load planning, and outage prediction.
- name: Agriculture
  description: Soil moisture, soil temperature, evapotranspiration, and growing-degree days drive irrigation, planting, and
    spray-window decisions.
- name: Insurance Underwriting and Claims
  description: Historical hail, wind, and flood data inform underwriting; real-time hail and lightning detection accelerates
    claims triage.
- name: Sports and Live Events
  description: Stadium operators monitor lightning radius and precipitation probability to call delays and protect spectators.
- name: Public Safety and Government
  description: Fire weather (FWI), flood indices, and air-quality (EPA AQI) feed municipal alerting and emergency-management
    workflows.
- name: Retail and CPG
  description: Demand forecasting models use temperature anomalies and weekly weather patterns to plan inventory and promotions.
- name: Maritime and Offshore
  description: Wave height, swell direction, and wind data drive routing, port operations, and offshore platform safety windows.
integrations:
- name: Mapbox
  description: Vector and raster basemaps overlaid with Tomorrow.io map tiles.
- name: Google Maps
  description: JavaScript Maps API overlay support.
- name: Leaflet
  description: Open-source web map tile overlay.
- name: OpenLayers
  description: GIS-grade web map library tile overlay.
- name: Cesium
  description: 3D globe / aviation tile overlay.
- name: Postman
  description: Official Tomorrow.io Postman collection.
- name: Webhooks
  description: Alert activations delivered to any HTTP endpoint.
solutions:
- name: Aviation Weather Intelligence
  description: Route weather, turbulence, icing, ceiling and visibility for flight planning.
- name: Resilience for Logistics
  description: Lightning, hail, and severe-weather alerting for fleets and warehouses.
- name: Renewable Energy Forecasting
  description: Wind and solar generation forecasts with multi-day timelines and historical baselining.
- name: Climate Risk for Insurance
  description: Historical perils + climate-normal anomalies for underwriting and CAT modeling.
- name: Agriculture Decision Support
  description: Soil + growing-condition data for irrigation, planting, and spraying.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com