POST AI agent ready /v1/air-quality/check

Air Quality API - AQI & Pollutant Levels by Coordinates

Returns the current Air Quality Index (both US EPA and European scales) and individual pollutant concentrations for a given latitude and longitude. Pollutants include PM2.5, PM10, carbon monoxide, nitrogen dioxide, sulphur dioxide, and ozone.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/air-quality/check \
  -H "Content-Type: application/json" \
  -d '{"lat":40.7128,"lng":-74.006}'

When to use this API

Health and fitness app recommendations

Check local air quality before recommending outdoor activities. When AQI exceeds 100 (Unhealthy for Sensitive Groups), suggest indoor workouts instead of running or cycling outdoors. Display a color-coded AQI badge in the app dashboard.

Real estate and property listing enrichment

Add air quality scores to property listings. Buyers searching for homes can filter by average AQI, and listing pages can display current pollutant levels alongside neighborhood data like schools and transit.

Environmental monitoring dashboards

Build a live air quality dashboard that polls this endpoint every 30 minutes for multiple locations. Display historical trends, set threshold alerts for PM2.5 or ozone spikes, and generate daily air quality reports for facility managers.

Frequently asked questions

What is the difference between US and European AQI?

The US EPA AQI scale runs from 0-500 with breakpoints at 50 (Good), 100 (Moderate), 150 (Unhealthy for Sensitive Groups), and higher. The European AQI uses a 0-100+ scale with different pollutant weighting. Both are returned so you can use the scale your audience expects.

What units are the pollutant concentrations in?

PM2.5 and PM10 are in micrograms per cubic meter (ug/m3). Carbon monoxide is in ug/m3. Nitrogen dioxide, sulphur dioxide, and ozone are in ug/m3. These are standard atmospheric measurement units.

How often is air quality data refreshed?

Air quality readings update hourly from upstream monitoring networks. For most use cases, caching for 30-60 minutes is reasonable.

Can I get air quality data for a city name instead of coordinates?

This endpoint requires lat/lng coordinates. Use the geo geocode endpoint first to convert a city name to coordinates, then pass those to this endpoint.

What does aqi_category mean?

The aqi_category field returns a human-readable label based on the US EPA AQI: "Good" (0-50), "Moderate" (51-100), "Unhealthy for Sensitive Groups" (101-150), "Unhealthy" (151-200), "Very Unhealthy" (201-300), or "Hazardous" (301+).

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.