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.
URL: https://www.weatherapi.com/
Run: Capabilities Using Naftiko
Weather, Forecast, History, Marine, Astronomy, Geolocation, Sports, Alerts, Public APIs
- Created: 2026-05-28
- Modified: 2026-05-28
Real-time, forecast (up to 14 days, 300-day future tier), historical (since 2010), marine, astronomy, IP lookup, time zone, sports, and weather-alerts API. Single API key auth via the key query parameter. JSON and XML response formats.
Human URL: https://www.weatherapi.com/
Base URL: https://api.weatherapi.com/v1
Weather, Forecast, History, Marine, Astronomy, Geolocation, Sports, Alerts
- Documentation
- APIReference
- OpenAPI
- APIExplorer
- Authentication
- SDK — Python SDK
- SDK — JavaScript SDK
- SDK — PHP SDK
- SDK — Java SDK
- SDK — C# SDK
- SDK — Go SDK
- SDK — Android SDK
- SDK — .NET Standard SDK
- SDK — iOS SDK
- CodeExamples — Multi-language Examples
- NaftikoCapability — WeatherAPI — Weather
- NaftikoCapability — WeatherAPI — History
- NaftikoCapability — WeatherAPI — Future
- NaftikoCapability — WeatherAPI — Marine
- NaftikoCapability — WeatherAPI — Alerts
- NaftikoCapability — WeatherAPI — Geo
- NaftikoCapability — WeatherAPI — Sports
- Website
- GettingStarted
- Portal
- SignUp
- Pricing
- TermsOfService
- PrivacyPolicy
- Support
- Blog
- GitHubOrganization
- PublicAPIsListing
- Tools — MCP Server (Official)
- Tools — weatherapi-mcp on npm
- Plans
- RateLimits
- FinOps
- SpectralRules
- Vocabulary
- JSON-LD
| Name | Description |
|---|---|
| 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. |
| Name | Description |
|---|---|
| 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. |
| Name | Description |
|---|---|
| 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. |
| Name | Description |
|---|---|
| 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. |
Machine-readable API specifications organized by format.
- weatherapi-air-quality-schema.json
- weatherapi-alert-schema.json
- weatherapi-alerts-response-schema.json
- weatherapi-astro-element-schema.json
- weatherapi-astronomy-response-schema.json
- weatherapi-bulk-location-schema.json
- weatherapi-bulk-request-schema.json
- weatherapi-bulk-response-schema.json
- weatherapi-condition-schema.json
- weatherapi-current-weather-response-schema.json
- weatherapi-current-weather-schema.json
- weatherapi-forecast-day-entry-schema.json
- weatherapi-forecast-day-schema.json
- weatherapi-forecast-weather-response-schema.json
- weatherapi-hour-forecast-schema.json
- weatherapi-ip-lookup-response-schema.json
- weatherapi-location-schema.json
- weatherapi-marine-forecast-day-schema.json
- weatherapi-marine-hour-schema.json
- weatherapi-marine-weather-response-schema.json
- weatherapi-pollen-schema.json
- weatherapi-search-location-schema.json
- weatherapi-sport-event-schema.json
- weatherapi-sports-response-schema.json
- weatherapi-tide-schema.json
- weatherapi-timezone-response-schema.json
- weatherapi-air-quality-structure.json
- weatherapi-alert-structure.json
- weatherapi-alerts-response-structure.json
- weatherapi-astro-element-structure.json
- weatherapi-astronomy-response-structure.json
- weatherapi-bulk-location-structure.json
- weatherapi-bulk-request-structure.json
- weatherapi-bulk-response-structure.json
- weatherapi-condition-structure.json
- weatherapi-current-weather-response-structure.json
- weatherapi-current-weather-structure.json
- weatherapi-forecast-day-entry-structure.json
- weatherapi-forecast-day-structure.json
- weatherapi-forecast-weather-response-structure.json
- weatherapi-hour-forecast-structure.json
- weatherapi-ip-lookup-response-structure.json
- weatherapi-location-structure.json
- weatherapi-marine-forecast-day-structure.json
- weatherapi-marine-hour-structure.json
- weatherapi-marine-weather-response-structure.json
- weatherapi-pollen-structure.json
- weatherapi-search-location-structure.json
- weatherapi-sport-event-structure.json
- weatherapi-sports-response-structure.json
- weatherapi-tide-structure.json
- weatherapi-timezone-response-structure.json
- weatherapi-air-quality-example.json
- weatherapi-alert-example.json
- weatherapi-alerts-response-example.json
- weatherapi-astro-element-example.json
- weatherapi-astronomy-response-example.json
- weatherapi-bulk-location-example.json
- weatherapi-bulk-request-example.json
- weatherapi-bulk-response-example.json
- weatherapi-condition-example.json
- weatherapi-current-weather-example.json
- weatherapi-current-weather-response-example.json
- weatherapi-forecast-day-entry-example.json
- weatherapi-forecast-day-example.json
- weatherapi-forecast-weather-response-example.json
- weatherapi-hour-forecast-example.json
- weatherapi-ip-lookup-response-example.json
- weatherapi-location-example.json
- weatherapi-marine-forecast-day-example.json
- weatherapi-marine-hour-example.json
- weatherapi-marine-weather-response-example.json
- weatherapi-pollen-example.json
- weatherapi-search-location-example.json
- weatherapi-sport-event-example.json
- weatherapi-sports-response-example.json
- weatherapi-tide-example.json
- weatherapi-timezone-response-example.json
Self-contained Naftiko capability files (one per OpenAPI tag), each declaring inline consumes + REST + MCP adapters.
| Capability | Operations | MCP Tools | File |
|---|---|---|---|
| WeatherAPI.com — Alerts | 1 | 1 | weatherapi-alerts.yaml |
| WeatherAPI.com — Future | 1 | 1 | weatherapi-future.yaml |
| WeatherAPI.com — Geo | 4 | 4 | weatherapi-geo.yaml |
| WeatherAPI.com — History | 1 | 1 | weatherapi-history.yaml |
| WeatherAPI.com — Marine | 1 | 1 | weatherapi-marine.yaml |
| WeatherAPI.com — Sports | 1 | 1 | weatherapi-sports.yaml |
| WeatherAPI.com — Weather | 3 | 3 | weatherapi-weather.yaml |
- WeatherAPI Vocabulary — Unified taxonomy mapping 12 resources, 3 actions, 7 workflows, and 4 personas across operational (OpenAPI) and capability (Naftiko) dimensions.
- WeatherAPI Spectral Rules — 37 Spectral rules enforcing WeatherAPI.com API conventions (path .json suffix, camelCase operationIds, snake_case schema properties, ApiKeyAuth via query parameter, Title Case tags, provider-prefixed summaries).
- Plans & Pricing — 5 tiered subscription plans (Free, Starter, Pro+, Business, Enterprise) using API Commons Plans 0.1.
- Rate Limits — Monthly call quotas (100K → 10M+) and per-account scope, using API Commons Rate Limits 0.1.
- FinOps — FOCUS-aligned FinOps mapping for tiered subscription billing.
- Kin Lane — kin@apievangelist.com