# API Limits? **URL:** \ **Category:** Data\ **Created:** [May 9, 2023, 7:33pm UTC](https://community.purpleair.com/t/api-limits/4467 "2023-05-09T19:33:33Z")\ **Posts on this page:** 16\ **Page:** 1
**Author:** ![Ganon](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/ganon/32/1439_2.png) [@Ganon](https://community.purpleair.com/u/Ganon)\ **Post date:** [May 9, 2023, 7:33pm UTC](https://community.purpleair.com/t/api-limits/4467/1 "2023-05-09T19:33:33Z")
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 missing something? ---
**Author:** ![Ashley\_PurpleAir](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/ashley_purpleair/32/1661_2.png) [@Ashley\_PurpleAir](https://community.purpleair.com/u/Ashley_PurpleAir)\ **Post date:** [May 10, 2023, 8:40pm UTC](https://community.purpleair.com/t/api-limits/4467/4 "2023-05-10T20:40:46Z")
Hello Ganon, If you’re querying the data for one sensor, the initial one million points can provide several years of data. A user commented about this here: [PaymentRequiredError making api calls - #14 by dpattee](https://community.purpleair.com/t/paymentrequirederror-making-api-calls/3971/14). If you never received the initial one million points, please contact us at [contact@purpleair.com](mailto:contact@purpleair.com). If you are on the same network as the sensor, you can visit its IP address with /json to get the data locally without using the API. We agree that you shouldn’t have to pay for your personal sensor’s data and are looking for ways to improve and implement this in the future. We appreciate your feedback and welcome any other suggestions. ---
**Author:** ![Ganon](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/ganon/32/1439_2.png) [@Ganon](https://community.purpleair.com/u/Ganon)\ **Post date:** [May 10, 2023, 9:09pm UTC](https://community.purpleair.com/t/api-limits/4467/5 "2023-05-10T21:09:45Z")
Appreciate the response! And sorry, I was a bit grumpy when I posted that apparently. I should’ve known I could hit the sensor locally. Are you all involved in the HomeAssistant integration at all? I think currently it just uses the API and I’d like it to hit my local sensor. I’d love to make that as easy as possible :-p ---
**Author:** ![stml](https://avatars.discourse-cdn.com/v4/letter/s/e274bd/32.png) [@stml](https://community.purpleair.com/u/stml)\ **Post date:** [May 11, 2023, 8:25am UTC](https://community.purpleair.com/t/api-limits/4467/6 "2023-05-11T08:25:12Z")
I really agree with this - it’s not acceptable to ask users to share their data and then charge to get it back (I cannot access my sensor locally). The limit is large, but it will run out. It should not be difficult to implement a token system linked to a users own account. So please - within the next couple of years! - provide a way for users to get their own data for free. ---
**Author:** ![Ashley\_PurpleAir](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/ashley_purpleair/32/1661_2.png) [@Ashley\_PurpleAir](https://community.purpleair.com/u/Ashley_PurpleAir)\ **Post date:** [May 11, 2023, 3:58pm UTC](https://community.purpleair.com/t/api-limits/4467/7 "2023-05-11T15:58:23Z")
Hello Ganon, The HomeAssistant integration was created by a user and is not maintained by PurpleAir. We are looking into directly incorporating data into service like these and hope to have options like that in the future. ---
**Author:** ![dwhitemv](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/dwhitemv/32/1508_2.png) [@dwhitemv](https://community.purpleair.com/u/dwhitemv)\ **Post date:** [May 16, 2023, 3:13am UTC](https://community.purpleair.com/t/api-limits/4467/8 "2023-05-16T03:13:55Z")
Not to be a party pooper, but be sure to read the [Terms of Service](https://www2.purpleair.com/policies/terms-of-service), especially section 2.6 and all of section 4. The ToS makes it pretty clear who owns the data and what you can do with it. If you’re doing enough with the sensor to generate a million API calls, then it’s worth it to invest in a Meteobridge (or other compatible datalogger) and store the data yourself. ---
**Author:** ![PokAlice](https://avatars.discourse-cdn.com/v4/letter/p/9e8a1a/32.png) [@PokAlice](https://community.purpleair.com/u/PokAlice)\ **Post date:** [June 5, 2023, 4:31pm UTC](https://community.purpleair.com/t/api-limits/4467/9 "2023-06-05T16:31:37Z")
I also agree with this - I should be able to query my own sensor data without using credits/points. I can get the data required via a local JSON query, but it requires the device to be on the same local network and ideally it would be good to have the PurpleAir isolated for security reasons. ---
**Author:** ![Adrian](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/adrian/32/611_2.png) [@Adrian](https://community.purpleair.com/u/Adrian)\ **Post date:** [June 13, 2023, 2:44pm UTC](https://community.purpleair.com/t/api-limits/4467/10 "2023-06-13T14:44:11Z")
We will figure out a way to make sensor owners able to access their own data for free. We do appreciate all the feedback. ---
**Author:** ![stml](https://avatars.discourse-cdn.com/v4/letter/s/e274bd/32.png) [@stml](https://community.purpleair.com/u/stml)\ **Post date:** [July 18, 2023, 1:27am UTC](https://community.purpleair.com/t/api-limits/4467/11 "2023-07-18T01:27:02Z")
Back two months later because I’ve run out of points - and I still seriously object to having to pay to retrieve my own data. That million points lasted almost exactly two months (the sensor has actually been down for some time, but I assumed it was broken. It’s not: I’ve run out of points so the API calls fail). Moreover, how on earth have I run out of points? I call the data every ten minutes, generating 100-120 calls per day, but each call uses 155 points? The guide says that each of these calls (get\_sensor) should use _one point._ ![Screenshot from 2023-07-18 04-16-53](https://us1.discourse-cdn.com/flex020/uploads/purpleair/original/2X/5/5518410ff362f285f825ae42c3a605c2b0dd3bee.png) Please (a) credit my account immediately with more points and (b) explain what is going on here. ---
**Author:** ![stml](https://avatars.discourse-cdn.com/v4/letter/s/e274bd/32.png) [@stml](https://community.purpleair.com/u/stml)\ **Post date:** [July 18, 2023, 2:05am UTC](https://community.purpleair.com/t/api-limits/4467/12 "2023-07-18T02:05:22Z")
Having looked into this, I’m guessing I am being deducted so many points because I am retrieving all sensor fields, and each one costs points. Is this the case? Either way, this is still ridiculous for data which I provide myself, to you, for free. Please make good on your promise above and elsewhere to provide free data access - to _all_ personal data - to those who provide it. ---
**Author:** ![Elton](https://avatars.discourse-cdn.com/v4/letter/e/eada6e/32.png) [@Elton](https://community.purpleair.com/u/Elton)\ **Post date:** [August 5, 2023, 6:13am UTC](https://community.purpleair.com/t/api-limits/4467/13 "2023-08-05T06:13:39Z")
Well this is unfortunate. There’s no way my casual use is costing more than the data I’ve been contributing. I’ll be taking all of my sensors offline, and I encourage others who have likewise been cheated to do so as well. I’ll check back in a year or two to see if this is resolved…maybe. ---
**Author:** ![Jetson](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/jetson/32/2858_2.png) [@Jetson](https://community.purpleair.com/u/Jetson)\ **Post date:** [February 20, 2024, 3:44am UTC](https://community.purpleair.com/t/api-limits/4467/14 "2024-02-20T03:44:43Z")
Seems like PurpleAir is dragging their feet on a Home Assistant integration. You can get your sensor data for free via [The Air Quality Open Platform](https://www.home-assistant.io/integrations/waqi/). Get yourself and API key from [https://aqicn.com](https://aqicn.com) (you’ll need a valid email address) and find your station number from the map (its the 6 digit number in the URL [https://aqicn.org/station/@123456/](https://aqicn.org/station/@123456/) ) When you add the integration for World Air Quality Index (WAQI), you enter your API key and Station number ---
**Author:** ![Josh\_PurpleAir](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/josh_purpleair/32/2842_2.png) [@Josh\_PurpleAir](https://community.purpleair.com/u/Josh_PurpleAir)\ **Post date:** [February 23, 2024, 1:25am UTC](https://community.purpleair.com/t/api-limits/4467/15 "2024-02-23T01:25:21Z")
@Jetson @elton @stml sensor owners can get data reported by their sensors for free by sending an email to [contact@purpleair.com](mailto:contact@purpleair.com). Please contact us and we’d be happy to assist. Anyone using home assistant can then use the existing community integration to view data for their sensor. In the future there will be [a system providing enough points for all data your sensor contributes at a minimum](https://community.purpleair.com/t/api-points-for-sensor-owners/7525). ---
**Author:** ![eon](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/eon/32/4803_2.png) [@eon](https://community.purpleair.com/u/eon)\ **Post date:** [May 20, 2024, 3:30am UTC](https://community.purpleair.com/t/api-limits/4467/16 "2024-05-20T03:30:22Z")
I’ll be sure to contact the email address, but did anyone do any research on this? The Home Assistant official integration, the one on the project repo that stores the core home assistant code, makes roughly 720 calls per day and uses almost 30k points per day. It seems like the integration updates the sensor using the public API endpoint approximately once every 2 minutes. I imagine it’s not restricting the number of fields being fetched. But at that default rate it would require more than 10 million points to keep the integration running for an entire year. Is it not possible to have someone from PurpleAir just look at the official integration and see if it is possible to either optimize the calls being made currently or (even better) query against the local ip address of the device if it’s available and only use the public API endpoint as a fallback? ---
**Author:** ![Ganon](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/ganon/32/1439_2.png) [@Ganon](https://community.purpleair.com/u/Ganon)\ **Post date:** [May 20, 2024, 5:40am UTC](https://community.purpleair.com/t/api-limits/4467/17 "2024-05-20T05:40:05Z")
Seems like you all have made a good amount of progress on this. I haven’t had a chance to try it out yet, but I really appreciate all the follow up on the issue! Thanks! I’ll hopefully have time to check it out soon. 🙂 ---
**Author:** ![ptr727](https://sea2.discourse-cdn.com/flex020/user_avatar/community.purpleair.com/ptr727/32/6291_2.png) [@ptr727](https://community.purpleair.com/u/ptr727)\ **Post date:** [May 22, 2026, 4:51pm UTC](https://community.purpleair.com/t/api-limits/4467/18 "2026-05-22T16:51:27Z")
I’ve had a PR open to add support for private and self-owned sensors consuming no points, but the original author has been busy for an extended period of time and did not review the PR, so I just created a standalone version that can be installed using HACS. Try it out at [GitHub - ptr727/homeassistant-purpleair: PurpleAir integration for Home Assistant · GitHub](https://github.com/ptr727/homeassistant-purpleair)