AirNow

The AirNow integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] uses the AirNow web service as a source for air quality data for your location.

Setup

To generate an AirNow API key, go to the AirNow Developer Tools page.

Configuration

To add the AirNow integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

Troubleshooting

The EPA AirNow API is often flaky and will occasionally not return any results for a particular location. This will prevent the integration from being added to Home Assistant, but the situation is usually temporary and will resolve itself later.

If the integration continues to report “No results found for that location” and cannot be added to Home Assistant, please do the following before submitting a bug report.

First, navigate to the AirNow Current Observations By Lat/Lon page, enter the same latitude/longitude and station radius, select application/json as the output format, select “Build” and then “Run”.

If the query returns a result other than [], open a bug report and include the query result (you may sanitize the data to remove your latitude and longitude, but please do not remove any fields). This information will help a lot to figure out the source of the issue.

Note

The AirNow API allows 500 data updates per hour, but since observations are only updated hourly, the default update rate is set to 2 per hour and should not trigger rate limiting. If you use this API key for other purposes, ensure the total request rate does not exceed 500 per hour.