Referencia de la API
Ranking de ciudades de un país
Las ciudades de un país ordenadas por el promedio diario de PM2.5 del último día completo, primero las más contaminadas o las más limpias; solo grandes ciudades o todas las localidades.
Ranking de ciudades de un país
GEThttps://api.atmy.ai/v1/ranking
Parámetros de consulta
country string obligatorio
Nombre del país en cualquiera de los idiomas del sitio o su código ISO.
order string opcional
most_polluted o cleanest primero.
Por defecto: most_polluted
settlements string opcional
cities — solo grandes ciudades; all — toda localidad con suficientes sensores.
Por defecto: cities
limit integer opcional
Cuántas ciudades, hasta 50.
Por defecto: 10
lang string opcional
Idioma de los nombres de ciudad y país y del enlace a la página.
Por defecto: 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()200Respuesta
{
"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
}
]
}