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


To generate an Airly API key, go to Airly for developers page.


Adding Airly 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 “Airly”.

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

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

Airly allows 100 data updates per day. For this reason, the more Airly instances configured, the less frequent updates will be. For one configured Airly instance, data will be updated every 15 minutes, for two configured instances, data will be updated every 30 minutes, for three configured instances, data will be updated every 45 minutes, etc.