2026.9.4
Home ▸ Integrations

Airly

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

Setup

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

Configuration

To add the Airly service 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:

API key

The API key for your Airly account.

Latitude

The latitude of the location for which to retrieve air quality data. By default, Home Assistant uses your home location.

Longitude

The longitude of the location for which to retrieve air quality data. By default, Home Assistant uses your home location.

Note

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, and so on.

Supported functionality

The Airly integration provides the following entities. Which entities are created depends on the data available from the Airly measuring stations closest to your location.

Sensors

  • Common air quality index
    • Description: Shows the Common Air Quality Index (CAQI) for your location. The level, description, and advice attributes provide a human-readable air quality level and a recommendation from Airly.
  • PM1
    • Description: Shows the concentration of particulate matter smaller than 1 micrometer in micrograms per cubic meter.
  • PM2.5
    • Description: Shows the concentration of particulate matter smaller than 2.5 micrometers in micrograms per cubic meter. The limit and percent attributes show the recommended limit and the measured value as a percentage of that limit.
  • PM10
    • Description: Shows the concentration of particulate matter smaller than 10 micrometers in micrograms per cubic meter. The limit and percent attributes show the recommended limit and the measured value as a percentage of that limit.
  • Carbon monoxide
    • Description: Shows the carbon monoxide concentration in micrograms per cubic meter. The limit and percent attributes show the recommended limit and the measured value as a percentage of that limit.
  • Nitrogen dioxide
    • Description: Shows the nitrogen dioxide concentration in micrograms per cubic meter. The limit and percent attributes show the recommended limit and the measured value as a percentage of that limit.
  • Ozone
    • Description: Shows the ozone concentration in micrograms per cubic meter. The limit and percent attributes show the recommended limit and the measured value as a percentage of that limit.
  • Sulphur dioxide
    • Description: Shows the sulfur dioxide concentration in micrograms per cubic meter. The limit and percent attributes show the recommended limit and the measured value as a percentage of that limit.
  • Humidity
    • Description: Shows the relative humidity in percent.
  • Pressure
    • Description: Shows the atmospheric pressure in hectopascals.
  • Temperature
    • Description: Shows the air temperature in degrees Celsius.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.