Akash Kumar Naik

Posted on Mar 15

🌫️ Air Quality Index API: Real-Time AQI

#ai #api #automation #showdev

🌫️ Air Quality Index API: Real-Time AQI Data + AI Health Recommendations

Air pollution affects 99% of the global population. Whether you're planning a morning jog, managing asthma, or building a health app — knowing the air quality before you step outside is critical.

That's why I built the Air Quality Index (AQI) API — a real-time API that delivers AQI data, pollution metrics, weather info, and AI-powered health recommendations for outdoor activities.

✨ What You Get

📊 Real-Time AQI & Pollution Metrics

AQI (Air Quality Index) - Overall air quality score
PM2.5 - Fine particulate matter (most harmful)
PM10 - Coarse particulate matter
CO - Carbon monoxide levels
Temperature, Humidity, Wind Speed - Weather context

🧠 AI-Powered Health Recommendations

Personalized guidance based on:

Your planned outdoor activity (running, cycling, walking)
Duration of exposure
Medical conditions (asthma, allergies, respiratory issues)

No API key required — Mistral credentials are managed by the actor.

🎯 Perfect For

Use Case	Application
Fitness Apps	Warn users before outdoor workouts
Travel Platforms	Route planning around pollution hotspots
Health Assistants	Daily air quality briefings for sensitive users
Smart Cities	Environmental dashboards & alerts
Wearables	Real-time AQI notifications

🚀 How to Use It

Option 1: Apify Console (No-Code)

Visit AQI API on Apify
Enter your city (e.g., "Delhi", "Los Angeles", "Beijing")
Specify planned activity (e.g., "morning jog for 45 minutes")
Add medical conditions if applicable (e.g., "asthma")
Click Start → Get results in seconds

Option 2: API Integration

curl -X POST \
  https://api.apify.com/v2/acts/akash9078~air-quality-index-aqi-api/runs \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_APIFY_TOKEN' \
  -d '{
    "city": "Delhi",
    "state": "Delhi",
    "country": "India",
    "plannedActivity": "morning walk",
    "medicalConditions": "asthma"
  }'

📊 Sample Output

{
  "success": true,
  "location": {
    "city": "Delhi",
    "state": "Delhi",
    "country": "India"
  },
  "aqi_data": {
    "aqi": 135,
    "temperature": 31.4,
    "humidity": 41.0,
    "wind_speed": 16.6,
    "pm25": 51.0,
    "pm10": 65.0,
    "co": 312.0
  },
  "recommendations": "AQI is 135 (Unhealthy for Sensitive Groups). For a 30-minute morning walk with asthma: wear an N95 mask, avoid busy roads, consider indoor exercise if symptoms appear.",
  "charges": [
    { "event": "aqi_data_fetch", "price": 0.005 },
    { "event": "health_recommendation", "price": 0.005 }
  ],
  "total_price": 0.01
}

💰 Transparent Pricing

Pay-per-event pricing:

Event	Price
AQI Data Fetch	$0.005
Health Recommendation	$0.005
Total per run	$0.01

That's 1 cent per query — affordable for apps of any scale.

🔧 Technical Details

Data Source: aqi.in with resilient scraping logic
AI Model: Mistral Large for health recommendations
Runtime: Python with fallback extraction methods
Output: Structured JSON with full charge transparency

🌍 Real-World Use Cases

The Fitness App Developer

"Integrated the AQI API into our running app. Now users get automatic air quality alerts before their outdoor workouts. Reduced user complaints about breathing issues by 60%."

The Travel Planner

"We use this to warn travelers about pollution in destinations like Delhi, Beijing, and Bangkok. Helps them pack masks and plan indoor alternatives."

The Asthma Management App

"Daily AQI checks with personalized recommendations are now a core feature. Users love the 'should I go outside today?' guidance."

⚠️ Important Notes

Not a medical diagnosis — provides informational guidance only
Always consult healthcare professionals for medical advice
Data sourced from third-party providers; occasional delays possible
Zero AQI values may indicate temporary source unavailability

🌱 Why Air Quality Matters

7 million premature deaths annually linked to air pollution (WHO)
PM2.5 particles can enter bloodstream and affect organs
Real-time awareness helps vulnerable populations stay safe
AI recommendations bridge data → actionable health guidance

🔗 Try It Now

Protect your users, yourself, and your community with real-time air quality intelligence.

Try AQI API for Free

Built with ❤️ by @akash9078 on the Apify platform.

What's your city's AQI today? Let me know in the comments! 👇

DEV Community