kanarche
Open data
Data
Kanarche publishes the readings behind the map. These are PM2.5 and PM10 from citizen sensors on the Sensor.Community network, readings from the stations of the Executive Environment Agency (ИАОС) published through the European Environment Agency, temperature, humidity, pressure, wind and pollen forecasts, and the area boundaries.
Formats
The data is available as JSON from the public API under /api/v1. There is no CSV download. Useful starting points are /api/v1/areas for the list of areas, /api/v1/overview for current values, /api/v1/area/{slug}/series for the history of one area and /api/v1/sensor/{id}/series for one sensor. Series take a metric and a period. No key or account is needed.
Licences and credit
Each source keeps its own licence. Sensor.Community data is under ODbL 1.0 and DbCL 1.0. OpenStreetMap data is under ODbL 1.0. Wind, pollen and EEA bathing water data are under CC BY 4.0. ИАОС data is subject to the EEA terms of use. If you reuse the data you must credit each source as listed on the Licences page. Every API response carries a link to that page. Values computed by Kanarche, such as area medians and 24 hour means, are under ODbL 1.0 because they come from ODbL data. Credit Kanarche and Sensor.Community. The data comes as it is, with no warranty.
Updates
Citizen sensors send a reading about every 5 minutes. Kanarche shows the latest readings and recomputes area figures from them. Official stations publish less often. Recent readings are kept for about a month and longer periods are averaged.
Badge for your site
Show the current air quality of one area on your page. Replace the area name in the address with the slug from the area page URL, for example plovdiv-oblast. The badge links to the area page on Kanarche, which is the credit for the data. Copy the code below. Your own Content Security Policy must allow images from kanarche.eu. The image updates about every 5 minutes. It is indicative and not for health decisions.
<a href="https://kanarche.eu/en/area/plovdiv-oblast"><img src="https://kanarche.eu/en/badge/plovdiv-oblast.svg" alt="Air quality in Plovdiv: moderate, PM2.5 24.4 µg/m³. Kanarche" width="200" height="40"></a>Request limits
Requests are rate limited per address. Currently the API allows about 10 requests per second in short bursts, history requests about 1 per second, and a client that reads more than 60 different areas or 40 different sensors in an hour is slowed down for 15 minutes. A limited request gets status 429 with a Retry-After header. Cache what you fetch. For regular use of the full dataset, write to privacy@kanarche.eu.