Referência da API

Ranking das cidades de um país

As cidades de um país ordenadas pela média diária de PM2.5 do último dia completo, com as mais poluídas ou as mais limpas primeiro; apenas grandes cidades ou todas as localidades.

Ranking das cidades de um país

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

Parâmetros de consulta

country string obrigatório

Nome do país em qualquer um dos idiomas do site ou seu código ISO.

order string opcional

most_polluted ou cleanest primeiro.

Padrão: most_polluted

settlements string opcional

cities — só grandes cidades; all — toda localidade com sensores suficientes.

Padrão: cities

limit integer opcional

Quantas cidades, até 50.

Padrão: 10

lang string opcional

Idioma dos nomes de cidade e país e do link da página.

Padrão: 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()

200Resposta

{
  "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
    }
  ]
}