Open Data and API — Air Quality in Armenia

Open data refers to information that is freely available for use, analysis, and distribution. We provide open air quality data in Armenia with hourly updates to promote transparency, support scientific research, and draw attention to environmental issues. This data can be useful for researchers, developers, activists, and anyone interested in improving environmental conditions.

Data access is available in a dedicated folder on our website, where you will find files with raw and processed measurements as well as accompanying documentation. To understand the data structure and use it correctly, please refer to the format description provided in the file readme.txt.

Air Quality Open Data Format Description README.txt

We kindly ask that when using our data, you reference airquality.am as the source, so that more people can learn about the project and benefit from the collected information. This helps spread knowledge about air quality and supports efforts to improve it.

This data is licensed under Database Contents License (DbCL) v1.0.

API

The same read-only JSON endpoints that power our mobile app are available publicly. Responses are UTF-8 JSON. In the path, {locale} is one of en, ru, or hy (example base: https://airquality.am/en/air-quality-app/v1/).

  • GET …/air-quality-app/v1/stations.json — stations, regions, and provider metadata
  • GET …/air-quality-app/v1/station/{id}.json — current readings for a station
  • GET …/air-quality-app/v1/station/{id}-history.json — historical aggregates for a station
  • GET …/air-quality-app/v1/region/{slug}.json — current data for a city or district (slug)
  • GET …/air-quality-app/v1/region/{slug}-history.json — historical aggregates for a region

Please send a meaningful User-Agent header (your app, script, or project name, optionally with a contact) instead of leaving it empty or relying on a generic browser string or the default curl user agent — this helps us understand usage and plan capacity.

You may use this API for personal widgets, integrations, and other projects. If you release something to the public (a website, app, or other product), please cite airquality.am as the data source so more people can discover the project.

API Documentation