{
  "name": "JanVayu Open Data API",
  "version": "v1",
  "description": "Read-only, CORS-open access to the air-quality data JanVayu publishes. Free to use with attribution.",
  "license": "Data content: CC BY-NC-SA 4.0 · Code: MIT",
  "citation": "JanVayu (janvayu.in), 2026-07-24. Data sources: CPCB, CREA, IQAir, WAQI, OpenAQ.",
  "docs": "https://www.janvayu.in/docs/#/api/",
  "updated": "2026-07-24T01:08:41.683Z",
  "datasets": [
    {
      "id": "rankings",
      "title": "City AQI rankings (worst-first), live or averaged",
      "url": "https://www.janvayu.in/.netlify/functions/rankings?range=live",
      "params": {
        "range": "live | 7d | 30d"
      },
      "formats": [
        "json",
        "csv"
      ],
      "csv": "https://www.janvayu.in/api?dataset=rankings&format=csv&range=live"
    },
    {
      "id": "reference",
      "title": "Reference datasets: CPCB stations, NCAP cities, IQAir annual",
      "url": "https://www.janvayu.in/.netlify/functions/reference-data",
      "params": {
        "dataset": "cpcb_stations | ncap_cities | iqair_annual"
      },
      "formats": [
        "json"
      ]
    },
    {
      "id": "historical",
      "title": "Year-over-year monthly PM2.5 (climatology + snapshots)",
      "url": "https://www.janvayu.in/.netlify/functions/historical-aqi?city=delhi",
      "params": {
        "city": "city key (e.g. delhi)",
        "month": "1-12"
      },
      "formats": [
        "json"
      ]
    },
    {
      "id": "community-sensors",
      "title": "Hyperlocal sensors near a point (OpenAQ / Sensor.Community)",
      "url": "https://www.janvayu.in/.netlify/functions/community-sensors?lat=28.61&lon=77.21&radius=25",
      "params": {
        "lat": "latitude",
        "lon": "longitude",
        "radius": "km (max 50)"
      },
      "formats": [
        "json"
      ]
    },
    {
      "id": "status",
      "title": "90-day platform + endpoint uptime history",
      "url": "https://www.janvayu.in/.netlify/functions/status-history",
      "params": {},
      "formats": [
        "json"
      ]
    }
  ],
  "notes": "Rankings and community-sensor data are cached snapshots (see Cache-Control). Low-cost sensor readings are ±20-50% vs regulatory-grade. Forecast data is served client-side from the free Open-Meteo (CAMS) API, not this endpoint."
}