Справочник API
Рейтинг городов страны
Города страны по среднесуточному PM2.5 за последние завершённые сутки: сначала самые загрязнённые или самые чистые; только крупные города или все населённые пункты.
Рейтинг городов страны
GEThttps://api.atmy.ai/v1/ranking
Параметры запроса
country string обязательный
Название страны на любом из языков сайта или её ISO-код.
order string необязательный
most_polluted или cleanest — сначала самые грязные или самые чистые.
По умолчанию: most_polluted
settlements string необязательный
cities — только крупные города; all — все населённые пункты с достаточным числом датчиков.
По умолчанию: cities
limit integer необязательный
Сколько городов, до 50.
По умолчанию: 10
lang string необязательный
Язык названий города и страны и ссылки на страницу.
По умолчанию: 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()200Ответ
{
"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
}
]
}