Référence de l’API

Classement des villes d’un pays

Les villes d’un pays classées selon la moyenne journalière de PM2.5 du dernier jour complet, les plus polluées ou les plus propres d’abord ; grandes villes uniquement ou toutes les localités.

Classement des villes d’un pays

GEThttps://api.atmy.ai/v1/ranking

Paramètres de requête

country string obligatoire

Nom du pays dans l’une des langues du site, ou son code ISO.

order string facultatif

most_polluted ou cleanest d’abord.

Par défaut: most_polluted

settlements string facultatif

cities — grandes villes seulement ; all — toute localité ayant assez de capteurs.

Par défaut: cities

limit integer facultatif

Nombre de villes, jusqu’à 50.

Par défaut: 10

lang string facultatif

Langue des noms de ville et de pays et du lien vers la page.

Par défaut: en

GET/ranking?country=Germany&limit=10

curl "https://api.atmy.ai/v1/ranking?country=Germany&limit=10"

const response = await fetch("https://api.atmy.ai/v1/ranking?country=Germany&limit=10");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/ranking?country=Germany&limit=10").json()

200Réponse

{
  "country": "Germany",
  "date": "2026-10-26",
  "period": "2026-10-26T00:00:00Z/2026-10-27T00:00:00Z",
  "order": "most_polluted",
  "settlements": "cities",
  "unit": "ug/m3",
  "method": "datahub_daily",
  "category_scale": "US_EPA_2024",
  "count": 76,
  "cities": [
    {
      "rank": 1,
      "id": 52005,
      "name": "Flensburg",
      "pm25": 39.2,
      "level": "unhealthy_for_sensitive_groups",
      "sensors": 10
    },
    {
      "rank": 2,
      "id": 52151,
      "name": "Würzburg",
      "pm25": 22.2,
      "level": "moderate",
      "sensors": 5
    }
  ]
}