Разработчикам

Справочник API

Текущие показания

Последнее показание каждого датчика одним запросом, обновляется раз в минуту

Текущие показания всех датчиков

GEThttps://api.atmy.ai/v1/sensors/current

60 запросов в минуту с одного IP-адреса, без ключа. В каждом ответе есть X-RateLimit-Remaining. /v1/sensors/current пересобирается раз в минуту: при более частых запросах данные те же.

Параметры запроса

network string необязательный

sensor_community, airgradient или atmy

quality string необязательный

All или passed

По умолчанию: all

min_rating number необязательный

Только датчики с рейтингом не ниже заданного, от 0 до 10

bbox string необязательный

min_lon,min_lat,max_lon,max_lat

GET/sensors/current?quality=passed&min_rating=8
curl "https://api.atmy.ai/v1/sensors/current?quality=passed&min_rating=8"
200Ответ
{
  "api_version": "2.0",
  "generated_at": "2026-10-27T11:11:32+00:00",
  "count": 1644,
  "sensors": [
    {
      "id": 40656,
      "network_id": "airgradient",
      "lat": 19.094645,
      "lon": 101.529558,
      "city": null,
      "time": "2026-10-27T11:03:32+00:00",
      "pm1": 2.8,
      "pm25": 6.4,
      "pm10": 7.3,
      "temperature_c": 31,
      "humidity_percent": 48,
      "tvoc": 110.1,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    },
    {
      "id": 40657,
      "network_id": "airgradient",
      "lat": -34.0467846944686,
      "lon": 151.1229561199615,
      "city": "australia/sydney",
      "time": "2026-10-27T11:02:53+00:00",
      "pm25": 1,
      "temperature_c": 22.6,
      "humidity_percent": 63,
      "tvoc": 293.3,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    }
  ],
  "attribution": "Sensor data: Atmy (atmy.ai), from the networks named in each sensor's \"network\", under that network's license.",
  "terms": "https://atmy.ai/legal/data/"
}

Текущие показания одной сети

GEThttps://api.atmy.ai/v1/networks/{network}/sensors/current

Тот же ответ только для одной сети.

Параметры пути

network string обязательный

sensor_community, airgradient или atmy.

Параметры запроса

quality string необязательный

All или passed

По умолчанию: all

min_rating number необязательный

Только датчики с рейтингом не ниже заданного, от 0 до 10

bbox string необязательный

min_lon,min_lat,max_lon,max_lat

GET/networks/airgradient/sensors/current?quality=passed
curl "https://api.atmy.ai/v1/networks/airgradient/sensors/current?quality=passed"
200Ответ
{
  "api_version": "2.0",
  "generated_at": "2026-10-27T11:11:32+00:00",
  "count": 1644,
  "sensors": [
    {
      "id": 40656,
      "network_id": "airgradient",
      "lat": 19.094645,
      "lon": 101.529558,
      "city": null,
      "time": "2026-10-27T11:03:32+00:00",
      "pm1": 2.8,
      "pm25": 6.4,
      "pm10": 7.3,
      "temperature_c": 31,
      "humidity_percent": 48,
      "tvoc": 110.1,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    },
    {
      "id": 40657,
      "network_id": "airgradient",
      "lat": -34.0467846944686,
      "lon": 151.1229561199615,
      "city": "australia/sydney",
      "time": "2026-10-27T11:02:53+00:00",
      "pm25": 1,
      "temperature_c": 22.6,
      "humidity_percent": 63,
      "tvoc": 293.3,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    }
  ],
  "attribution": "Sensor data: Atmy (atmy.ai), from the networks named in each sensor's \"network\", under that network's license.",
  "terms": "https://atmy.ai/legal/data/"
}