Documentation

The deprecation is part of a broader effort to improve service accuracy, data quality, and system performance. We strongly encourage all users to begin transitioning to our modern, production-grade APIs — One Call API API®, Current Weather Data, and Geocoding API — and to use Bulk Download for efficiently retrieving large-scale data to ensure uninterrupted access to accurate, scalable, and continuously supported weather services. Please note that support for the deprecated products will end on July 31, 2025. After this date, these products will no longer be available.

One Call API  is a unified weather intelligence API designed to give developers, digital products, and enterprise teams access to current weather, short-term forecasts, long-range daily outlooks, historical weather records, and official weather alerts through a single integration. 

One Call API, endpoint version 4.0, key features include:

• Current weather conditions
• Minute-by-minute forecast data for the next 60 minutes
• 15-minute forecast data for the next 48 hours
• Hourly weather timelines spanning 47+ years years of history and 48 hours of forecast
• Daily weather timelines spanning 47+ years years of history and up to 1.5 years ahead
• Detailed weather alert information from national agencies

Rate limits:

You can make up to 1,000 API calls per day to the One Call API at no cost. This free quota is available to all users, regardless of subscription. One Call API requires a separate subscription for usage beyond the free limit and is not included in the standard Free plan. Additional usage is billed automatically based on actual API consumption at the end of each billing period.

1. Visit the pricing page and click the 'Subscribe' button in the "One Call API" section. Fill out a short billing form and complete your subscription. Please note that you do not need to sign up for any other subscriptions to get access to the One Call API. Once you subscribe to the One Call API, 2,000 API calls per day to this product are set up by default. If you want to change this limit, please go to the "Billing plans" tab in your Personal account to update standard settings. You can find more information in the FAQ or ask Ulla, OpenWeather AI assistant.
2. Select the desired data type and make an API call according to the relevant technical documentation section, remembering to add your key to each call.

If you want to get the current weather with the One Call API, endpoint version 4.0, please use the section below.

Please find more about One Call API, endpoint version 4.0, at the documentation page and FAQ.

The Current Weather Data provides instant access to real-time weather conditions for any location around the globe. It is designed to deliver essential weather parameters in a fast and lightweight format, making it ideal for use cases that require up-to-date observations without additional forecast or historical layers.

Key features include:

• Real-time weather data, including temperature, pressure, humidity, wind, cloudiness, visibility, and weather conditions
• Global coverage with support for city name, city ID, geographic coordinates, or ZIP/postal code queries
• Multiple unit formats (metric, imperial, standard)
• Optimized for high-frequency and performance-sensitive applications (e.g. dashboards, widgets, mobile apps)
• Fast response time with low payload size

Rate limits:

The Current Weather Data API is included in the Free plan, which allows up to 60 calls per minute and 1,000,000 calls per month. Higher limits are available in paid plans.

The OpenWeather Bulk Download service provides large-scale precompiled weather data files for efficient access to current conditions, forecasts, or extensive historical archives. Unlike real-time API calls, Bulk Download supplies ready-made datasets, significantly simplifying data management and reducing operational overhead.

Key features include:

• Large-scale data delivery: Access weather data for tens of thousands of locations simultaneously (e.g., 22,600+ global cities or 41,000+ ZIP codes in the US).
• Comprehensive datasets: Includes current weather conditions, forecasts (hourly or daily), and extensive historical records—available in structured JSON or CSV files.
• Scheduled updates: Data files updated hourly or daily, delivered reliably through direct download, FTP, AWS S3 buckets, or other custom delivery options.
• Reduced complexity: Eliminates the need for extensive API management, error handling, and aggregation logic.
• Custom datasets available: Tailor-made bulk data files created according to your specific list of locations and data parameters.

Bulk Download is ideal for applications requiring extensive, consistent datasets—such as analytics platforms, large-scale monitoring systems, research projects, or historical data archives.

The Bulk Download service is offered under OpenWeather’s Professional, Expert and Enterprise subscription plans. Custom bulk datasets and enterprise-grade support options are available upon request.

Please contact us to discuss your bulk data requirements.

Example datasets include:

• Current weather data for ~22,635 global cities, updated hourly.
• 16-day daily forecasts for 209,000+ locations worldwide.
• Historical hourly weather data for selected regions, spanning multiple years.

Rate limits:

Bulk Download does not use traditional API calls; therefore, standard API rate limits do not apply. Data is provided as downloadable files, simplifying consumption at any scale.

Please find more about Bulk Download at the documentation page and FAQ

The OpenWeather Geocoding API provides robust location-based services through two main endpoints:

• Direct Geocoding: Convert city names, ZIP/postal codes, and other location identifiers into geographic coordinates (latitude and longitude).
• Reverse Geocoding: Retrieve location names from geographic coordinates.

Key features include:

• Support for partial names, multiple languages, and country filtering
• Ability to fetch up to 5 location results per query, ranked by importance or population
• Worldwide coverage, including small towns and rural locations
• Fast and reliable performance for real-time applications

Rate limits:

The Geocoding API is included in the Free plan, which allows up to 60 calls per minute and 1,000,000 calls per month. Higher limits are available in paid plans.

Please find more about Geocoding API at the documentation page and FAQ

If you’ve reviewed the material above but are still unsure how to proceed, this section outlines a structured, step-by-step approach to help you move forward with clarity.

Prepare a list of locations you’re interested in:

You can organize your locations as follows:

• For Group By, list city names or precise geographical points (e.g., cities, towns, neighborhoods).
• For BBOX, clearly define a bounding box area. Identify its four coordinate points (latitude and longitude for the top-left and bottom-right corners). This bounding box represents the geographical area for which you need weather data.

Convert locations into geographical coordinates using the Geocoding API

• Group By: Use Direct Geocoding to retrieve latitude and longitude for each specific location.
• BBOX: Typically, you already have the required coordinates for your bounding box.

Choose your OpenWeather alternative service:

• One Call API: For detailed forecasts, historical weather data, aggregated weather information, and more extensive datasets.
• Current Weather Data: For instant access to current weather conditions only.
• Bulk Download: For retrieving large-scale precompiled weather datasets, particularly suitable for extensive location lists or reducing high-volume API calls.

Make API calls to your selected service:

• Use your API key to access Current Weather Data or One Call API. Please note that the One Call API is included only in the "One Call API" subscription. No other OpenWeather subscription plans are required to access the One Call API. For more information, please visit the pricing page and FAQ, or ask Ulla, the OpenWeather AI assistant. Bulk Download is available as part of a subscription plan. Customised Bulk Downloads can be purchased separately upon request.
• Use the coordinates obtained earlier from the Geocoding API.
• Check the API response and integrate the results into your application or workflow.

Verify and complete migration before July 31, 2025

Make sure your application fully utilizes the new endpoints before the legacy endpoints (BBOX, Group By) are deprecated.