API Response Data Fields

This page explains in detail the response data fields for BreezoMeter’s global air quality data API.

breezometer_aqi
BreezoMeter Air Quality Index (BAQI); Integer between 0-100 as seen here.
breezometer_color
BreezoMeter Air Quality Index Color. The color is between two hexadecimal numbers.

API numberHex colorColor Scale
100#009E3A
80#58BE35
60#C1E619
40#FEC500
20#FE4600
0#800000
breezometer_description
A string of BreezoMeter Air Quality Index interpretation.

BreezoMeter AQI ValuesAir Quality Interpretation
100 – 80Excellent Air Quality
79 – 60Fair Air Quality
59 – 40Moderate Air Quality
39 – 20Low Air Quality
19 – 0Poor Air Quality
country_name
The country name
country_aqi_prefix
Some maximum AQIs have added signs, such as “X+” or “>X”. In this cases, you will get in the JSON response a prefix field with the sign to add. The field value will be “” (Empty String) when there is no sign to add.
country_aqi
Local Air Quality Index Integer as defined by the country where the requested location is. In case the county do not have a numeric AQI will return null
country_color
Local Air Quality Index Color in hexadecimal number. (As detailed in the AQI scales sources)
country_description
A string of Local Air Quality Index interpretation.
random_recommendations
BreezoMeter Health Recommendations strings based on BreezoMeter AQI. There are different recommendations for 5 different segments:

  • children
  • sport – outdoor athletes
  • health – health sensitives
  • inside
  • outside
dominant_pollutant_canonical_name
A string of pollutant name as an acronym. For chemical compounds, this is the .chemical formula (i.e. SO2).
dominant_pollutant_description
A string of full pollutant name. For chemical compounds, this is the .IUPAC name (i.e. sulfur dioxide).
dominant_pollutant_text
Sequence of information about the pollutant that has the greatest effect on the AQI right now.

  • main – General indication of the current dominant pollutant.
  • effects – Main health effects of the dominant pollutant.
  • causes – Main causes and emission sources of the dominant pollutant.
datetime
The timestamp represents the BreezoMeter calculation time. In our API the timestamp is of ISO 8601 standard (UTC time zone).
data_valid
Boolean value.
pollutants
Dictionary of all the available pollutants information at a specific location. For each pollutant you will find:

  • pollutant_description – A string of full pollutant name. For chemical compounds, this is the .IUPAC name (i.e. sulfur dioxide).
  • units – In which units the pollutant concentration in measured.
  • concentration – Value on the pollutant concentration.