Air Quality API v2

Last updated:Nov 1, 2018

The Air Quality API lets you request air quality information including indexes, pollutants, and health recommendations for a specific location. The API provides endpoints that let you query:

Current Conditions

Last updated:Nov 1, 2018

Returns current air-quality conditions for a specific location

https://api.breezometer.com/air-quality/v2/current-conditions?lat={latitude}&lon={longitude}&key={Your_API_Key}&features={Features_List}

Request Parameters

While making an API request some parameters are required while some are optional.

lat
float
Latitude (lat) specifies north-south position of a point in a range between -90 and 90
Required
lon
float
Longitude (lon) specifies east-west position of a point in a range between -180 to 180
Required
key
string
Your BreezoMeter API key
Required
features
string
Sets the data fields returned by the response. Possible values:
  • breezometer_aqi (default)
  • local_aqi
  • health_recommendations
  • sources_and_effects
  • dominant_pollutant_concentrations
  • pollutants_concentrations
  • pollutants_aqi_information
For the list of the data fields returned with each feature, see Features List
Example: breezometer_aqi,local_aqi,sources_and_effects
Note: You must separate every two features with a comma, and use the exact naming convention as shown in the possible values.
Optional
default: breezometer_aqi
metadata
boolean
Includes request metadata in the response
Optional
default: false
lang
string
Sets the response language to either:
  • en for English (default)
  • fr for French
Optional
default: en

Examples

Last updated:Nov 1, 2018

Default Request Settings

This example shows a request to get the current air quality conditions for central Paris (48.857456, 2.354611) using the default request parameters settings.

https://api.breezometer.com/air-quality/v2/current-conditions?lat=48.857456&lon=2.354611&key={Your_API_Key}

TIP

Note:

In this example only some of the available data fields returns, as it uses the default settings, which sets only the breezometer_aqi feature.

The request returns this response:

    "loading..."  

Customized Request

In the example, the request was customized to include additional features:

https://api.breezometer.com/air-quality/v2/current-conditions?lat=48.857456&lon=2.354611&key={Your_API_Key}&features=breezometer_aqi,local_aqi,health_recommendations,sources_and_effects,pollutants_concentrations,pollutants_aqi_information

TIP

Note:

Both request made with default and customized settings are counted as a single object, regardless of the number of features included in the original query.

    "loading..."  

Response Data Fields

Last updated:Nov 1, 2018

The response data field is an object that includes the following fields:

TIP

Note:

  • As in requests to the current conditions endpoint, the most recent data is returned, the data_available field is always returned with true value.
datetime
string
ISO 8601 UTC timestamp indicating the time the data refers to
data_available
boolean
True/false indicating whether the expected data is available
indexes
object
Dictionary of two air quality indexes:
  • BreezoMeter AQI (baqi)
  • Local AQI set to be the default index for requested location (country)
For the list of supported indexes, see Air Quality Indexes
Show child fields
pollutants
object
Dictionary of available pollutants at the requested location.
Note:
  • This dictionary will be returned only for requests specifies the features parameter, and set it up with at least one of these options:
    • sources_and_effects
    • dominant_pollutant_concentrations
    • pollutants_concentrations
    • pollutants_aqi_information and breezometer_aqi
  • The specific pollutants returned under this dictionary, are based on the logic of the features specified in the request.

    For the logic of each of the features, see Features List
Show child fields
health_recommendations
object
Object containing BreezoMeter health advice and recommended actions relates to the reported air quality conditions. Recommendations are tailored for at risk populations and groups with greater sensitivities to pollutants than the general population
Show child fields

Hourly Forecast

Last updated:Nov 1, 2018

Returns hourly air-quality forecasts for the specified location. Each forecast includes hourly air quality indexes, pollutant data, and health recommendations for a maximum of 96 hours (4 days).

Requesting Hourly Forecasts

You can request forecasts for:

  1. A specific date and time
  2. The next number of hours
  3. Over a time period

TIP

Apart from the parameters that indicate the required time period, requests to the Hourly Forecast API endpoint use the same parameters

1. Specific date and time

To request hourly forecasts from the specified date and time, use this URL and set the datetime parameter to the required date and time:

https://api.breezometer.com/air-quality/v2/forecast/hourly?lat={latitude}&lon={longitude}&key={Your_API_Key}&datetime={the_required_date_and_time}&features={Features_List}

2. Next number of past hours

To request hourly forecasts for the next number of hours, use this URL and set the hours parameter for the required number of hours:

https://api.breezometer.com/air-quality/v2/forecast/hourly?lat={latitude}&lon={longitude}&key={Your_API_Key}&hours={number_of_forecast_hours}&features={Features_List}

3. Time period/date range

To request hourly forecasts over a defined time period, use this URL and set the start_datetime and end_datetime to indicate the time and dates the period starts and ends:

https://api.breezometer.com/air-quality/v2/forecast/hourly?lat={latitude}&lon={longitude}&key={Your_API_Key}&start_datetime={the_required_start_date_and_time}&end_datetime={the_required_end_date_and_time}&features={Features_List}

Request Parameters

While making an API request some parameters are required while some are optional.

lat
float
Latitude (lat) specifies north-south position of a point in a range between -90 and 90
Required
lon
float
Longitude (lon) specifies east-west position of a point in a range between -180 to 180
Required
key
string
Your BreezoMeter API key
Required
datetime
string
OR
ISO 8601 UTC datetime (including timezone) from which to return hourly forecasts
OR
hours
integer
OR
Number from 1 to 96 that indicates how many hourly forecast to request
OR
start_datetime
end_datetime
string
ISO 8601 UTC datetime (including timezone) that indicates from when, and until when to request forecasts
Required
Notice: Only one of these options can be included in each hourly forecast API endpoint request.
features
string
Sets the data fields returned by the response. Possible values:
  • breezometer_aqi (default)
  • local_aqi
  • health_recommendations
  • sources_and_effects
  • dominant_pollutant_concentrations
  • pollutants_concentrations
  • pollutants_aqi_information
For the list of the data fields returned with each feature, see Features List
Example: breezometer_aqi,local_aqi,sources_and_effects
Note: You must separate every two features with a comma, and use the exact naming convention as shown in the possible values.
Optional
default: breezometer_aqi
metadata
boolean
Includes request metadata in the response
Optional
default: false
lang
string
Sets the response language to either:
  • en for English (default)
  • fr for French
Optional
default: en

Examples

Last updated:Nov 1, 2018

The URLs in the following examples do not include the feature parameter, therefore the default dataset is returned in the API response.

TIP

Notes:

  • Each example request is being sent now, on UTC, they request data for central Paris (Latitude:48.857456, Longitude: 2.354611).
  • The resolution of requests to these endpoint is hourly. This means that received requests round the specified datetime to the previous exact hour. For example a request sent where the datetime parameter is set to will be rounded down to

1. Specific Date and Time

This request returns hourly forecasts for UTC.

https://api.breezometer.com/air-quality/v2/forecast/hourly?lat=48.857456&lon=2.354611&key={Your_API_Key}&datetime=

TIP

Notes:

In hourly forecast requests, the datetime parameter, must be:

  • Later than the exact UTC time for the next hour.
  • Up to 96 hours from the current time
  • Within the period permitted for your account for hourly forecast endpoint request

    "loading..."  

2. Next number of hours

This request returns three hourly forecasts from UTC

https://api.breezometer.com/air-quality/v2/forecast/hourly?lat=48.857456&lon=2.354611&key={Your_API_Key}&hours=3

TIP

Notes:

In hourly forecast requests, the hours parameter, must be:

  • Up to 96 hours from the current time
  • Within the period permitted for your account for hourly forecast endpoint request

The request returns this response:

    "loading..."  

3. Time period/date range

This request returns hourly forecasts starting from UTC and ending on UTC.

https://api.breezometer.com/air-quality/v2/forecast/hourly?lat=48.857456&lon=2.354611&key={Your_API_Key}&start_datetime=&end_datetime=

TIP

Notes:

In hourly forecast requests, the start_datetime and end_datetime parameters, must:

  • Include start_datetime and end_datetime parameters
  • Set the start_datetime parameter to a time that is:
    • Later than the exact UTC time for the next hour
    • To precedes end_datetime
  • Set the end_datetime parameter to a time that is upto 96 hours from the current time
  • Within the period permitted for your account for hourly forecast endpoint request

The request returns this response:

    "loading..."  

Response Data Fields

Last updated:Nov 1, 2018

The response data field is an object or an array of objects, where each of them include the following fields:

TIP

Note:

  • As in requests to the hourly forecasts endpoint, there is no concern for a missing forecast data, the data_available field is always returned with true value for any of the objects in the response.
datetime
string
ISO 8601 UTC timestamp indicating the time the data refers to
data_available
boolean
True/false indicating whether the expected data is available
indexes
object
Dictionary of two air quality indexes:
  • BreezoMeter AQI (baqi)
  • Local AQI set to be the default index for requested location (country)
For the list of supported indexes, see Air Quality Indexes
Show child fields
pollutants
object
Dictionary of available pollutants at the requested location.
Note:
  • This dictionary will be returned only for requests specifies the features parameter, and set it up with at least one of these options:
    • sources_and_effects
    • dominant_pollutant_concentrations
    • pollutants_concentrations
    • pollutants_aqi_information and breezometer_aqi
  • The specific pollutants returned under this dictionary, are based on the logic of the features specified in the request.

    For the logic of each of the features, see Features List
Show child fields
health_recommendations
object
Object containing BreezoMeter health advice and recommended actions relates to the reported air quality conditions. Recommendations are tailored for at risk populations and groups with greater sensitivities to pollutants than the general population
Show child fields

Hourly History

Last updated:Nov 1, 2018

Returns historical hourly air-quality information for the specified location. Each request includes hourly air quality indexes, pollutant data, and health recommendations for a maximum of 720 hours (30 days).

Requesting Hourly History

You can request history for:

  1. A specific date and time
  2. The previous number of past hours
  3. A time period

TIP

Note:

Apart from the parameters that indicate the required time period, requests to the Hourly History API endpoint use the same parameters

1. Specific date and time

To request hourly history from the specified date and time, use this URL and set the datetime parameter to the required date and time:

https://api.breezometer.com/air-quality/v2/historical/hourly?lat={latitude}&lon={longitude}&key={Your_API_Key}&datetime={the_required_date_and_time}&features={Features_List}

2. Previous number of past hours

To request hourly history for the previous number of hours, use this URL and set the hours parameter for the required number of hours:

https://api.breezometer.com/air-quality/v2/historical/hourly?lat={latitude}&lon={longitude}&key={Your_API_Key}&hours={number_of_history_hours}&features={Features_List}

3. Time period/date range

To request hourly historical data over a defined time period, use this URL and set the start_datetime and end_datetime to indicate the time and dates the period starts and ends:

https://api.breezometer.com/air-quality/v2/historical/hourly?lat={latitude}&lon={longitude}&key={Your_API_Key}&start_datetime={the_required_start_date_and_time}&end_datetime={the_required_end_date_and_time}&features={Features_List}

Request Parameters

While making an API request some parameters are required while some are optional.

lat
float
Latitude (lat) specifies north-south position of a point in a range between -90 and 90
Required
lon
float
Longitude (lon) specifies east-west position of a point in a range between -180 to 180
Required
key
string
Your BreezoMeter API key
Required
datetime
string
OR
ISO 8601 UTC datetime (including timezone) from which to return hourly forecasts
OR
hours
integer
OR
Number from 1 to 96 that indicates how many hourly forecast to request
OR
start_datetime
end_datetime
string
ISO 8601 UTC datetime (including timezone) that indicates from when, and until when to request forecasts
Required
Notice: Only one of these options can be included in each hourly forecast API endpoint request.
features
string
Sets the data fields returned by the response. Possible values:
  • breezometer_aqi (default)
  • local_aqi
  • health_recommendations
  • sources_and_effects
  • dominant_pollutant_concentrations
  • pollutants_concentrations
  • pollutants_aqi_information
For the list of the data fields returned with each feature, see Features List
Example: breezometer_aqi,local_aqi,sources_and_effects
Note: You must separate every two features with a comma, and use the exact naming convention as shown in the possible values.
Optional
default: breezometer_aqi
metadata
boolean
Includes request metadata in the response
Optional
default: false
lang
string
Sets the response language to either:
  • en for English (default)
  • fr for French
Optional
default: en

Examples

Last updated:Nov 1, 2018

The URLs in the following examples do not include the feature parameter, therefore the default dataset is returned in the API response.

TIP

Notes:

  • Each example request is being sent now, on UTC, they request data for central Paris (Latitude:48.857456, Longitude: 2.354611).
  • The resolution of requests to these endpoint is hourly. This means that received requests round the specified datetime to the previous exact hour. For example a request sent where the datetime parameter is set to will be rounded down to

1. Specific Date and Time

This request returns hourly history from UTC.

https://api.breezometer.com/air-quality/v2/historical/hourly?lat=48.857456&lon=2.354611&key={Your_API_Key}&datetime=

TIP

Notes:

In hourly history requests, the datetime parameter, must be:

  • Precede the exact UTC time
  • Within 720 hours from the current time
  • Within the period permitted for your account for hourly history endpoint request

The request returns this response:

    "loading..."  

2. Previous number of past hours

This request returns three hourly history from UTC

https://api.breezometer.com/air-quality/v2/historical/hourly?lat=48.857456&lon=2.354611&key={Your_API_Key}&hours=3

TIP

Notes:

In hourly history requests, the hours parameter, must be:

  • A number between 1 and 720 hours
  • Within the period permitted for your account for hourly historical endpoint request

The request returns this response:

    "loading..."  

3. Time period/date range

This request returns hourly historical starting from UTC and ending on UTC.

https://api.breezometer.com/air-quality/v2/historical/hourly?lat=48.857456&lon=2.354611&key={Your_API_Key}&start_datetime=&end_datetime=

TIP

Notes:

In hourly forecast requests, the start_datetime and end_datetime parameters, must:

  • Include start_datetime and end_datetime parameters
  • Set the start_datetime parameter to a time that is:
    • Up to 720 hours from the current time
    • To precedes end_datetime
  • Set the end_datetime parameter to a time that precedes the exact UTC time
  • Within the period permitted for your account for hourly history endpoint request

The request returns this response:

    "loading..."  

Response Data Fields

Last updated:Nov 1, 2018

The response data field is an object or an array of objects, where each of them include the following fields:

TIP

Note:

  • In case there is a missing data for a specific object (which represents a specific hour), the data_available field in that specific object returns with false, and the rest of the expected root level elements (Indexes, pollutants, and Health_recommendations) returns null
datetime
string
ISO 8601 UTC timestamp indicating the time the data refers to
data_available
boolean
True/false indicating whether the expected data is available
indexes
object
Dictionary of two air quality indexes:
  • BreezoMeter AQI (baqi)
  • Local AQI set to be the default index for requested location (country)
For the list of supported indexes, see Air Quality Indexes
Show child fields
pollutants
object
Dictionary of available pollutants at the requested location.
Note:
  • This dictionary will be returned only for requests specifies the features parameter, and set it up with at least one of these options:
    • sources_and_effects
    • dominant_pollutant_concentrations
    • pollutants_concentrations
    • pollutants_aqi_information and breezometer_aqi
  • The specific pollutants returned under this dictionary, are based on the logic of the features specified in the request.

    For the logic of each of the features, see Features List
Show child fields
health_recommendations
object
Object containing BreezoMeter health advice and recommended actions relates to the reported air quality conditions. Recommendations are tailored for at risk populations and groups with greater sensitivities to pollutants than the general population
Show child fields

Customizing API Requests

Last updated:Nov 1, 2018

You can customize any API request to only include the data you need for your software. This allows you to save bandwidth and decrease response time by requesting less information. You customize request data returned using the features parameter to define the feature or list of features to include in the response.

Example

The following returns current air quality conditions including the breezometer_aqi, local_aqi, and sources_and_effects features:

https://api.breezometer.com/air-quality/v2/current-conditions?lat=48.857456&lon=2.354611&key={Your_API_Key}&features=breezometer_aqi,local_aqi,sources_and_effects

TIP

Note:

Unless you have specified the features parameter in the request, the response returns only the BreezoMeter AQI information.

Features

Last updated:Nov 1, 2018

Here are the various supported features and details on each of them.

Feature Description
breezometer_aqi BreezoMeter air quality index, including its value, color, category, and the dominant pollutant according to that index.

This data is located in the data > indexes > baqi object

The response includes these fields: display_name, aqi, aqi_display, color, category, and dominant_pollutant

Note:
BreezoMeter Air Quality Index (BAQI), is a globally unified index that uses a scale of 0 (Poor) to 100 (Excellent). BAQI simplifies comparing air quality between countries. For more information, see BreezoMeter AQI (↪)
local_aqi Local (national) air quality index for the requested location (country), including its value, color, category, and the dominant pollutant according to that index.This data is located in the data > indexes > {index code} object

For the list of supported indexes codes, see Air Quality Indexes

The response includes these fields: display_name, aqi, aqi_display, color, category, and dominant_pollutant

Note:
BreezoMeter supports more than 55 official local indexes.
health_recommendations BreezoMeter health advice and recommended actions for current AQI conditions. Recommendations are tailored for the general population, and six at risk populations and groups with greater sensitivities to pollutants than the general population

This data is located in the data > indexes > health_recommendations object

The response includes these recommendations: general_population, elderly, lung_diseases, heart_diseases, active, pregnant_women, and children

Pollutants Features

Here are the rest of the features, all of which return information on pollutants

TIP

Note:

If you include in your request any of the following features, the display_name and full_name data fields will also be returned under each of the relevant pollutants as part of the response

Feature Description
sources_and_effects Sources and effects for each of the pollutants returned in the response

This data is located in the data > pollutants > {pollutant code} > sources_and_effects object

The response includes these fields: sources, effects
dominant_pollutant_concentrations Concentrations of the dominant pollutants measured according to BreezoMeter and/or local indexes

This data is located in the data > pollutants > {pollutant code} > concentration object

The response includes these fields: value, units

Note:
If the request specified both the breezometer_aqi and the local_aqi features, there may be upto two {pollutant code} returned with concentration object
pollutants_concentrations Concentrations of all pollutants with available measurements according to BreezoMeter and/or local indexes

This data is located in the data > pollutants > {pollutant code} > concentration object

The response includes these fields: value, units
pollutants_aqi_information Detailed BreezoMeter index information for each of the six common pollutants the index is based on. It describes the severity of each pollutants with the relevant value, color, and category.

This data is located in the data > pollutants > {pollutant code} > aqi_information > baqi object

The response includes these fields: display_name, aqi, aqi_display, color, and category

Note:
This feature can only be used for requests that specified the breezometer_aqi feature as well

Metadata

Last updated:Nov 1, 2018

Request Metadata

Last updated:Nov 1, 2018

Any request to an API endpoint can return metadata that describes the original request. You request metadata by including the metadata parameter in your request with the value true. When excluding the metadata parameter, or setting it to false, the metadata field returns null.

When requested, it has slightly different structure, depending on the request type.

Single Object

Requests for a specific date and time return a single object, and a metadata object with a single timestamp. This example shows a request to the hourly forecast endpoint for a specific date and time that returns metadata:

https://api.breezometer.com/air-quality/v2/forecast/hourly?lat=48.857456&lon=2.354611&key={Your_API_Key}&datetime=&metadata=true

The request returns this metadata object as part of the response:

    "loading..."  

Array of Objects

Requests for the next number of hours or time period return an array of objects, and a metadata object with a range of timestamps. This example shows a request to the hourly forecast API endpoint for the next three hours that returns metadata:

https://api.breezometer.com/air-quality/v2/forecast/hourly?lat=48.857456&lon=2.354611&key={Your_API_Key}&hours=3&metadata=true

The request’s JSON response includes the following metadata object:

    "loading..."  

Metadata Fields

Metadata objects can include these fields.

timestamp
string
OR
In Request for a Single Object - ISO 8601 UTC timestamp indicating the time the request was made
OR
start_timestamp
end_timestamp
string
In Request for an Array of Objects - Two ISO 8601 UTC timestamps:
  • start_timestamp - indicates from when the hourly data was requested
  • end_timestamp - indicates until when the hourly data was requested
location
object
Object containing information describing the requested location
Show child fields
indexes
object
Dictionary of upto two air quality indexes: (as included in the response data)
  • BreezoMeter AQI (baqi)
  • Local AQI set to be the default index for requested location (country)
Show child fields

Supported Pollutants

Last updated:Nov 1, 2018

The BreezoMeter API supports various pollutants, which it make accessible through the different air quality endpoints. Pollutants availability is subject to actual measurements and reports available for BreezoMeter to use, and is changing between different locations.

Here are the various pollutants codes and their metadata we might return:

Code Display Name Full Name Units Measured
co CO Carbon monoxide ppb
c6h6 C6H6 Benzene ug/m3
ox Ox Photochemical oxidants ppb
o3 O3 Ozone ppb
nh3 NH3 Ammonia ppb
nmhc NMHC Non-methane hydrocarbons ppb
no NO Nitrogen monoxide ppb
nox NOx Nitrogen oxides ppb
no2 NO2 Nitrogen dioxide ppb
pm25 PM25 Fine particulate matter (<2.5µm) ug/m3
pm10 PM10 Inhalable particulate matter (<10µm) ug/m3
so2 SO2 Sulfur dioxide ppb
trs TRS Total reduced sulfur ug/m3

Supported Air Quality Indexes

Last updated:Nov 1, 2018

The BreezoMeter API supports over 50 different air quality indexes, including its own BreezoMeter Air Quality Index.

Here are the various indexes codes and their metadata we might return:

Code Display Name Best Value Worst Value Categories Pollutants
and_aire IQA (AD) 1 5 "Excellent air quality", "Good air quality", "Regular air quality", "Poor air quality", "Bad air quality" "o3", "pm10", "no2", "so2", "co"
aus_combined AQI (AU) 0 200 "Very good air quality", "Good air quality", "Fair air quality", "Poor air quality", "Very poor air quality", "Hazardous air quality" "co", "no2", "o3", "so2", "pm10", "pm25"
aut_umwelt AQI (AT) 1 5 "1 - Green", "2 - Light green", "3 - Yellow", "4 - Orange", "5 - Red" "o3", "pm10", "no2", "so2", "co"
aut_vienna AQI (AT-Vienna) 1 6 "Very good air quality", "Good air quality", "Satisfactory air quality", "Unsatisfactory air quality", "Bad air quality", "Very bad air quality" "o3", "pm10", "no2", "so2", "co"
baqi BreezoMeter AQI 100 0 "Excellent air quality", "Good air quality", "Moderate air quality", "Low air quality", "Poor air quality" "co", "no2", "o3", "ox", "pm10", "pm25", "so2"
bel_irceline BelATMO (BE) 1 10 "Excellent air quality", "Very good air quality", "Good air quality", "Fairly good air quality", "Moderate air quality", "Poor air quality", "Very poor air quality", "Bad air quality", "Very bad air quality", "Horrible air quality" "so2", "no2", "o3", "pm10"
bgd_case AQI (BD) 0 500 "Good air quality", "Moderate air quality", "Caution", "Unhealthy air quality", "Very Unhealthy air quality", "Extremely Unhealthy air quality" "co", "no2", "o3", "so2", "pm10", "pm25"
bgr_niggg AQI (BG) 1 10 "Low air pollution", "Low air pollution", "Low air pollution", "Moderate air pollution", "Moderate air pollution", "Moderate air pollution", "High air pollution", "High air pollution", "High air pollution", "Very High air pollution" "so2", "no2", "pm10", "co", "o3"
bra_saopaulo AQI (BR) 0 201 "N1 – Good air quality", "N2 – Moderate air quality", "N3 – Bad air quality", "N4 – Very bad air quality", "N5 – Terrible air quality" "co", "no2", "o3", "so2", "pm10", "pm25"
can_ec AQHI (CA) 1 11 "Low health risk", "Low health risk", "Low health risk", "Moderate health risk", "Moderate health risk", "Moderate health risk", "High health risk", "High health risk", "High health risk", "High health risk", "Very high health risk" "no2", "o3", "pm25", "pm10"
caqi CAQI (EU) 0 101 "Very low air pollution", "Low air pollution", "Medium air pollution", "High air pollution", "Very high air pollution" "no2", "o3", "co", "so2", "pm10", "pm25"
che_cerclair KBI (CH) 1 6 "Minimal air pollution", "Moderate air pollution", "Distinct air pollution", "Significant air pollution", "High air pollution", "Very high air pollution" "pm10", "o3", "no2"
chn_mep AQI (CN) 0 500 "Excellent air quality", "Good air quality", "Light air pollution", "Moderate air pollution", "Heavy air pollution", "Severe air pollution" "so2", "no2", "co", "o3", "pm10", "pm25"
chn_mep_1h AQI-1h (CN) 0 500 "Excellent air quality", "Good air quality", "Light air pollution", "Moderate air pollution", "Heavy air pollution", "Severe air pollution" "so2", "no2", "co", "o3", "pm10", "pm25"
col_rmcab IBOCA (CO) 0 100 "Fair air quality", "Moderate air quality", "Regular air quality", "Bad air quality", "Very bad air quality", "Hazardous air quality" "o3", "pm25", "pm10", "co", "so2", "no2"
cri_icca ICCA (CR) 0 100 "Good air quality", "Unfavorable air quality for sensitive groups ", "Unfavorable air quality", "Very unfavorable air quality", "Hazardous air quality" "co", "no2", "o3", "so2", "pm10", "pm25"
cyp_dli AQI (CY) 1 4 "Low air pollution", "Moderate air pollution", "High air pollution", "Very high air pollution" "so2", "no2", "co", "o3", "pm10", "pm25", "c6h6"
cze_chmi AQI (CZ) 1 6 "Very good air quality", "Good air quality", "Fair air quality", "Suitable air quality", "Poor air quality", "Very poor air quality" "o3", "pm10", "no2", "so2", "co"
deu_lubw LuQx (DE) 1 6 "Very good air quality", "Good air quality", "Satisfactory air quality", "Sufficient air quality", "Bad air quality", "Very bad air quality" "no2", "so2", "co", "o3", "pm10"
dnk_aarhus AQI (DK) 1 5 "Below average air pollution", "Average air pollution", "Above average air pollution", "High air pollution", "Warning level air pollution" "no2", "co", "o3"
ecu_quitoambiente IQCA (EC) 0 500 "Desirable air quality", "Acceptable air quality", "Precautionary level", "Alert level", "Alarm level", "Emergency level" "co", "o3", "no2", "so2", "pm25", "pm10"
esp_madrid AQI (ES) 0 151 "Good air quality", "Acceptable air quality", "Poor air quality", "Bad air quality" "pm10", "co", "no2", "so2", "o3"
est_ekuk AQI (EE) 0 100 "Very Good air quality", "Good air quality", "Medium air quality", "Bad air quality", "Very Bad air quality" "so2", "no2", "co", "o3", "pm10", "pm25", "nh3", "c6h6"
fin_hsy AQI (FI) 0 151 "Good air quality", "Satisfactory air quality", "Fair air quality", "Poor air quality", "Very poor air quality" "so2", "no2", "pm10", "pm25", "o3", "co", "trs"
fra_atmo AQI (FR) 1 10 "Very good air quality", "Good air quality", "Average air quality", "Mediocre air quality", "Bad air quality", "Very bad air quality" "so2", "no2", "o3", "pm10"
gbr_defra DAQI (UK) 1 10 "Low air pollution", "Low air pollution", "Low air pollution", "Moderate air pollution", "Moderate air pollution", "Moderate air pollution", "High air pollution", "High air pollution", "High air pollution", "Very high air pollution" "no2", "o3", "so2", "pm25", "pm10"
gib_gea AQHI (GI) 1 10 "Low air pollution", "Moderate air pollution", "High air pollution", "Very high air pollution" "o3", "no2", "so2", "co", "pm10"
hkg_epd AQHI (HK) 1 11 "Low air pollution", "Moderate air pollution", "High air pollution", "Very high air pollution", "Serious air pollution" "so2", "no2", "o3", "pm25", "pm10"
hrv_azo AQI (HR) 0 101 "Very low air pollution", "Low air pollution", "Medium air pollution", "High air pollution", "Very high air pollution" "no2", "o3", "co", "so2", "pm10", "pm25"
hun_bler AQI (HU) 1 10 "Low air pollution", "Medium air pollution", "High air pollution", "Very high air pollution" "no2", "pm10", "so2", "o3", "co"
idn_menlhk ISPU (ID) 0 500 "Good air quality", "Moderate air quality", "Unhealthy air quality", "Very unhealthy air quality", "Hazardous air quality" "o3", "pm10", "co", "so2", "no2"
ind_cpcb AQI (IN) 0 500 "Good air quality", "Satisfactory air quality", "Moderate air quality", "Poor air quality", "Very poor air quality", "Severe air quality" "pm10", "pm25", "no2", "o3", "co", "so2", "nh3"
irl_epa AQIH (IE) 1 10 "Good air quality", "Good air quality", "Good air quality", "Fair air quality", "Fair air quality", "Fair air quality", "Poor air quality", "Poor air quality", "Poor air quality", "Very poor air quality" "o3", "no2", "so2", "pm25", "pm10"
isr_moep AQI (IL) 100 -400 "Good air quality", "Medium air pollution", "High air pollution", "Very high air pollution" "o3", "so2", "no2", "nox", "co", "pm10", "pm25"
ita_moniqa AQI (IT) 0 201 "Good air quality", "Fair air quality", "Moderate air quality", "Poor air quality", "Bad air quality" "co", "no2", "o3", "so2", "pm10", "pm25"
jpn_aeros AQI (JP) 0 100 "1 - Blue", "2 - Cyan", "3 - Green", "4 - Yellow/Watch", "5 - Orange/Alert", "6 - Red/Alert+" "so2", "no", "no2", "ox", "nmhc", "pm10", "pm25"
kor_airkorea CAI (KR) 0 500 "Good air quality", "Average air quality", "Bad air quality", "Very bad air quality" "pm25", "pm10", "so2", "co", "o3", "no2"
kwt_beatona KAQI (KW) 0 500 "Very good air quality", "Good air quality", "Moderate air quality", "Bad air quality", "Very bad air quality" "co", "o3", "no2", "so2", "pm10"
ltu_gamta OUI (LT) 1 5 "Very low air pollution", "Low air pollution", "Average air pollution", "High air pollution", "Very high air pollution" "o3", "pm10", "no2", "so2", "co"
lux_emwelt AQI (LU) 1 10 "Excellent air quality", "Very good air quality", "Good air quality", "Fairly good air quality", "Moderate air quality", "Poor air quality", "Very poor air quality", "Bad air quality", "Very bad air quality", "Horrible air quality" "o3", "no2", "no", "co", "so2", "pm10"
mex_cdmx IMECA (MX) 0 201 "Good air quality", "Regular air quality", "Poor air quality", "Very poor air quality", "Extremely poor air quality" "so2", "no2", "pm10", "pm25", "o3", "co"
mex_gto IMECA (MX-Guanajuato) 0 100 "Good air quality", "Satisfactory air quality", "Unsatisfactory air quality", "Bad air quality", "Very bad air quality" "so2", "no2", "pm10", "o3", "co"
mkd_moepp AQI (MK) 0 101 "Very low air pollution", "Low air pollution", "Medium air pollution", "High air pollution", "Very high air pollution" "no2", "o3", "co", "so2", "pm10", "pm25"
mng_ubgov AQI (MN) 0 501 "Clean", "Normal", "Slightly Polluted", "Polluted", "Heavily Polluted", "Seriously Polluted" "co", "no2", "o3", "so2", "pm10", "pm25"
mys_doe API (MY) 0 500 "Good air quality", "Moderate air quality", "Unhealthy air quality", "Very unhealthy air quality", "Hazardous air quality" "co", "no2", "o3", "so2", "pm10"
nld_rivm LKI (NL) 1 11 "Good air quality", "Good air quality", "Good air quality", "Moderate air quality", "Moderate air quality", "Moderate air quality", "Insufficient air quality", "Insufficient air quality", "Bad air quality", "Bad air quality", "Very bad air quality" "no2", "pm10", "pm25", "o3"
nor_nilu AQI (NO) 1 100 "Low air pollution", "Moderate air pollution", "High air pollution", "Very high air pollution" "pm10", "pm25", "no2", "so2", "o3"
npl_doenv AQI (NP) 0 500 "Good air quality", "Satisfactory air quality", "Moderately polluted", "Poor air quality", "Very poor air quality", "Severe air quality" "pm10", "pm25", "no2", "o3", "co", "so2"
per_infoaire INCA (PE) 1 4 "Good air quality", "Moderate air quality", "Bad air quality", "Alert threshold" "o3", "pm10", "pm25", "no2", "so2", "co"
pol_gios AQI (PL) 0 100 "Very good air quality", "Good air quality", "Moderate air quality", "Sufficient air quality", "Bad air quality", "Very bad air quality" "pm10", "pm25", "o3", "no2", "so2", "c6h6", "co"
prt_qualar IQar (PT) 0 40 "Very good air quality", "Good air quality", "Moderate air quality", "Low air quality", "Bad air quality" "co", "no2", "o3", "so2", "pm10"
rou_calitateaer AQI (RO) 1 6 "Excellent air quality", "Very good air quality", "Good air quality", "Moderate air quality", "Bad air quality", "Very bad air quality" "o3", "pm10", "no2", "so2", "co"
sgp_nea PSI (SG) 0 500 "Good air quality", "Moderate air quality", "Unhealthy air quality", "Very unhealthy air quality", "Hazardous air quality" "pm25", "pm10", "so2", "co", "o3", "no2"
srb_sepa SAQI_11 (RS) 1 5 "Excellent", "Good", "Acceptable", "Polluted", "Very Polluted" "so2", "no2", "pm10", "co", "o3"
tha_pcd AQI (TH) 0 500 "Good air quality", "Moderate air quality", "Unhealthy air quality", "Very unhealthy air quality", "Hazardous air quality" "co", "no2", "o3", "so2", "pm10"
tur_havaizleme HKI (TR) 0 500 "Good air quality", "Moderate air quality", "Unhealthy for sensitive groups air quality", "Unhealthy air quality", "Poor air quality", "Hazardous air quality" "pm10", "no2", "o3", "co", "so2"
twn_epa AQI (TW) 0 500 "Good air quality", "Moderate air quality", "Unhealthy air quality", "Very unhealthy air quality", "Hazardous air quality" "pm10", "so2", "co", "o3", "no2"
usa_epa AQI (US) 0 500 "Good air quality", "Moderate air quality", "Unhealthy for sensitive groups air quality", "Unhealthy air quality", "Very unhealthy air quality", "Hazardous air quality" "o3", "pm10", "pm25", "co", "so2", "no2"
vnm_vea AQI (VN) 0 301 "Good air quality", "Medium air quality", "Poor air quality", "Bad air quality", "Hazardous air quality" "co", "nox", "o3", "so2", "pm10"

For your convenience, you can download a JSON file with the above indexes metadata. The metadata available in any of the languages supported by the BreezoMeter API.

Integrate BreezoMeter's data in your products today

Get API Key
Talk to an expert