Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
WeatherAPI website screenshot

WeatherAPI

WeatherAPI.com provides real-time, forecast, historical, marine, future, astronomy, air quality, pollen, sports, IP lookup, time zone, and geolocation data via a JSON/XML REST API. Trusted by 850,000+ developers worldwide with an average ~200ms response time.

agent ready

Solid contracts, transparent operations, and an easy start — typically complete on four or five facets with one clear soft spot.

Kin Score

API Evangelist profiles WeatherAPI the way a machine reads it — 144 machine-readable artifacts across 7 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.

Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — WeatherAPI scores 66.1/100 (strong), with a separate agent-readiness read of 48/100 (agent ready). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.

Kin Score

This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 66.1/100 · strong
Contract Quality 18.4 / 25
Developer Ergonomics 8.3 / 20
Commercial Clarity 14.2 / 20
Operational Transparency 4.8 / 13
Governance 10.4 / 12
Discoverability 10.0 / 10
Agent readiness — 48/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 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

How we profile WeatherAPI

Each block below is one kind of artifact we hold for WeatherAPI. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.

APIs 7

Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.

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

WeatherAPI Alerts API

Government weather alerts

WeatherAPI Future API

Long-range future weather (14–300 days)

WeatherAPI Geo API

Location, IP lookup, timezone, astronomy

WeatherAPI History API

Historical weather data

WeatherAPI Marine API

Marine and sailing weather

WeatherAPI Sports API

Upcoming sports events

WeatherAPI Weather API

Real-time and forecast weather endpoints

Scroll within the panel for all 7 ·

Postman Collections 1

A runnable collection turns the contract into something a developer can execute in seconds. We profile them because the fastest way to trust an API is to make a real call against it.

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

Arazzo Workflows 13

Real integrations are rarely a single call. Arazzo describes the multi-step sequences — auth, then create, then confirm — so both a human and an agent can follow the choreography, not just the endpoints.

Multi-step API workflows described with the Arazzo specification.

WeatherAPI Current and Forecast Air Quality

Resolve a location, then fetch current and forecast weather with air quality and pollen enabled.

ARAZZO

WeatherAPI Bulk Current Weather

Retrieve current weather for many locations in a single bulk request.

ARAZZO

WeatherAPI Forecast with Astronomy

Resolve a location, pull a multi-day forecast, then enrich it with astronomy for the same date.

ARAZZO

WeatherAPI Future Weather

Resolve a location, then fetch the long-range future forecast for a date 14-300 days out.

ARAZZO

WeatherAPI Historical Weather

Resolve a location, then fetch historical weather for a past date.

ARAZZO

WeatherAPI IP Geolocated Weather

Geolocate an IP address, then fetch current weather and a forecast for that point.

ARAZZO

WeatherAPI Marine Forecast

Resolve a coastal location, then fetch its marine and tide forecast.

ARAZZO

WeatherAPI Search to Astronomy

Resolve a location with autocomplete search, then fetch sun and moon data for a date.

ARAZZO

WeatherAPI Search to Current Weather

Resolve a location with autocomplete search, then fetch its current weather.

ARAZZO

WeatherAPI Sports Events with Weather

Resolve a location, list its upcoming sports events, then fetch current weather context.

ARAZZO

WeatherAPI Timezone and Local Conditions

Resolve a location, read its timezone and local time, then fetch current weather.

ARAZZO

WeatherAPI Travel Briefing

Build a full travel briefing for a destination — current, forecast, astronomy, and alerts.

ARAZZO

WeatherAPI Weather Alerts Check

Resolve a location, probe its forecast for alerts, then branch to pull full alert detail.

ARAZZO

Scroll within the panel for all 13 ·

Pricing Plans 1

Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.

Published pricing tiers and plan structures.

Rate Limits 1

Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.

Documented rate limits and quota policies.

Weatherapi Rate Limits

7 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.

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

Features 14

The notable capabilities this provider advertises, captured as structured features so they can be searched and compared instead of read one landing page at a time.

Notable capabilities this provider offers.

Real-time Weather

Current conditions refreshed every 10–15 minutes for any global location.

14-Day Forecast

Daily and hourly forecast covering up to 14 days ahead (15-minute interval on Enterprise).

Historical Weather

Past weather data from January 1, 2010 onwards.

Future Weather

Long-range forecasts from 14 to 300 days ahead (Pro+ and above).

Marine Weather

Wave height, swell direction, and tide tables for coastal and ocean locations.

Astronomy

Sunrise, sunset, moonrise, moonset, moon phase, and illumination.

Air Quality and Pollen

US EPA and UK DEFRA indices plus pollen data with current and forecast endpoints.

Weather Alerts

Government-issued warnings worldwide (USA, UK, Europe, and global).

Sports Events

Upcoming football, cricket, and golf events tied to a location.

Geo Services

Location search/autocomplete, IP lookup, and time zone resolution.

Bulk Requests

POST /current.json#bulk accepts up to 50 locations per call (Pro+ and above).

Multilingual Conditions

Condition descriptions in 40+ languages via the `lang` parameter.

JSON and XML Responses

Every endpoint supports `.json` and `.xml` response variants.

Official MCP Server

Drop-in Model Context Protocol server for Claude Desktop, Cursor, and other agents.

Scroll within the panel for all 14 ·

Semantic Vocabularies 1

JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.

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

Weatherapi Context

29 classes · 151 properties

JSON-LD

Spectral Rules 2

Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.

WeatherAPI API Rules

5 rules · 4 warnings

SPECTRAL

WeatherAPI API Rules

37 rules · 11 errors · 21 warnings

SPECTRAL

JSON Schema 26

Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.

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

AirQuality

8 properties

JSON SCHEMA

Alert

13 properties

JSON SCHEMA

AlertsResponse

2 properties

JSON SCHEMA

AstroElement

8 properties

JSON SCHEMA

AstronomyResponse

2 properties

JSON SCHEMA

BulkLocation

2 properties

JSON SCHEMA

BulkRequest

1 properties

JSON SCHEMA

BulkResponse

1 properties

JSON SCHEMA

Condition

3 properties

JSON SCHEMA

CurrentWeatherResponse

2 properties

JSON SCHEMA

CurrentWeather

33 properties

JSON SCHEMA

ForecastDayEntry

5 properties

JSON SCHEMA

ForecastDay

21 properties

JSON SCHEMA

ForecastWeatherResponse

4 properties

JSON SCHEMA

HourForecast

39 properties

JSON SCHEMA

IpLookupResponse

15 properties

JSON SCHEMA

Location

8 properties

JSON SCHEMA

MarineForecastDay

6 properties

JSON SCHEMA

MarineHour

8 properties

JSON SCHEMA

MarineWeatherResponse

2 properties

JSON SCHEMA

Pollen

7 properties

JSON SCHEMA

SearchLocation

7 properties

JSON SCHEMA

SportEvent

6 properties

JSON SCHEMA

SportsResponse

3 properties

JSON SCHEMA

Tide

3 properties

JSON SCHEMA

TimezoneResponse

1 properties

JSON SCHEMA

Scroll within the panel for all 26 ·

JSON Structure 26

JSON Structure captures the data shapes in a form built for tooling — a complement to JSON Schema that keeps the model machine-legible.

JSON Structure definitions describing this provider's data shapes.

Weatherapi Air Quality Structure

8 properties

JSON STRUCTURE

Weatherapi Alert Structure

13 properties

JSON STRUCTURE

Weatherapi Alerts Response Structure

2 properties

JSON STRUCTURE

Weatherapi Astro Element Structure

8 properties

JSON STRUCTURE

Weatherapi Astronomy Response Structure

2 properties

JSON STRUCTURE

Weatherapi Bulk Location Structure

2 properties

JSON STRUCTURE

Weatherapi Bulk Request Structure

1 properties

JSON STRUCTURE

Weatherapi Bulk Response Structure

1 properties

JSON STRUCTURE

Weatherapi Condition Structure

3 properties

JSON STRUCTURE

Weatherapi Current Weather Structure

33 properties

JSON STRUCTURE

Weatherapi Forecast Day Entry Structure

5 properties

JSON STRUCTURE

Weatherapi Forecast Day Structure

21 properties

JSON STRUCTURE

Weatherapi Hour Forecast Structure

39 properties

JSON STRUCTURE

Weatherapi Ip Lookup Response Structure

15 properties

JSON STRUCTURE

Weatherapi Location Structure

8 properties

JSON STRUCTURE

Weatherapi Marine Forecast Day Structure

6 properties

JSON STRUCTURE

Weatherapi Marine Hour Structure

8 properties

JSON STRUCTURE

Weatherapi Pollen Structure

7 properties

JSON STRUCTURE

Weatherapi Search Location Structure

7 properties

JSON STRUCTURE

Weatherapi Sport Event Structure

6 properties

JSON STRUCTURE

Weatherapi Sports Response Structure

3 properties

JSON STRUCTURE

Weatherapi Tide Structure

3 properties

JSON STRUCTURE

Weatherapi Timezone Response Structure

1 properties

JSON STRUCTURE

Scroll within the panel for all 26 ·

Examples 26

Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.

Example request and response payloads for these APIs.

Scroll within the panel for all 26 ·

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.

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

Weatherapi Authentication

apiKey · 1 scheme

SECURITY

Weatherapi Domain Security

TLSv1.3 · DMARC

SECURITY

Agentic Access 1

An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.

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

Weatherapi Agentic Access

12 operations · 1 acting

12 operations · 1 acting

AGENTIC

Use Cases 10

What developers actually build with this provider — captured so the catalogue answers 'what is this for', not just 'what does this expose'.

What developers build with this provider.

Consumer Weather Apps

Power mobile and web weather apps with global coverage and 200ms response times.

Travel & Trip Planning

Show forecast, alerts, marine, and astronomy data for trip destinations.

Logistics & Fleet Routing

Avoid weather disruptions on routes using forecast and alerts endpoints.

Smart Home & IoT

Drive thermostats, sprinklers, and shades from real-time and forecast data.

Agriculture

Use rainfall, evapotranspiration, and forecast data to plan irrigation and harvest.

Energy Forecasting

Solar irradiance, wind, and temperature inputs for renewable-energy generation models.

Insurance & Risk

Historical archives for claims investigation and parametric weather insurance.

Sports & Events

Schedule outdoor events around forecast windows and alerts.

Maritime & Shipping

Wave, swell, and tide data for coastal and ocean operations.

AI Agents

Give Claude and other LLM agents live weather context via the official MCP server.

Scroll within the panel for all 10 ·

Integrations 7

Pre-built integrations with other platforms tell you where this provider already fits in a stack.

Pre-built integrations with other platforms and tools.

Claude Desktop

Drop-in MCP server (weatherapi-mcp) registered in claude_desktop_config.json.

Cursor

MCP integration via .cursor/mcp.json.

Microcks

OpenAPI spec carries `x-microcks-operation` extensions for one-command mocking.

SwaggerHub

Spec is also published on SwaggerHub under WeatherAPI.com / WeatherAPI.

WeatherAI.io

Sibling product providing AI-summarised weather narrative.

Miing.com

Sibling product for air-quality analytics.

Azuce.com

Sibling product for solar forecasting.

Scroll within the panel for all 7 ·

Solutions 5

Packaged solutions the provider offers on top of the raw API surface.

Packaged solutions this provider offers.

Free Tier

100K calls/month, 3-day forecast, 1-day history — for evaluation and hobby use.

Starter ($7/mo)

3M calls/month, 7-day forecast and history — small production workloads.

Pro+ ($25/mo)

5M calls/month, marine weather, bulk requests, 365-day rolling history.

Business ($65/mo)

10M calls/month, 14-day forecast, marine with tides, IP allow/block lists, 99.9% SLA.

Enterprise (custom)

15-minute intervals, full historical archives, 100% uptime SLA with contract.

Resources

Every other property we hold for WeatherAPI — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.

Get Started 3

Portal, sign-up, and the first successful call

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Access & Security 2

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Company 2

The organization behind the API

Other 1

Properties that don't map to a standard resource type

← All providers · Data indexed from github.com/api-evangelist/weatherapi · machine-readable index on apis.io