Skip to main content

Getting Started with OpenWeatherMap

Welcome to the OpenWeatherMap API documentation. This portal provides the technical specifications and implementation guides required to integrate global weather data into your applications.

Our APIs provide high-precision meteorological data, including current weather, historical observations, and hyper-local forecasts.

Core Capabilities​

The OpenWeatherMap ecosystem is built on three primary data pillars:

  • Current Weather: Real-time data for over 200,000 cities, updated every 10 minutes.
  • Forecast Data: Minute-by-minute, hourly, and daily projections.
  • Historical Data: Access to over 40 years of global climate archives.

Quickstart Path​

To begin making requests, follow these three essential steps:

1. Provision an API Key​

All requests to the OpenWeatherMap infrastructure must be authenticated.

2. Verify Your Subscription​

Different endpoints require different subscription tiers (Free, Professional, or Enterprise). Ensure your account has the necessary permissions for the specific endpoint you intend to call.

3. Execute Your First Request​

The simplest way to test your integration is via a GET request using geographic coordinates.

Request Template:

GET [https://api.openweathermap.org/data/2.5/weather?lat=](https://api.openweathermap.org/data/2.5/weather?lat=){lat}&lon={lon}&appid={YOUR_API_KEY}