Getting Started

The global climate is changing. Seasons are shifting. Sea levels are rising. Extreme climatic events are becoming more frequent and more intense. Every day more people and institutions are trying to respond and prepare effectively.

Everyone has climate questions. For example, how will my area be affected? With what probability can these changes be expected? How will the growing season shift? Can I access and afford reliable climate projection data?

The National Aeronautics and Space Administration of the United States (NASA) produces an abundance of quality global climate data available in NetCDF format. Recognizing that this more unique data format limits accessibility for many climate professionals, scientists, and even citizens who are actively preparing for climate change, the Climate API processes climate datasets originally stored in NetCDF format according to the standards set by the Intergovernmental Panel on Climate Change (IPCC) and serves it in the universal format, JSON. JSON is a data structure accepted by virtually all modern programming languages.

Currently, the Climate API includes temperature and precipitation data for cities across the entire USA historically and under two popular carbon emission scenarios projected until the end of the century. Users can retrieve these results from two popular climate datasets, either NASA NEX-GDDP or LOCA. See datasets for more information.

Accessible and standardized climate data through the Climate API will help decision makers, scientists, technologists, and citizens answer the aforementioned questions and more. Read on to learn how to use the API.

Logging in

Log in or sign up for a new account with the Climate API.

Getting a token

Logging in directs you to the Climate API User Profile page, which contains your API token. A valid token is required to make requests to the API. Should you generate a new token, note that your old token will be expired and any instances of it must be updated to access the API.

From the command line, you may request your token by providing the Climate API your account information:

curl -k -X POST https://app.climate.azavea.com/api-token-auth/ -d email=<your_email> -d password=<your_password>

Making your first request

Any API request must be made with an active account token in the request header:

curl -i https://app.climate.azavea.com/api/scenario/ -H "Authorization: Token <your_token>"

Voila! You’ve just make your first Climate API request.