The airnow integration uses the AirNow web service as a source for air quality data for your location.


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


Adding AirNow to your Home Assistant instance can be done via the user interface, by taking the following steps:

  • Browse to your Home Assistant instance.

  • In the sidebar click on Configuration.

  • From the configuration menu select: Integrations.

  • In the bottom right, click on the Add Integration button.

  • From the list, search and select “AirNow”.

  • Follow the instruction on screen to complete the set up.

After completing, the AirNow integration will be immediately available for use.

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.