Meteoprog Air Quality API provides city-level air quality forecast data and pollutant concentration data for websites, apps, dashboards, widgets, and monitoring systems. The endpoint returns AQI, PM2p5, PM10, SO2, and NO2 for a selected city and can be used as an air quality API, city air quality API, AQI API, air pollution data API, PM2.5 API, and PM10 API.
This page explains the endpoint, parameters, response fields, AQI scale, time intervals, forecast period, and city coverage.
Air Quality API endpoint
The main Air Quality API endpoint uses Meteoprog city ID as the location key and can be tested in Meteoprog API Sandbox before production integration.
/api/v1/{locale}/{format}/{apiKey}/aqi/city/{cityId}
Air Quality API parameters
The endpoint uses these URL parameters:
json or xml
Air Quality API response fields
Each time point contains:
AQI- air quality indexPM2p5- fine particulate matter smaller than 2.5 micrometersPM10- particulate matter smaller than 10 micrometersSO2- sulfur dioxide concentrationNO2- nitrogen dioxide concentration
Units of measurement:
PM2p5,PM10,SO2, andNO2are measured in µg/m³ (micrograms per cubic meter)
PM2p5 and PM10 describe particulate matter concentrations. SO2 and NO2 describe gaseous pollutant concentrations. AQI provides a simplified city-level air quality index for dashboards, widgets, weather pages, and tables.
AQI scale
AQI stands for Air Quality Index and uses a scale from 0 to 4:
- 0 - good
- 1 - satisfactory
- 2 - unhealthy for sensitive groups
- 3 - unhealthy
- 4 - poor
AQI is a derived air quality indicator based on pollutant concentration levels. In this scale, the poor level corresponds to an exceedance of the maximum one-time allowable concentration threshold.
AQI color legend
Time intervals and forecast period
The endpoint returns air quality forecast data at:
- 00:00
- 06:00
- 12:00
- 18:00
Forecast period:
- 4 days
- includes the current date
- 4 observations per day
In other Meteoprog methods, air quality indicators are also displayed in hourly views for convenience when air quality data is shown together with weather data.
Coverage and localization
Meteoprog API platform supports 2,150,000+ populated locations worldwide and 35+ languages.
This makes the endpoint suitable for international weather products, localized city pages, and multi-language applications.
Use cases
This air quality API can be used for:
- air quality forecast pages
- AQI widgets
- city pages with pollution data
- weather dashboards with AQI and PM values
- monitoring systems
Developer Access and production usage
This endpoint can be tested in Meteoprog API Sandbox and then used in production with plan-based limits, quota usage, and location scope depending on the selected plan.
FAQ
Is this a city-based air quality API?
Yes. The endpoint uses Meteoprog cityId and returns air quality data for a selected city.
Does the response include AQI and pollutant concentrations?
Yes. The response includes AQI, PM2p5, PM10, SO2, and NO2 for each available time point.
What forecast period and time intervals are available?
The endpoint returns 4 days of air quality forecast data, including the current date, at 00:00, 06:00, 12:00, and 18:00.
Are hourly air quality indicators available?
This endpoint returns 4 time points per day. In other Meteoprog methods, air quality indicators are also displayed in hourly views for convenience when air quality data is shown together with weather data.
Can this API be used in dashboards, widgets, and weather pages?
Yes. The data structure is suitable for AQI widgets, air quality forecast pages, city pages, and weather dashboards with pollutant values.