# IQAir API: Get air quality

> Gets a city's current air quality, weather, daily forecast and health advice from IQAir.

Unofficial. Not affiliated with or endorsed by IQAir.

- Page: https://fous.com/methods/iqair.com/get-air-quality
- Method: `iqair.com/get_air_quality`, version 1
- Website: iqair.com
- Returns: AQI, category, main pollutant, PM2.5, weather, daily forecast, health advice
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `city` | string | yes | `"Delhi"` | City to look up, for example Delhi. |
| `country` | string | no | `""` | Country to distinguish cities with the same name, for example India. Default "". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "city": "Delhi",
  "country": ""
}
```

Its output:

```json
{
  "city": "Delhi",
  "aqi_us": 176,
  "country": "India",
  "category": "Unhealthy",
  "iqair_url": "https://www.iqair.com/air-quality/india/delhi/delhi",
  "pm25_ug_m3": 90.5,
  "updated_at": "2026-10-23T14:30:00+05:30",
  "temperature_c": 32,
  "daily_forecast": [
    {
      "date": "2026-10-23",
      "aqi_us": 163,
      "category": "Unhealthy",
      "low_temperature_c": 25,
      "high_temperature_c": 33
    },
    {
      "date": "2026-10-24",
      "aqi_us": 160,
      "category": "Unhealthy",
      "low_temperature_c": 26,
      "high_temperature_c": 34
    },
    {
      "date": "2026-10-25",
      "aqi_us": 157,
      "category": "Unhealthy",
      "low_temperature_c": 25,
      "high_temperature_c": 33
    }
  ],
  "main_pollutant": "PM2.5",
  "wind_speed_kmh": 10,
  "humidity_percent": 21,
  "health_recommendations": [
    "Avoid outdoor exercise",
    "Close your windows to avoid dirty outdoor air",
    "Wear a mask outdoors"
  ],
  "pm25_who_guideline_times": 18.1
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"iqair.com/get_air_quality","input":{"city":"Delhi","country":""}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the air quality like in Delhi right now?
- Current AQI and main pollutant for Lima, Peru
- Is it safe to go jogging outside in Beijing today? Check the pollution level
- Give me the PM2.5 reading and weather forecast for Springfield, United States on iqair.com
- Health advice and 5-day air quality outlook for Hanoi, Vietnam

## Input schema

```json
{
  "type": "object",
  "required": [
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "description": "City to look up, for example Delhi."
    },
    "country": {
      "type": "string",
      "default": "",
      "description": "Country to distinguish cities with the same name, for example India."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "city",
    "updated_at",
    "aqi_us",
    "daily_forecast",
    "health_recommendations",
    "iqair_url"
  ],
  "properties": {
    "city": {
      "type": "string"
    },
    "aqi_us": {
      "type": "integer"
    },
    "country": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "iqair_url": {
      "type": "string"
    },
    "pm25_ug_m3": {
      "type": "number"
    },
    "updated_at": {
      "type": "string"
    },
    "temperature_c": {
      "type": "number"
    },
    "daily_forecast": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string"
          },
          "aqi_us": {
            "type": "integer"
          },
          "category": {
            "type": "string"
          },
          "low_temperature_c": {
            "type": "number"
          },
          "high_temperature_c": {
            "type": "number"
          }
        }
      }
    },
    "main_pollutant": {
      "type": "string"
    },
    "wind_speed_kmh": {
      "type": "number"
    },
    "humidity_percent": {
      "type": "number"
    },
    "health_recommendations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "pm25_who_guideline_times": {
      "type": "number"
    }
  }
}
```

## See more

- [AirNow API: Get air quality](https://fous.com/methods/airnow.gov/get-air-quality.md): Gets AirNow current air quality, pollutant readings and today's and tomorrow's forecasts for a US city or ZIP code, or a covered Canadian or Mexican city.
- [AccuWeather API: Get current weather](https://fous.com/methods/accuweather.com/get-current-weather.md): Gets current conditions and RealFeel for a city or postal code on AccuWeather. The UV level follows standard UV-index ranges. Air quality is null unless it is shown with the current conditions.
- [The Weather Channel API: Get current weather](https://fous.com/methods/weather.com/get-current-weather.md): Gets current conditions and today's high and low from The Weather Channel for a city, postcode, ZIP code or street address worldwide. Street addresses are geocoded exactly first; some observations omit gusts or other measurements.
- [MSN API: Get current weather](https://fous.com/methods/msn.com/get-current-weather.md): Gets current MSN Weather conditions for a city, address or ZIP code. The place is found through OpenStreetMap Nominatim. Matches for broad searches are approximate.
- [NASA API: Get ISS sightings](https://fous.com/methods/nasa.gov/get-iss-sightings.md): Finds upcoming International Space Station sightings for a city in NASA's city list, with local start times, visibility and sky directions. Cities without scheduled passes return an empty list.
- [NWS API: Get current conditions](https://fous.com/methods/weather.gov/get-current-conditions.md): Gets the latest observed weather from a nearby National Weather Service station for a US city, address, or ZIP code. Measurements the station does not report are null.
- [FlightAware API: Get airport delays](https://fous.com/methods/flightaware.com/get-airport-delays.md): Checks today's delayed and cancelled departures and arrivals at an airport on FlightAware, with current weather and any reported FAA delay status. Delay averages and ground programs are returned only when FlightAware shows them; counts can be null when no statistics row is displayed.
- [Time and Date API: Get time in city](https://fous.com/methods/timeanddate.com/get-time-in-city.md): Gets the current local time, time zone, and next daylight saving change for a city listed on Time and Date. Add a state or country to distinguish cities with the same name.
