Breathable

An air quality index widget for iOS, iPadOS, watchOS and macOS.

Help with API keys

All of these services offer free accounts and free API access for personal use. Breathable requires an IQAir.com API key, but an AirNow.gov API key is optional. Once configured, if iCloud is enabled on your devices, these keys will automatically sync to your other devices.

Please note: Users have reported a minor delay between creating an API key and it actually being valid and usable. This is especially true for IQAir.com keys, where the site might tell you the key is ready, but with a very small warning that it could take up to 5 minutes to activate. If you create a new key and it immediately shows as invalid in Breathable, wait a few minutes and try again.

 
IQAir.com
  1. Create an IQAir.com account, or sign into an existing account.
    • Note: If you created a new account, you'll need to verify your email address with IQAir before continuing.
  2. Once signed in, visit the AirVisual API dashboard.
  3. Click the "+ New Key" button.
  4. Choose the "Community" plan and click the "Create" button.

Your API key should now be created and you'll be returned to the API dashboard. You can now copy the string labeled "Key" and paste it into Breathable.

The key should look something like: 11a2345k-453a-1n89-67h3-6z11wh9r21b7

 
AirNow.gov
  1. Create an AirNow developer tools account, or sign into an existing account.
    • Note: If you created a new account, you'll need to verify your email address with AirNow before continuing.
  2. Once signed in, visit the AirNow API web services page.

Your API key will be shown in the top-right corner of the page. You can now copy the key and paste it into Breathable.

The key should look something like: FG482957-1982-5999-0R12-1V77N5AZ2251