# Iqair Airvisual AI integration on Definable

> IQAir AirVisual provides global air quality data through its API, offering real-time and historical information on air pollution levels.

## What this connects

IQAir AirVisual provides global air quality data through its API, offering real-time and historical information on air pollution levels.

Vendor: https://dashboard.iqair.com/

## Tools available

**10** tools available. First 10:

- `IQAIR_AIRVISUAL_GET_AIR_QUALITY_FORECAST_DATA` — Get Air Quality Forecast Data — Tool to retrieve air quality forecast data for a specified city, state, and country. Use after confirming location details.
- `IQAIR_AIRVISUAL_GET_CITIES` — Get Cities — Tool to list supported cities in a specified state and country. Use when you need to retrieve cities for a given state/country.
- `IQAIR_AIRVISUAL_GET_CITY_AIR_QUALITY` — Get City Air Quality — Tool to retrieve air quality data for a specific city. Use when you need current pollution and weather data by specifying city, state, and country.
- `IQAIR_AIRVISUAL_GET_COUNTRIES` — Get supported countries — Tool to list all supported countries. Use when you need to know which countries are supported by the AirVisual API.
- `IQAIR_AIRVISUAL_GET_HISTORICAL_AQI_DATA` — Get Historical AQI Data — Tool to retrieve historical air quality data for a city. Use after confirming city, state, and country when you need AQI readings over time.
- `IQAIR_AIRVISUAL_GET_NEAREST_CITY_AIR_QUALITY` — Get Nearest City Air Quality — Tool to retrieve air quality data for the nearest city based on latitude/longitude or IP. Use when you have precise location data or want to geolocate an IP for air quality.
- `IQAIR_AIRVISUAL_GET_NEAREST_STATION_AIR_QUALITY` — Get Nearest Station Air Quality — Tool to get nearest station air quality. Use when you have GPS coordinates and need closest station’s AQI.
- `IQAIR_AIRVISUAL_GET_STATES` — Get States — Tool to list supported states in a specified country. Use when you need to retrieve states/provinces for a given country.
- `IQAIR_AIRVISUAL_GET_STATION_BY_ID` — Get Station by ID — Fetches current air quality and weather data for a specific location by station/city/state/country names. Falls back to city-level data if the Stations API requires premium access. Returns current AQI (US and China scales), weather conditions, and geographic location. Use Get Countries, Get States, and Get Cities actions to find valid location names.
- `IQAIR_AIRVISUAL_GET_WORLD_RANKING` — Get World AQI Rankings — Retrieves air quality ranking data. With premium API access, returns a global ranking of cities by AQI. With standard (free) API access, automatically falls back to returning the nearest city's air quality as a single-item ranking list. Use lat/lon coordinates or an IP address to specify location for the fallback behavior. Returns city name, location, and current AQI values (US EPA and Chinese MEP standards).

## Auth

Auth schemes: `API_KEY`.

## How agents use Iqair Airvisual

Inside a Definable workflow, Iqair Airvisual is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Iqair Airvisual** — the Researcher (GPT-5.5) pulls context from Iqair Airvisual (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Iqair Airvisual** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Iqair Airvisual (create record, post message, draft email).
- **Designer / Engineer → Distributor → Iqair Airvisual** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Iqair Airvisual (attach file, open PR comment, post status).

The Verifier checks every Iqair Airvisual call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/iqair_airvisual/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt