BreezoMeter API

Real-time, history and forecast air quality data
alongside our heat maps, widget and pollen data.

Register for an API key and start exploring our data.

Sign up Login

BreezoMeter API V1

This document is intended for website and mobile developers who want to use air quality data provided by one of the BreezoMeter APIs

A proper BreezoMeter API request must be of the following form:

https://api.breezometer.com/baqi/?parameters

To access the BreezoMeter API over HTTP, use:

http://api.breezometer.com/baqi/?parameters

While making an API request some parameters are required while some are optional. As is standard in URLs, parameters are separated using the ampersand (&) character.


Ready to discuss your project?

Get in touch with our team


Real Time Air Quality API Requests

Get BreezoMeter Air Quality Index by Latitude and Longitude (Geocoding) You can get air quality data by Latitude and Longitude (Geocoding), simply by concatenating the following API request:
https://api.breezometer.com/baqi/?lat={latitude}&lon={longitude}&key=YOUR_API_KEY

Required parameters:

  • lat – Latitude is a geographic coordinate that specifies the north-south position of a point on the Earth’s surface. Range between -90 to 90 (WGS84 standard)
  • lon – Longitude is a geographic coordinate that specifies the east-west position of a point on the Earth’s surface. Range between -180 to 180 (WGS84 standard)
  • key – Your BreezoMeter API key. This key identifies your account for purposes of quota management and features access.

Optional:

  • lang – Response language. We support English(“en”) and Hebrew(“he”).

Responses:

The responses are returned in JSON format. In this example, the BreezoMeter Air Quality Index by Latitude and Longitude response for the query on “Latitude=40.7324296, Longitude=-73.9977264”. This request demonstrates:
https://api.breezometer.com/baqi/?lat=40.7324296&lon=-73.9977264&key=YOUR_API_KEY


{
    "datetime": "2016-06-21T11:36:00",
    "country_name": "United States",
    "breezometer_aqi": 68,
    "breezometer_color": "#90D32D",
    "breezometer_description": "Fair Air Quality",
    "country_aqi": 39,
    "country_aqi_prefix": "",
    "country_color": "#00E400",
    "country_description": "Good air quality",
    "data_valid": true,
    "key_valid": true,
    "random_recommendations": {
        "children": "Have fun with the kids outside, but stay alert for our notifications",
        "sport": "You can exercise outdoors - but make sure to stay alert to our notifications",
        "health": "There is no real danger for people with health sensitivities. Just keep an eye out for changes in air quality for the next few hours",
        "inside": "The amount of pollutants in the air is noticeable, but still there is no danger to your health - It is recommended to continue monitoring changes in the coming hours",
        "outside": "It's still OK to go out and enjoy a stroll, just pay attention for changes in air quality"
    },
    "dominant_pollutant_canonical_name": "pm2.5",
    "dominant_pollutant_description": "Fine particulate matter (<2.5µm)",
    "dominant_pollutant_text": {
        "main": "The dominant pollutant is fine particulate matter (PM2.5).",
        "effects": "Particles enter the lungs and cause local and systemic inflammation in the respiratory system & heart, thus cause cardiovascular and respiratory diseases such as asthma and bronchitis.",
        "causes": "Main sources are fuel burning processes in industry, transportation and indoor heating."
    },
    "pollutants": {
        "co": {
            "pollutant_description": "Carbon monoxide",
            "units": "ppb",
            "concentration": 101.24
        },
        "no2": {
            "pollutant_description": "Nitrogen dioxide",
            "units": "ppb",
            "concentration": 9.49
        },
        "o3": {
            "pollutant_description": "Ozone",
            "units": "ppb",
            "concentration": 31.4
        },
        "pm10": {
            "pollutant_description": "Inhalable particulate matter (<10µm)",
            "units": "ug/m3",
            "concentration": 3
        },
        "pm25": {
            "pollutant_description": "Fine particulate matter (<2.5µm)",
            "units": "ug/m3",
            "concentration": 5.22
        },
        "so2": {
            "pollutant_description": "Sulfur dioxide",
            "units": "ppb",
            "concentration": null
        }
    }
}
{{vm.mobileConsoleOutput}}
{{vm.baseUrl}}?lat={{vm.form.lat}}&lon={{vm.form.lon}}&key={{vm.form.key}}

Customize Your API Request

You can customize your API request to get only the specific data you want in the response. Concatenate the API request with the fields you wish to get in the response.
The responses are returned in JSON format.

In this example, the BreezoMeter Air Quality Index for “5th Avenue, New York, NY, United States” with the coordinates lat=40.7324296 and lon=-73.9977264  query on with customization to get only the BreezoMeter AQI and Recommendations fields.

This request demonstrates:

https://api.breezometer.com/baqi/?lat=40.7324296&lon=-73.9977264&fields=breezometer_aqi,random_recommendations&key=YOUR_API_KEY

The response:

{
    "random_recommendations": {
        "children": "Let the children enjoy the fresh outdoor air - You should play with them too!",
        "sport": "This is an excellent opportunity to enjoy your favorite outdoor activity without any worries",
        "health": "This air quality is excellent for people with respiratory sensitivities",
        "inside": "Let the air outside freshen up your home",
        "outside": "Hooray! The air quality outside is awesome!"
    },
    "breezometer_aqi": 80
}

Try a real time call

{{vm.baseUrl}}?lat={{vm.form.lat}}&lon={{vm.form.lon}}&key={{vm.form.key}}&fields={{field}}{{$last ? '' : ','}}