WeatherBug® API

 

Oauth Security:

Consumer Key:

  • An alphanumeric key issued after authorizing your API package.

Consumer Secret Key:

  • An alphanumeric key issued after authorizing your API package.

 

Definition of API Terms

Access_token:

  • An alphanumeric license key issued by EarthNetworks.

CityType:

  • citytype="0" — city in the U.S.
  • citytype="1" — city outside of the U.S.

CityCode:

  • 5 digits designation for non-U.S. cities.

Latitude:

  • Location of a place north or south of the equator. Minimum value: -90. Maximum value: 90.

Longitude:

  • Location of a place east or west of the prime meridian. Minimum value -180. Maximum value: 180.

SearchString:

  • Parameter used to search for locations. Only U.S. zipcodes and citynames can be searched. SearchString is not case-sensitive and accepts blank spaces.

UnitType:

  • UnitType=<UnitType>0 — U.S. customary units (miles, °F, etc...) [default]
  • UnitType=<UnitType>1 — Metric system units (kms, °C, etc...).

OutputType:

  • OutputType=<OutputType>0 — Returns the RSS with the XML embedded inside it starting with "<aws:weather>" [default].
  • OutputType=<OutputType>1 — Returns pure xml beginning with "<aws:weather>".

ZipCode:

  • 5 digits designation for U.S. cities only.

 

I. XML Reference

  1. Search Locations
  2. Search Stations
  3. Live Weather
  4. Forecast
  5. Alerts

A. Search Locations

Description: Returns the location based on the U.S. and international city name or U.S. Zip Code.

1. By Zipcode:

2. By Location Names (soundex):

 

B. Search Stations

Description: For a given zipcode, citycode or latitude/longitude this call returns the weather stations in the area.

1. By ZipCode:

2. By CityCode:

Complete List of City Codes

3. By Latitude and Longitude:

 

C. Live Weather

Description: Returns detailed live weather conditions for the chosen location.

1. By StationId:

Complete List of Short Predictions | Complete List of Icon Descriptions

2. By Zip Code:

Complete List of Short Predictions | Complete List of Icon Descriptions

3. By City Code:

Call Format:
Complete List of City Codes | Complete List of Short Predictions | Complete List of Icon Descriptions

4. By Latitude and Longitude:

Complete List of Short Predictions | Complete List of Icon Descriptions

 

D. Forecast

Description: Returns the 7-day forecast for a zipcode, citycode or latitude/longitude.

1. By ZipCode:

Complete List of Short Predictions | Complete List of Icon Descriptions

2. By CityCode:

Complete List of City Codes | Complete List of Short Predictions | Complete List of Icon Descriptions

3. By Latitude and Longitude:

Complete List of Short Predictions | Complete List of Icon Descriptions

 

E. Alerts

Description: Returns weather alert information for a given Zip Code or latitude/longitude (U.S. Only).

1. By ZipCode:

2. By Latitude and Longitude: