Help Build the World's Largest Open Indoor Air Quality Dataset

[AirGradientBlog]

One of the biggest challenges in indoor air quality research is the lack of open, real-world data. While outdoor air quality has benefited from large public datasets for years, indoor environments remain largely a black box despite the fact that most people spend around 90% of their time indoors. Today, we're introducing a new optional feature that allows AirGradient users to share their indoor air quality data for research and public benefit.

---

This is a companion discussion topic for the original entry at https://www.airgradient.com/blog/help-build-the-worlds-largest-open-indoor-air-quality-dataset

[Catspots]

Is the API open? I already take and store measurements around my home.

I would like to upload measurements from my Netatmo, Shelly and Ewpe Smart ACs.

Thank you

Daniel

[Achim_AirGradient]

We are in the last stretches to finalize the API. We want to make sure it has all privacy protection mechanism well tested and implemented.

However currently the functionality is linked to AieGradient monitors but I like your idea to add third party data. What format do you have that data available?

[Catspots]

I poll my open air outdoor monitor from airgradient every 5 minutes for pm2, co2, temperature and relative humidity.

I also take measurements in 9 rooms every 5 minutes. Except for Shelly where the device calls a webhook when there is a change.

My MariaDb database has:

• Local timestamp
• temperature in °C, humidity in %RH, co2 in ppm, atmospheric pressure in hPa.
• room/device that took the measurement.
• device manufacturer
  I can convert timestamp to UTC and provide latitude/longitude.

I could upload the information in json format. But CSV or TSV works too. I could do uploads when the measurement is taken, or batch uploads every few hours. I started monitoring indoor air quality in November 2025. I could share that historic information too.

I also have wind in knots and a second exterior temperature sensor.

In the next few weeks I will be adding information Air conditioning measurements to the database too. E.g., when was it turned on/off, what is the target temperature. Is it cooling or heating.

[Tai_AirGradient]

@Catspots thanks for sharing! In the meantime while we are waiting for @Achim_AirGradient, may I ask you how you plan to add the AC measurements? If I understand correctly, you mentioned Ewpe Smart, which means your AC is network-connected (e.g. Wi-Fi AC)?

I am interested in tracking my AC target temperature as well, but my AC is a standard IR remote-controlled. Without a modification or an external module connected to the AC’s mainboard, I need to put a contact sensor on the AC’s vent to record its status (ON/OFF), but I haven’t been able to record the target temperature yet. Maybe I have to find out this way. Would love to hear your idea if you’d like. Thanks!

[Catspots]

My AC unit is a gree smart air conditioner. It is connected to the local network, and listening on UDP port 7000.

Based on the code and explanation available on GitHub projects: /tomikaa87/gree-remote and /anaryk/ewpe-smart-ha I was able to implement a poller using shell scripting and python to fetch the target and current temperature of the AC unit. I then store the measurements on a local MariaDB table.

[Tai_AirGradient]

@Catspots thanks a lot for sharing this!

[tadawson]

One other thought would be to integrate through Home Assistant, since a heck of a lot of devices already are integrated, and save data in a consistent format in it’s database, allowing an enhancement of the AG integration to have access to all.

(I have thermostat/humidifier/indoor and outdoor AG, irrigation controls, flood sensors already in HA, and, frankly, the ability to plot data there pretty much makes the AG dashboard look pretty weak by comparison (although I do use both.)

Seriously, why reinvent something that is already mostly there?

[Tai_AirGradient]

@tadawson Thanks for your feedback!

I’m also a Home Assistant fan here!

Since you mentioned the data plotting ability, would you mind giving us more details on what makes the AirGradient Dashboard fall behind Home Assistant’s data plotting in your opinion? Thank you again for always being active and giving us feedback!

[tadawson]

The inability of the dashboard to support multiple items per plot, the severe limitation of values that can be displayed, etc. This is my overall HA dash - granted the AG dash is not intended to show non HA data, but even ignoring the rest of the stuff I display, the ability to display multiple particulate values on the same axis, temps from multiple locations, etc. is notably absent in the HA dash. Heck, unless I missed something, the inability to display more than 4 items at a time in the HA dash can be very frustrating. (Note there are 8 plots on the left - only the first two show without scrolling down.)

[tadawson]

[tadawson]

[Tai_AirGradient]

@tadawson, thanks a lot for your explanation and all the screenshots!

The AirGradient Dashboard also supports displaying multiple items on one chart. You can try by going to the AirGradient Dashboard > Analytics

In the Analytics Dashboard you’ll have to select the date range, filter (if needed), and locations (each monitor).

There’s also a ‘Multi Parameter Mode’ (a toggle button in the top right of the screen), which can display multiple pollution types of a single monitor.

Please feel free to let me know if you like it or not. We’d love to hear your opinion. Thanks!

[tadawson]

Closer (and I never really grasped analytics . . . are they dynamic, or just against historical data?)

Seems also like you can have either multi param on one location, or multi location with a single parameter, not both?

I with I could have fit my entire HA screen in a shot . . . no need to change pages or set anything up. It’s always there one one page, and updates realtime. I can zoom, and select a date range, but otherwise all there with no need to click around.

[Tai_AirGradient]

Hi @tadawson , they are historical data. And you are right, in Multi Parameter mode, you can only select one location (a monitor) as shown in the dropdown selector in the attached image below.

I agree that Home Assistant’s chart is quite more flexible as you can interact with it more freely. We will keep this in mind in terms of improving our AirGradient Dashboard!