Air Quality
The Air Quality endpoint provides a day-by-day air pollution forecast for a selected location. The response contains daily concentration values and AQI:
particulate_matter2: PM2.5 concentration.particulate_matter10: PM10 concentration.carbon_monoxide: CO concentration.sulphur_dioxide: SO2 concentration.nitrogen_dioxide: NO2 concentration.ozone: O3 concentration.aqi: Air Quality Index.
Request Parameters
slug|latandlon|ip: Location parameters.days: The number of days to return.X-tokenorkey: Your API token passed in the request header or query string.
Search Methods
Use one location method per request:
sluglat+lonip
Authentication is required for all methods: use X-token header or key query parameter.
Request Format
| Query option | Required params | Example query string |
|---|---|---|
| By slug | slug, days | ?slug=russia-moscow&days=6 |
| By coords | lat, lon, days | ?lat=55.7558&lon=37.6173&days=6 |
| By IP | ip, days | ?ip=8.8.8.8&days=6 |
Minimal Examples
Available slug values are listed in the Geography API section.
Description of the Response Structure
| Field | Description | Format |
|---|---|---|
time | Forecast date and time in UTC (ISO 8601). | String |
particulate_matter2 | PM2.5 concentration. | Number |
particulate_matter10 | PM10 concentration. | Number |
carbon_monoxide | Carbon monoxide (CO) concentration. | Number |
sulphur_dioxide | Sulphur dioxide (SO2) concentration. | Number |
nitrogen_dioxide | Nitrogen dioxide (NO2) concentration. | Number |
ozone | Ozone (O3) concentration. | Number |
aqi | Air Quality Index value for the day. | Number |