# Data

**URL:** https://community.purpleair.com/c/data/7.md

[Latest](https://community.purpleair.com/latest.md) · [Categories](https://community.purpleair.com/categories.md)

---

## [About the Data category](https://community.purpleair.com/t/about-the-data-category/70)

<div class="topic-metadata">

**Author:** [@PurpleAir](https://community.purpleair.com/u/PurpleAir)\
**Replies:** 3\
**Last updated:** [July 9, 2024, 12:07am UTC](https://community.purpleair.com/t/about-the-data-category/70 "2024-07-09T00:07:34Z")

</div>

PurpleAir is built on the ideals of sharing data and empowering individuals to institute real change. All public PurpleAir data is available to download under various licenses from private, not for profit, use, to educat…

---

## [About the PurpleAir API](https://community.purpleair.com/t/about-the-purpleair-api/7145)

<div class="topic-metadata">

**Author:** [@PurpleAir](https://community.purpleair.com/u/PurpleAir)\
**Replies:** 4\
**Last updated:** [September 1, 2026, 7:20pm UTC](https://community.purpleair.com/t/about-the-purpleair-api/7145 "2026-09-01T19:20:13Z")

</div>

The PurpleAir API The PurpleAir API is a web service that allows you to obtain air quality data reported by PurpleAir sensors. This is an extensive dataset going back to early 2016. Users wanting to jump straight into …

---

## [SD Storage Best Practices (QA/QC) for Offline Data Collection](https://community.purpleair.com/t/sd-storage-best-practices-qa-qc-for-offline-data-collection/22906)

<div class="topic-metadata">

**Author:** [@ERICK\_TERRAZAS\_UCB](https://community.purpleair.com/u/ERICK_TERRAZAS_UCB)\
**Replies:** 0\
**Last updated:** [September 1, 2026, 12:07am UTC](https://community.purpleair.com/t/sd-storage-best-practices-qa-qc-for-offline-data-collection/22906 "2026-09-01T00:07:03Z")

</div>

Hello to the research community! When conducting 100% offline (no Wi-Fi) air quality monitoring campaigns outdoors, the microSD card goes from being a simple hardware component to becoming the sole safeguard for our pri…

---

## [API Pricing](https://community.purpleair.com/t/api-pricing/4523)

<div class="topic-metadata">

**Author:** [@PurpleAir](https://community.purpleair.com/u/PurpleAir)\
**Replies:** 52\
**Last updated:** [August 25, 2026, 8:17pm UTC](https://community.purpleair.com/t/api-pricing/4523 "2026-08-25T20:17:13Z")

</div>

The PurpleAir API uses a points-based billing system. API calls consume points, and if you do not have enough points to make an API call, the API will return an error. If you are a PurpleAir sensor owner, you can get d…

---

## [Consulta sobre la automatización de descarga de datos de Brazilian PM2.5](https://community.purpleair.com/t/consulta-sobre-la-automatizacion-de-descarga-de-datos-de-brazilian-pm2-5/22896)

<div class="topic-metadata">

**Author:** [@Richard\_Daniel\_Munoz](https://community.purpleair.com/u/Richard_Daniel_Munoz)\
**Replies:** 0\
**Last updated:** [August 19, 2026, 5:07am UTC](https://community.purpleair.com/t/consulta-sobre-la-automatizacion-de-descarga-de-datos-de-brazilian-pm2-5/22896 "2026-08-19T05:07:29Z")

</div>

El problema que estoy teniendo es que los datos que obtengo mediante la API no coinciden con los datos que descargo directamente desde el mapa de PurpleAir. Por ejemplo, desde el mapa de PurpleAir ingreso a la página we…

---

## [How to make US-EPA conversion the default?](https://community.purpleair.com/t/how-to-make-us-epa-conversion-the-default/22885)

<div class="topic-metadata">

**Author:** [@RandySea](https://community.purpleair.com/u/RandySea)\
**Replies:** 2\
**Last updated:** [August 15, 2026, 11:54pm UTC](https://community.purpleair.com/t/how-to-make-us-epa-conversion-the-default/22885 "2026-08-15T23:54:20Z")

</div>

I just learned that although my Purple Air readings say US-EPA, I have to also do a conversion every time I open Purple Air to look at a sensor and have a correct reading. Is there no way to make “apply conversion” a de…

---

## [Sensor JSON Documentation](https://community.purpleair.com/t/sensor-json-documentation/6917)

<div class="topic-metadata">

**Author:** [@PurpleAir](https://community.purpleair.com/u/PurpleAir)\
**Replies:** 8\
**Last updated:** [August 10, 2026, 5:48pm UTC](https://community.purpleair.com/t/sensor-json-documentation/6917 "2026-08-10T17:48:44Z")

</div>

This list contains definitions for fields that can be obtained from a sensor’s local JSON data. Many of these fields are also the same as the information recorded to the SD card. This documentation is current for the 7.0…

---

## [Retrieving specific fields](https://community.purpleair.com/t/retrieving-specific-fields/22878)

<div class="topic-metadata">

**Author:** [@DuaneW](https://community.purpleair.com/u/DuaneW)\
**Replies:** 1\
**Last updated:** [August 9, 2026, 7:33pm UTC](https://community.purpleair.com/t/retrieving-specific-fields/22878 "2026-08-09T19:33:46Z")

</div>

I have an API key and I want to get data for a specific sensor whose index I know. If I paste this into my browser, I get results for all fields: https://api.purpleair.com/v1/sensors/319066?api\_key=… But, I don’t want…

---

## [US EPA Conversion: AQI 38; Woodsmoke: AQI 18. What's the "real" air quality?](https://community.purpleair.com/t/us-epa-conversion-aqi-38-woodsmoke-aqi-18-whats-the-real-air-quality/22874)

<div class="topic-metadata">

**Author:** [@TMEdelman](https://community.purpleair.com/u/TMEdelman)\
**Replies:** 0\
**Last updated:** [August 8, 2026, 12:38am UTC](https://community.purpleair.com/t/us-epa-conversion-aqi-38-woodsmoke-aqi-18-whats-the-real-air-quality/22874 "2026-08-08T00:38:38Z")

</div>

Hi, I can get my home interior to US EPA Conversion 2.5 PM to AQI 12 or so with air purifiers, and I typically close the windows at outside AQI 28. The readings above are for my Zen, outside on the second floor balcony. …

---

## [Is there a field that returns data with US EPA pm2.5 conversion formula applied?](https://community.purpleair.com/t/is-there-a-field-that-returns-data-with-us-epa-pm2-5-conversion-formula-applied/4593)

<div class="topic-metadata">

**Author:** [@Karen\_Wang](https://community.purpleair.com/u/Karen_Wang)\
**Replies:** 16\
**Last updated:** [March 4, 2026, 8:45pm UTC](https://community.purpleair.com/t/is-there-a-field-that-returns-data-with-us-epa-pm2-5-conversion-formula-applied/4593 "2026-03-04T20:45:46Z")

</div>

Hello, I was trying to pull sensor data for pm2.5 using the API. I noticed that there’s an option to apply US EPA conversion formula to the data directly in the data layer on the website. However, I did not find a corres…

---

## [Basic data analysis?](https://community.purpleair.com/t/basic-data-analysis/3742)

<div class="topic-metadata">

**Author:** [@spike](https://community.purpleair.com/u/spike)\
**Replies:** 1\
**Last updated:** [August 6, 2026, 8:20pm UTC](https://community.purpleair.com/t/basic-data-analysis/3742 "2026-08-06T20:20:44Z")

</div>

Hi, does anyone have instructions for basic data analysis? I’ve been told pivot tables would help me compare weekday and weekend data at a site, but I’m also interested in comparing two sites during the same time period.…

---

## [Introduction](https://community.purpleair.com/t/introduction/22203)

<div class="topic-metadata">

**Author:** [@willamson](https://community.purpleair.com/u/willamson)\
**Replies:** 1\
**Last updated:** [August 4, 2026, 4:15am UTC](https://community.purpleair.com/t/introduction/22203 "2026-08-04T04:15:27Z")

</div>

I am new here and looking for some guidance to start, Please help me

---

## [Can't create API Key](https://community.purpleair.com/t/cant-create-api-key/22619)

<div class="topic-metadata">

**Author:** [@cchopper123](https://community.purpleair.com/u/cchopper123)\
**Replies:** 2\
**Last updated:** [July 30, 2026, 12:55am UTC](https://community.purpleair.com/t/cant-create-api-key/22619 "2026-07-30T00:55:31Z")

</div>

I can’t create an API Key. It says I am missing my last name but I already updated it.

---

## [Home Assistant / API key access to private sensor](https://community.purpleair.com/t/home-assistant-api-key-access-to-private-sensor/11508)

<div class="topic-metadata">

**Author:** [@ptr727](https://community.purpleair.com/u/ptr727)\
**Replies:** 3\
**Last updated:** [July 17, 2026, 7:19pm UTC](https://community.purpleair.com/t/home-assistant-api-key-access-to-private-sensor/11508 "2026-07-17T19:19:51Z")

</div>

Hi, long time user of HA and PurpleAir (custom integration and now native). I have an indoor and outdoor sensor, during the LA fires my neighbors found my sensors through the map, and expressed confusion why my (indoor)…

---

## [Invalid API Read Key](https://community.purpleair.com/t/invalid-api-read-key/22804)

<div class="topic-metadata">

**Author:** [@PaulMykolajtchuk](https://community.purpleair.com/u/PaulMykolajtchuk)\
**Replies:** 1\
**Last updated:** [July 16, 2026, 10:23pm UTC](https://community.purpleair.com/t/invalid-api-read-key/22804 "2026-07-16T22:23:08Z")

</div>

Good morning all, Currently am attempting to create an API read key in order to access historical data. However, when a new read key is created & enabled, I am getting 403 errors, & a warning label on the Data Download …

---

## [TSP from serial data](https://community.purpleair.com/t/tsp-from-serial-data/22813)

<div class="topic-metadata">

**Author:** [@Hector\_Rodriguez](https://community.purpleair.com/u/Hector_Rodriguez)\
**Replies:** 0\
**Last updated:** [July 16, 2026, 10:12pm UTC](https://community.purpleair.com/t/tsp-from-serial-data/22813 "2026-07-16T22:12:19Z")

</div>

Hello, it´s possible to got TSP concentrations from the serial connection of the sensors?

---

## [Changing location](https://community.purpleair.com/t/changing-location/22806)

<div class="topic-metadata">

**Author:** [@EJONES](https://community.purpleair.com/u/EJONES)\
**Replies:** 1\
**Last updated:** [July 16, 2026, 10:03pm UTC](https://community.purpleair.com/t/changing-location/22806 "2026-07-16T22:03:58Z")

</div>

How do I change the location of a sensor on themap ?

---

## [Historic Data API Pull and Missing Fields](https://community.purpleair.com/t/historic-data-api-pull-and-missing-fields/22796)

<div class="topic-metadata">

**Author:** [@DanRamage](https://community.purpleair.com/u/DanRamage)\
**Replies:** 0\
**Last updated:** [July 12, 2026, 2:49pm UTC](https://community.purpleair.com/t/historic-data-api-pull-and-missing-fields/22796 "2026-07-12T14:49:30Z")

</div>

As documented in the API all the fields are not available in the history pull. Why aren’t the confidence and channel\_flags available? If there was an issue, how would I determine that in the history data?

---

## [Historical API endpoint - bulk downloads](https://community.purpleair.com/t/historical-api-endpoint-bulk-downloads/22594)

<div class="topic-metadata">

**Author:** [@qdmchenry](https://community.purpleair.com/u/qdmchenry)\
**Replies:** 2\
**Last updated:** [July 6, 2026, 6:41pm UTC](https://community.purpleair.com/t/historical-api-endpoint-bulk-downloads/22594 "2026-07-06T18:41:11Z")

</div>

Is there any way to get around the requirement of a single sensor index for the historic endpoint? I am hoping for something similar to the bounding box feature of the regular sensors endpoint. This does not need to be a…

---

## [Setting Up the PurpleAir Data Download Tool](https://community.purpleair.com/t/setting-up-the-purpleair-data-download-tool/4999)

<div class="topic-metadata">

**Author:** [@PurpleAir](https://community.purpleair.com/u/PurpleAir)\
**Replies:** 2\
**Last updated:** [June 30, 2026, 10:20pm UTC](https://community.purpleair.com/t/setting-up-the-purpleair-data-download-tool/4999 "2026-06-30T22:20:17Z")

</div>

The Purple Data Download Tool allows you to download PurpleAir data from any time period with no programming experience. The tool uses the PurpleAir API in the background. The steps below will teach you how to download …

---

## [Wildly high PM25 values from api](https://community.purpleair.com/t/wildly-high-pm25-values-from-api/22753)

<div class="topic-metadata">

**Author:** [@Scott\_Beam](https://community.purpleair.com/u/Scott_Beam)\
**Replies:** 4\
**Last updated:** [June 25, 2026, 7:42pm UTC](https://community.purpleair.com/t/wildly-high-pm25-values-from-api/22753 "2026-06-25T19:42:05Z")

</div>

i’ve noticed this for the past several weeks and finally put some logging in to catch it. I’m got dozens of these from just today. pm25 value is over 2000 and sometimes much higher. no way this is correct right? i’…

---

## [Trouble downloading sensor data](https://community.purpleair.com/t/trouble-downloading-sensor-data/22771)

<div class="topic-metadata">

**Author:** [@ReynaB](https://community.purpleair.com/u/ReynaB)\
**Replies:** 2\
**Last updated:** [June 25, 2026, 7:04pm UTC](https://community.purpleair.com/t/trouble-downloading-sensor-data/22771 "2026-06-25T19:04:11Z")

</div>

I am trying to download hourly pm2.5 data from all sensors in Texas, but I keep encountering the same issue within the Data Download Tool. It appears that sensors with a 6 digit sensor index keep reporting ‘No data found…

---

## [Using PurpleAir to Track Neighbor Smoke Intrusions..Others?](https://community.purpleair.com/t/using-purpleair-to-track-neighbor-smoke-intrusions-others/10627)

<div class="topic-metadata">

**Author:** [@nurvo007](https://community.purpleair.com/u/nurvo007)\
**Replies:** 18\
**Last updated:** [June 25, 2026, 12:05am UTC](https://community.purpleair.com/t/using-purpleair-to-track-neighbor-smoke-intrusions-others/10627 "2026-06-25T00:05:15Z")

</div>

Hi everyone, I’m using New PurpleAir sensor to track neighbor smoke intrusions (3-4 x’s a week) for future lawsuit as after three years their continuous BBQ smoke is causing health issues. I spoke to a few legal folks a…

---

## [PurpleAir Download Tool](https://community.purpleair.com/t/purpleair-download-tool/12636)

<div class="topic-metadata">

**Author:** [@kitkat](https://community.purpleair.com/u/kitkat)\
**Replies:** 5\
**Last updated:** [June 24, 2026, 11:49pm UTC](https://community.purpleair.com/t/purpleair-download-tool/12636 "2026-06-24T23:49:26Z")

</div>

I am trying to download data from three sensors using the data download tool on MacOS. I have a read and write API key which I have entered into the tool, and I have no invalid inputs in the download tab when I attempt t…

---

## [API Points for Sensor Owners](https://community.purpleair.com/t/api-points-for-sensor-owners/7525)

<div class="topic-metadata">

**Author:** [@PurpleAir](https://community.purpleair.com/u/PurpleAir)\
**Replies:** 6\
**Last updated:** [June 16, 2026, 12:26am UTC](https://community.purpleair.com/t/api-points-for-sensor-owners/7525 "2026-06-16T00:26:17Z")

</div>

Since the release of the points-based billing system in the PurpleAir API, several PurpleAir Community members have come to us with concerns regarding how this system is intended to work for PurpleAir sensor owners. In t…

---

## [API Limits?](https://community.purpleair.com/t/api-limits/4467)

<div class="topic-metadata">

**Author:** [@Ganon](https://community.purpleair.com/u/Ganon)\
**Replies:** 15\
**Last updated:** [May 22, 2026, 4:51pm UTC](https://community.purpleair.com/t/api-limits/4467 "2026-05-22T16:51:27Z")

</div>

I own one of these sensors and make it publicly available. Why in the world would I have to pay to get the data from it so I can display it nicely in my home assistant setup when I provide the data free to everyone? Am I…

---

## [Why does the "Brazilian PM2.5 (µg/m³)" layer show higher raw concentration values than other µg/m³ layers (Tasmania, Canada BC, Raw PM2.5)?](https://community.purpleair.com/t/why-does-the-brazilian-pm2-5-g-m-layer-show-higher-raw-concentration-values-than-other-g-m-layers-tasmania-canada-bc-raw-pm2-5/22660)

<div class="topic-metadata">

**Author:** [@Arthur\_Cito](https://community.purpleair.com/u/Arthur_Cito)\
**Replies:** 0\
**Last updated:** [May 5, 2026, 12:58pm UTC](https://community.purpleair.com/t/why-does-the-brazilian-pm2-5-g-m-layer-show-higher-raw-concentration-values-than-other-g-m-layers-tasmania-canada-bc-raw-pm2-5/22660 "2026-05-05T12:58:47Z")

</div>

Hello, I have been comparing different data layers on the PurpleAir map and noticed something that I would like to understand better. When I look at real-time readings for the same sensor at the same moment, or “1-week…

---

## [Request for PurpleAir API Access for Academic Disaster Detection Project (CRISIS-AI)](https://community.purpleair.com/t/request-for-purpleair-api-access-for-academic-disaster-detection-project-crisis-ai/22639)

<div class="topic-metadata">

**Author:** [@Manya\_C\_P](https://community.purpleair.com/u/Manya_C_P)\
**Replies:** 2\
**Last updated:** [April 27, 2026, 12:04am UTC](https://community.purpleair.com/t/request-for-purpleair-api-access-for-academic-disaster-detection-project-crisis-ai/22639 "2026-04-27T00:04:06Z")

</div>

Hello PurpleAir team, I am working on an academic AI project called CRISIS-AI (Disaster Detection and Response System). The system integrates multiple data sources such as air quality, weather, satellite, and sensor da…

---

## [Do API keys ever expire?](https://community.purpleair.com/t/do-api-keys-ever-expire/22646)

<div class="topic-metadata">

**Author:** [@developerAQ](https://community.purpleair.com/u/developerAQ)\
**Replies:** 0\
**Last updated:** [April 24, 2026, 8:02pm UTC](https://community.purpleair.com/t/do-api-keys-ever-expire/22646 "2026-04-24T20:02:36Z")

</div>

Hello, I was wondering if API keys ever expire? I’m handing this project off to another team for long term maintenance and they were wondering this as well.

---

## [Add more info on Sensor Pop-up](https://community.purpleair.com/t/add-more-info-on-sensor-pop-up/22645)

<div class="topic-metadata">

**Author:** [@scOOch](https://community.purpleair.com/u/scOOch)\
**Replies:** 0\
**Last updated:** [April 24, 2026, 4:03am UTC](https://community.purpleair.com/t/add-more-info-on-sensor-pop-up/22645 "2026-04-24T04:03:24Z")

</div>

By default the sensor pop-up window only displays the US EPA PM2.5 (AQI). Can we add more information like Estimated Temperature (°F) and Estimated Relative Humidity (%) so it will display these 3 data at the same time w…

[Next page](https://community.purpleair.com/c/data/7.md?page=1)
