Weatherstack API
The Weatherstack API is a RESTful JSON service delivering global real-time, historical, and forecast weather data—plus location autocomplete and marine weather support. Trusted by over 75,000 organizations, Weatherstack offers fast, accurate weather insights via secure HTTPS endpoints.
API Documentation
Welcome to the Weatherstack API documentation. Using the instructions and interactive code examples below, you will be able to start making API requests in a matter of minutes. If you already have an account and prefer to skip our detailed documentation, you can also proceed directly to our 3-Step Quickstart Guide.
The Weatherstack API was built to deliver accurate weather data for any application and use case, from real-time and historical weather information to 14-day weather forecasts, supporting all major programming languages. Our straightforward API design will make it easy to use the API — continue reading below to get started.
API Endpoints Summary
| Endpoint | Description | Available Plans |
|---|---|---|
| /current | Retrieve real-time weather for specified locations | Free and above |
| /historical | Fetch historical weather for specific dates or date ranges | Standard and higher |
| /forecast | Get multi-day weather forecasts (up to 14 days) | Professional and above |
| /marine | Access marine weather data by coordinates | Standard and above |
| /locations | Autocomplete locations (cities, regions, IPs, zip codes) | Standard and above |
Query Behavior Notes
- Each location/date pair in a bulk request consumes one API call.
- Use
units(m,s,f) to control temperature output. - Setting
languageyields localized description arrays. - Debugging mode (
format=1) outputs pretty-printed JSON for easier readability—disable for production.
Why Choose Weatherstack?
- Comprehensive global coverage across millions of locations
- Reliable data sources with real-time accuracy and historical continuity
- Developer-first design: lightweight JSON, intuitive params, code examples
- Flexible scalability: from basic free access to enterprise-grade throughput
Rich feature set: forecasts, marine data, location lookup, and multilingual support