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 | lat and lon | ip: Location parameters.
  • days: The number of days to return.
  • X-token or key: Your API token passed in the request header or query string.

Search Methods

Use one location method per request:

  • slug
  • lat + lon
  • ip

Authentication is required for all methods: use X-token header or key query parameter.

Request Format

GET /v2/air/by-days/?{location_query}&days={days}
X-token: TOKEN
or
GET /v2/air/by-days/?{location_query}&days={days}&key=TOKEN
Query optionRequired paramsExample query string
By slugslug, days?slug=russia-moscow&days=6
By coordslat, lon, days?lat=55.7558&lon=37.6173&days=6
By IPip, days?ip=8.8.8.8&days=6

Minimal Examples

curl --location 'https://api.meteoflow.com/v2/air/by-days/?slug=russia-moscow&days=6' \
--header 'X-token: TOKEN'
curl --location 'https://api.meteoflow.com/v2/air/by-days/?lat=55.7558&lon=37.6173&days=6&key=TOKEN'
curl --location 'https://api.meteoflow.com/v2/air/by-days/?ip=8.8.8.8&days=6' \
--header 'X-token: TOKEN'

Description of the Response Structure

FieldDescriptionFormat
timeForecast date and time in UTC (ISO 8601).String
particulate_matter2PM2.5 concentration.Number
particulate_matter10PM10 concentration.Number
carbon_monoxideCarbon monoxide (CO) concentration.Number
sulphur_dioxideSulphur dioxide (SO2) concentration.Number
nitrogen_dioxideNitrogen dioxide (NO2) concentration.Number
ozoneOzone (O3) concentration.Number
aqiAir Quality Index value for the day.Number