# IQAir Live City Ranking API

> Real-time global city air quality rankings sorted by AQI descending. Returns up to 122 major cities with current AQI values, geographic metadata, and follower counts.

Source: https://www.sandbase.ai/model/iqair/live-city-ranking
API reference: https://www.sandbase.ai/model/iqair/live-city-ranking/docs

## Facts

- Provider: IQAir
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/iqair/live-city-ranking`
- Price: $0.01 per call
- Free allowance: 100 calls per organization per UTC day, shared across eligible APIs
- Capabilities: api, iqair, web scraping
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/iqair/live-city-ranking` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

## FAQ

### How do I use the IQAir Live City Ranking API?

Send a POST request to https://api.sandbase.ai/v1/api/iqair/live-city-ranking with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the IQAir Live City Ranking API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

### What parameters does the IQAir Live City Ranking API accept?

IQAir Live City Ranking takes no input parameters; send an empty JSON body.

### What does the IQAir Live City Ranking API return?

A JSON result. This endpoint runs asynchronously, so the response tells you how to fetch the finished result.

### Do I need a IQAir developer account or API key?

No. IQAir Live City Ranking runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for IQAir API access separately.

## README

### IQAir Live City Ranking

Real-time global city air quality rankings sorted by AQI descending. Returns up to 122 major cities with current AQI values, geographic metadata, and follower counts.