IQAir Scraper

Extract worldwide air quality rankings, city pollution comparisons, PM2.5 measurements, and health recommendations from IQAir. Built on spider-browser .

Get started Docs

target
iqair.com: success rate
99.9%: latency
~4ms

POST /fetch/iqair.com/

return_format

curl -X POST https://api.spider.cloud/fetch/iqair.com/ \
  -H "Authorization: Bearer $SPIDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"return_format": "json"}'

200 OK · cache hit · response shape

{
  "url": "https://iqair.com/",
  "status": 200,
  "data": {
    "city_name": "string",
    "aqi_value": "string",
    "pm2_5": "string",
    "temperature": "string",
    "humidity": "string",
    "wind": "string",
    "health_advice": "string",
    "rank": "string"
  }
}

# IQAir Scraper

**City name**: string
**AQI value**: string
**PM2.5**: string
**Temperature**: string
**Humidity**: string
**Wind**: string
**Health advice**: string
**Rank**: string

Quick start

Extract data in minutes.

Structured JSON from iqair.com with a single POST. AI-resolved selectors, cached on the first call.

iqair-scraper.ts

import { SpiderBrowser } from "spider-browser";

const spider = new SpiderBrowser({
  apiKey: process.env.SPIDER_API_KEY!,
});

await spider.connect();
const page = spider.page!;
await page.goto("https://www.iqair.com/world-most-polluted-cities");
await page.content();

const data = await page.evaluate(`(() => {
  const cities = [];
  document.querySelectorAll("table tbody tr, .city-row").forEach(el => {
    const rank = el.querySelector("td:nth-child(1), .rank")?.textContent?.trim();
    const city = el.querySelector("td:nth-child(2) a, .city-name")?.textContent?.trim();
    const aqi = el.querySelector("td:nth-child(3), .aqi-value")?.textContent?.trim();
    const country = el.querySelector("td:nth-child(4), .country-name")?.textContent?.trim();
    if (city) cities.push({ rank, city, aqi, country });
  });
  return JSON.stringify({ total: cities.length, cities: cities.slice(0, 20) });
})()`);

console.log(JSON.parse(data));
await spider.close();

curl -X POST https://api.spider.cloud/fetch/iqair.com/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"return_format": "json"}'

import requests

resp = requests.post(
    "https://api.spider.cloud/fetch/iqair.com/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"return_format": "json"},
)
print(resp.json())

const resp = await fetch("https://api.spider.cloud/fetch/iqair.com/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ return_format: "json" }),
});
const data = await resp.json();
console.log(data);