General

What makes the Weatherbit API different?
Our goal with the Weatherbit API was to build the most powerful, and flexible Weather API possible. Our API emphasizes data quality, and data coverage like no other provider. Our API incorporates over 20 seperate datasets ranging from raw station data, to model data, to atmospheric re-analysis products.

The Weatherbit API has a unique, and distinct advantage over other providers: Real data sourced from the world's most advanced weather datasets including:

  • Weather station data
  • NASA MODIS Satellite data
  • Precipitation radar
  • Weather models
  • Multi-sensor satellite based precipitation (NASA GPM/TRMM)
  • The ERA5 re-analysis
  • The GLDAS re-analysis (Agro API)

Why Weatherbit, and not another provider?
The Weatherbit API's multi-datasource approach to weather data allows it to serve the most relevent, and local data possible. Most weather data providers serve only weather station data, which is inappropriate for most use-cases. Station data alone simply cannot capture data about most significant events due to limited station coverage, and quality.

For example: Our competitors' historical weather API's failed to capture data on a significant rainfall/flooding event in western Uganda.

Subscriptions + Access

What happens when I exceed a rate limit?
When you exceed a daily limit (calls per day) the API will return an HTTP 429 error until the rate limit resets at 00 UTC. When you exceed a per second limit (calls per second) the requests in excess of this limit will receive an HTTP 429 error from the API. If you are hitting any of these limits we recommend either reducing call velocity, retrying requests that fail due to rate limiting, or changing your subscription to one that has higher limits.
What does "1 year historical" access mean?
Depending on the subscribed plan, you may have access to up to 10 years of historical data. For example, the "Pro" plan allows for queries for historical data for dates going back 3 years from the current date.
Does every plan allow historical data access?
No. Currently the "Free" plan allows trial access, and the "Starter" plan does not allow historical data access.
Can I cancel after the first month?
Yes. There are no long-term requirements for our subscriptions. You can cancel anytime by logging in, and downgrading to the "Free" plan. Please refer to our Billing Terms and Conditions for more information.
Can the Free or Trial subscriptions be used commercially?
The Free/Trial subscriptions are available for non-commercial use only under the CC BY-NC License. Only paid subscriptions may use the API commercially.
Can I store data retrieved from the API locally?
Yes, but only with an active commercial license (paid API subscription). You may store data retrieved with any paid API subscription locally, or with service providers (such as AWS, Azure, etc). However, a paid subscription must be maintained for the full duration of storage. If you unsubscribe, any data stored must be deleted. Refer to our Terms and Conditions for more information on acceptable use.
I need to retrieve a lot of historical data, what's the best way to do this?
  • For the best performance when retrieving a large amount of data for many locations: Break up any large request into smaller parts. For example, instead of retrieving one year of data per request - retrieve only 1 month per request.
  • In general, our historical data servers are better optimized to handle many small requests, rather than singular large requests. Smaller concurrent requests are preferred to fewer large requests. However, keep in mind the req/second limitations of your subscription.
  • Add http request retry logic to any long-running script. Preferably with an exponential backoff algorithm.
What is included with Email Support?
For our standard plan options (Starter, Pro, Business) we offer email support at support@weatherbit.io. We make an effort to respond to all inquiries via email within 1-2 business days. Please allow additional time for complex requests.
What is included with Priority Support?
For certain Enterprise plan options we offer a priority support solution. With the priority support option we will respond to all support requests within 24 hours - including off-hours/holidays/weekends/etc.
How do I reset my password?
Visit the login page, and click "Forgot Password". Then follow the instructions provided.

Billing

Where can I find my invoices?
All invoices appear in the account dashboard. To view them, simply login, and select the "Billing / Manage Subscription" tab. Invoices and receipts are also sent monthly to the billing email on your account.
Can I be billed annually?
Yes. Please contact us at support@weatherbit.io if you require annual billing, or custom billing terms.
What payment methods do you accept?
Credit/Debit card for monthly subscriptions. Credit/Debit or bank transfer for annual subscriptions.
How do I modify the invoices to show my Company information?
Simply login, select the "Billing / Manage Subscription" tab, and add your companies information. After your information is updated, the information should appear on any future invoices.
Can I be billed in a different currency?
Yes. Please contact support@weatherbit.io if you would like to be billed in a different currency. Please note, an additional surcharge of 5-10% will apply depending on the currency requested. Additionally, we only support alternate currency billing for annual subscriptions at this time.
Can Weatherbit submit invoices through my businesses' invoice portal?
Yes. However, the following additional conditions will apply. (1) Annual billing is required. (2) An Enterprise subscription may be required if any custom billing terms (ie. NET 45, NET 60), or service terms are required.
Do you offer discounts for Non-Profit businesses?
Yes. We offer a discount on all of our plan options for US Certified 501(c) Non-Profit organizations.

Historical Weather API

Why can't I retrieve more than a month of data in a single API call?
All plans that have access to the Historical Weather API's must break up large requests into several smaller requests. For example, if you are enrolled in the "Business" plan, and want to retrieve hourly historical data for 2017 for a single location, you simply need make 52 total API requests (7 day per call limit).
Does every plan allow historical data access?
No. Historical data is available starting with the "Pro" plan.
Why does the historical data change?

Our database receives data from over 20 different data sources. These data sources feed into our system with varying lag times ranging from 15 minutes (MADIS station data) to 30 days (Re-Analysis data). This can result in historical data being corrected with higher quality observations as the lagging (higher quality) datasets feed in.

You may use the "revision_status" field to determine whether or not you will need to retrieve updated data at a later date. The field will return "interim" for data still awaiting updates, and "final" for data that has been finalized.

As a general practice we recommend occasionally retrieving data for the past ~30 days to obtain these revisions using the "revision_status" to determine whether or not to replace data in any locally hosted database.

What are your data sources?

Our database receives data from over 20 different data sources. These datasets include the GHCN, ISD, MADIS, the MERRA2 and ERA5 re-analyses, MODIS satellite imagery, and more.

Why is querying by station ID generally not recommended?

Our API sources data from many station networks. Citizen maintained stations can change thier location with time (the station identifier will not change if this occurs), and are considered "Unstable". We recommend avoiding usage these station ID's by either using another query method (lat/lon, postal code, city ID) or using a station from our published "stable" station ID list on the API metadata page.

Why doesn't your data match X provider's data?

Our API provides one of the only multi-source historical weather datasets on the market. It combines the advantages of spatially complete gridded datasets with station data.
These advantages include:

  • Global coverage - even in remote areas, and over open water at a 1-13 KM spatial resolution.
  • Improved accuracy in most areas due to assimilation of non-station observations (such as radiosondes, airplane observations, satellite estimations, ground radar, etc.)
  • Excellent quality control.
  • Temporal completeness (minimal missing data)

Our API dynamically selects the nearest available station data, and combines it with additional datasets to compensate for sources of error such as: Distance from point, quality of station data, availability of data for time of interest.
Most providers of weather data use only station data. As such the differences betwen our API, and others will likely be significant in areas of poor station coverage.

Forecast API

How frequently do forecasts update?
Forecasts update once per hour in most locations.
What are the data sources for the Forecast API?
Our API utilizes multiple short/mid-range high resolution, and coarser resolution long-range models to construct forecasts. These models include the:
  • GFS Model
  • NAM Model
  • HRRR Model
  • ICON DWD Model
  • ECMWF Model
  • SILAM Model

Current Weather API

How frequently does the current weather API update?
Data updates as fast as it is reported. This can vary by location. Typically between 15-30 mins.