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:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the Add Integration button.
-
From the list, select AirNow.
-
Follow the instructions on screen to complete the setup.
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.
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.