---
title: "PurpleAir"
description: "PurpleAir is a built-in integration for Home Assistant. It has 245 installs sharing analytics and needs the vendor's cloud."
canonical: "https://vulpo.app/integrations/core/purpleair"
url: "https://vulpo.app/integrations/core/purpleair.md"
last-updated: "2026-10-22"
version: "1.4"
---

# PurpleAir

> PurpleAir is a built-in integration for Home Assistant. It has 245 installs sharing analytics and needs the vendor's cloud.

PurpleAir is a built-in integration that tracks air quality readings from PurpleAir sensors in Home Assistant. It adds sensors for particle count concentrations at several sizes, a volatile organic compounds air quality index, signal strength and uptime. Sensors are found by searching within a radius around a latitude and longitude, then picking the ones to track. Setup is done in the UI with a PurpleAir API key, and the read key should be used if both read and write keys exist. Afterwards, the options let sensors be added or removed, and configured sensor locations can be shown on the map. Data comes through the vendor's cloud, and a diagnostics file can be downloaded for bug reports.

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=purpleair)

## 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**: Your PurpleAir API key (if you have both read and write keys, use the read key)

Also asked when signing in again.

### By coordinates

- **Search radius**: The radius (in kilometers) of the circle to search within
- **Latitude**: The latitude around which to search for sensors
- **Longitude**: The longitude around which to search for sensors

### Choose sensor

- **Sensor**: The sensor to track

### After setup

- **Search radius**: The radius (in kilometers) of the circle to search within
- **Latitude**: The latitude around which to search for sensors
- **Longitude**: The longitude around which to search for sensors
- **Sensor**: The sensor to track
- **Sensor name**: The sensor to remove
- **Show configured sensor locations on the map**

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

## Entities

- **Sensors**: PM0.3 count concentration, PM0.5 count concentration, PM10.0 count concentration, PM1.0 count concentration, PM2.5 count concentration, PM5.0 count concentration, RSSI, Uptime, Volatile organic compounds air quality index

## 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
- Number: 245 installs sharing analytics
- Connection: Needs the vendor's cloud
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Domain: `purpleair`
- Source: <https://www.home-assistant.io/integrations/purpleair/>

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/purpleair

---

- HTML version of this page: https://vulpo.app/integrations/core/purpleair
- 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