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 makes it easy to use — 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 language yields 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

Chat with APILayer´s team on Discord.

\n\n\n\n \n Questions? \n \n Contact Sales\n .\n\n

\n\n\n\n \n Need help? \n \n Contact Support\n .\n\n

\n\n\n \n Check out our \n \n Changelog\n .\n\n

\n\n \n\n \n

","contentUpdatedAt","Mon, 23 Mar 2026 17:45:59 GMT","generatorLanguages","SHUBApiDetails","exploreUrl","currentToc",{"_69":231,"_232":233,"_225":234,"_235":236,"_160":560},[],"shubUrl","apiRenderer","TOGGLE","routingSettings",{"_566":567,"_568":19},"routing","browser","credentialsEnabled","isTemplatePreview","metaInfo",{"_572":573,"_204":205,"_225":574},"canonicalUrl","https://docs.apilayer.com/weatherstack/docs/api-documentation","Weatherstack API | Weatherstack | APILayer ","actionData","errors"]