All of these services offer free accounts and free API access for personal use. Breathable requires at least one API key, but you can add a key for as many services as you'd like. Once configured, if iCloud is enabled, your keys will automatically sync to your other devices.
Important notes:
- IQAir.com API keys expire after ~1 year, but you can delete the old key and create a new free key, re-enter it into Breathable, and you're good to go.
- 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
-
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 before continuing.
- Once signed in, visit the Air Quality API dashboard
- If you've never created a key, skip to step 4, otherwise first delete your existing key:
- Click the ••• button for the existing key in the list, then "Delete"
- Confirm the deletion
- Click the "Get a plan" button
- Under "Community (Free)", click the "Subscribe now" 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
To top ↩
PurpleAir
-
Create a PurpleAir developer account using a Google account, or sign in to an existing account
- Optionally, confirm your time zone (this does not impact Breathable AQI data)
- View the API Keys tab, and click the "+ API Key" button
- For Project and User, the default values can be used. For Key Type, choose "Read", and for Status, choose "Enabled"
- Click "Create"
Your API key should now be created and you'll be returned to the API Keys tab. You can now copy the string labeled "Key" and paste it into Breathable.
The key should look something like: 1D6A4045-9C13-41D1-9F32-3463BF2CC148
To top ↩
World Air Quality Index
-
Create an Air Quality Open Data Platform account
- Note: Accounts generate a one-time token, but are otherwise not retained. If you need a new API token in the future, you can create another AQODP account with a different email address.
- Verify your email address
- Complete the CAPTCHA
Your API key will be displayed automatically after completing your account setup steps. You can now copy the key and paste it into Breathable.
The key should look something like: fnd535cf247da2ab1367gea12b5h967b1cc6fa3e
To top ↩
AirNow.gov
-
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 before continuing.
- 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
To top ↩
