API de qualidade do ar da Atmy

Uma pequena API pública para assistentes de IA, agentes e desenvolvedores. Ela responde com a mesma agregação e verificação de qualidade das páginas de cidades e do Data Hub: sem chave, somente leitura, JSON.

Qualidade do ar agora

O valor atual (média da última leitura de cada sensor, com no máximo 60 minutos, recalculada a cada 15 minutos) e o último dia completo como no Data Hub, com o nível US EPA, as redes de sensores e o link para a página da cidade. A cidade é encontrada pelo nome em qualquer um dos 17 idiomas, por slug ou id, ou por coordenadas — a cidade mais próxima com resumo num raio de 50 km. Adicione country= quando duas cidades tiverem o mesmo nome.

Consulta

GET https://api.atmy.ai/v1/air-quality/current?city=Krasnoyarsk&lang=pt-BR
GET https://api.atmy.ai/v1/air-quality/current?lat=56.01&lon=92.87

Resposta (resumida)

{
  "city": {
    "id": 50003,
    "slug": "russia/krasnoyarsk",
    "name": "Krasnoyarsk",
    "country": "Russia",
    "timezone": "Asia/Krasnoyarsk",
    "page": "https://atmy.ai/air-quality/russia/krasnoyarsk/"
  },
  "now": {
    "status": "current",
    "pm25": 10.5,
    "unit": "ug/m3",
    "category": {
      "scale": "US_EPA_2024",
      "level": "moderate"
    },
    "sensors": 22,
    "updated_at": "2026-10-22T14:00:01Z"
  },
  "completed_day": {
    "date": "2026-10-21",
    "pm25": 13.8,
    "sensors": 21,
    "category": {
      "scale": "US_EPA_2024",
      "level": "moderate"
    }
  },
  "attribution": "Atmy (atmy.ai), aggregated public and citizen sensor networks; approximate values, not official monitoring."
}

Histórico diário

As médias diárias do Data Hub de até 400 dias completos (UTC); falta um dia com poucos sensores.

Consulta

GET https://api.atmy.ai/v1/air-quality/history?city=russia/krasnoyarsk&days=30

Cidades

As cidades com resumo da Atmy, suas páginas e a consulta de cada uma; com filtro por país.

Consulta

GET https://api.atmy.ai/v1/cities?country=serbia&lang=pt-BR

Condições

Somente leitura, sem chave, 60 consultas por minuto por IP. Os valores são aproximados (sensores de baixo custo, não monitoramento oficial); cite a fonte “Atmy (atmy.ai)”. Condições dos dados: atmy.ai/legal/data/.

OpenAPI 3.1 — a descrição legível por máquina usada por agentes e geradores de código. · llms.txt

Metodologia e fontes de dados · Ranking de cidades · API · Termos de uso dos dados