AirGradient Forum

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

AirGradient Blog
#1

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
#2

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

#3
#4

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?

#5

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.