API Store

API Description


Air Quality

Ambee Air Quality API helps you to get real-time hyper local air quality data for over a million postal codes across 90+ countries, cities, and latitude & longitude. Air quality data helps quantify ambient air pollution.


It provides actionable insights on air quality index, particulate matter, nitrogen oxides, sulphur dioxide, carbon monoxide, ammonia and ozone. Air quality affects the planetary well-being, aggravates existing health conditions and leads to a myriad of health issues.


Headers

Content-typeapplication/json
x-api-keyUnique key obtained after sigunp


RESPONSE PARAMETERS

PM2.5Particulate matter < 2.5um (ug/m3)
PM10Particulate matter < 10um (ug/m3)
SO2Sulphur dioxide conc (ppb)
NO2Nitrogen dioxide conc (ppb)
OZONEOZONE conc (ppb)
COCarbon monoxide conc (ppm)
AQIAir quality index
updatedAtISO timestamp of event in UTC
aqiInfoBreif info about the effects of the AQI returned


Air quality current- Geospatial search

GET

Ambee Air Quality API helps you to get real-time, hyper local air quality data for any location by passing the geographic coordinates.


The API also provides location information about the latitude, longitude passed like countryCode, division, postalCode, placename, state, city, etc.


Endpoint

/latest/by-lat-lng


PARAMETERS

latLatitude of the place to search
lngLongitude of the place to search


Sample response

{
    "message": "success",
    "stations": [
        {
            "CO": 1.453,
            "NO2": 25.291,
            "OZONE": 8.032,
            "PM10": 52.24,
            "PM25": 21.943,
            "SO2": 1.898,
            "city": "Bangalore",
            "countryCode": "IN",
            "division": "Bangalore",
            "lat": 11.98625,
            "lng": 77.550478,
            "placeName": "Race course road",
            "postalCode": "560020",
            "state": "Karnataka",
            "updatedAt": "2021-05-29T13:00:00.000Z",
            "AQI": 72,
            "aqiInfo": {
                "pollutant": "PM2.5",
                "concentration": 21.943,
                "category": "Moderate"
            }
        }
    ]
}


Air quality current- Postalcode search

GET

Ambee Air Quality API helps you to get real-time, hyper local air quality data for any location by passing the postalcode of the respective area.


The API also provides location information about the latitude, longitude passed like countryCode, division, postalCode, placename, state, city, etc.


Endpoint

/latest/by-postal-code

PARAMETERS

postalCodePostalcode of the place to search
countryCodeISO country code of the postalcode entered

Sample response

{
    "message": "success",
    "stations": [
        {
            "CO": 1.453,
            "NO2": 25.291,
            "OZONE": 8.032,
            "PM10": 52.24,
            "PM25": 21.943,
            "SO2": 1.898,
            "city": "Bangalore",
            "countryCode": "IN",
            "division": "Bangalore",
            "lat": 11.98625,
            "lng": 77.550478,
            "placeName": "Race course road",
            "postalCode": "560020",
            "state": "Karnataka",
            "updatedAt": "2021-05-29T13:00:00.000Z",
            "AQI": 72,
            "aqiInfo": {
                "pollutant": "PM2.5",
                "concentration": 21.943,
                "category": "Moderate"
            }
        }
    ]
}

Air quality current- Citywise search

GET

Ambee Air Quality API helps you to get real-time, hyper local air quality data for any city by passing the name of the city.


The API also provides location information about the latitude, longitude passed like countryCode, division, postalCode, placename, state, city, etc.


Endpoint

/latest/by-city

PARAMETERS

cityName of the city to search
limit (optional)Specifies the number of records to be returned


Sample response

{
    "message": "success",
    "stations": [
        {
            "CO": 1.453,
            "NO2": 25.291,
            "OZONE": 8.032,
            "PM10": 52.24,
            "PM25": 21.943,
            "SO2": 1.898,
            "city": "Bangalore",
            "countryCode": "IN",
            "division": "Bangalore",
            "lat": 11.98625,
            "lng": 77.550478,
            "placeName": "Race course road",
            "postalCode": "560020",
            "state": "Karnataka",
            "updatedAt": "2021-05-29T13:00:00.000Z",
            "AQI": 72,
            "aqiInfo": {
                "pollutant": "PM2.5",
                "concentration": 21.943,
                "category": "Moderate"
            }
        }
    ]
}


Air quality current- Countrywise search

GET

Ambee Air Quality API helps you to get real-time, hyper local air quality data for any country by passing the ISO country code.


The API also provides location information about the latitude, longitude passed like countryCode, division, postalCode, placename, state, city, etc.

Endpoint

/latest/by-country-code


PARAMETERS

countryCodeISO country code of the country to search
limit (optional)Specifies the number of records to be returned


Sample response

{
    "message": "success",
    "stations": [
        {
            "CO": 1.453,
            "NO2": 25.291,
            "OZONE": 8.032,
            "PM10": 52.24,
            "PM25": 21.943,
            "SO2": 1.898,
            "city": "Bangalore",
            "countryCode": "IN",
            "division": "Bangalore",
            "lat": 11.98625,
            "lng": 77.550478,
            "placeName": "Race course road",
            "postalCode": "560020",
            "state": "Karnataka",
            "updatedAt": "2021-05-29T13:00:00.000Z",
            "AQI": 72,
            "aqiInfo": {
                "pollutant": "PM2.5",
                "concentration": 21.943,
                "category": "Moderate"
            }
        }
    ]
}