---
title: "World Air Quality Index (WAQI)"
description: "World Air Quality Index (WAQI) is a built-in integration for Home Assistant. It has 4.8k installs sharing analytics and needs the vendor's cloud."
canonical: "https://vulpo.app/integrations/core/waqi"
url: "https://vulpo.app/integrations/core/waqi.md"
last-updated: "2026-10-22"
version: "1.4"
---

# World Air Quality Index (WAQI)

> World Air Quality Index (WAQI) is a built-in integration for Home Assistant. It has 4.8k installs sharing analytics and needs the vendor's cloud.

World Air Quality Index (WAQI) is a built-in integration that reads air quality data from the WAQI cloud service. It adds sensors for carbon monoxide, nitrogen dioxide, ozone, sulphur dioxide, PM10 and PM2.5, plus the dominant pollutant and visibility measured by nephelometry. Setup happens in the UI and asks for an API key for the service. Because it relies on the vendor's cloud, readings depend on that connection. A diagnostics file can be downloaded for bug reports, and the integration can show notices under Repairs in Settings.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=waqi)

## Supports

- **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

It is added under Settings, Devices and services, with Add integration.

### Connect

- **API key**: API key for the World Air Quality Index

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Sensors**: Carbon monoxide, Dominant pollutant, Visibility using nephelometry, Nitrogen dioxide, Ozone, PM10, PM2.5, Sulphur dioxide

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.

## At a glance

- Kind: Built-in integration
- Category: [Weather and alerts](https://vulpo.app/integrations/category/weather-and-alerts.md), Air quality and pollen
- Brand: WAQI
- Number: 4.8k installs sharing analytics
- Connection: Needs the vendor's cloud
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Domain: `waqi`
- Source: <https://www.home-assistant.io/integrations/waqi/>

In Vulpo: Chart card, Apple Watch

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/waqi

---

- HTML version of this page: https://vulpo.app/integrations/core/waqi
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml