Air quality API

Stream New South Wales air quality and meteorology data using an API

This air quality API enables organisations and individuals to directly stream and integrate air quality and meteorological data into subsequent applications such as mobile apps, websites, decision support tools, third-party data systems, and many other facilities.

By delivering near-real-time data via this API, the Department is supporting policy, research and business decision-makers to improve and positively influence environmental and health considerations.

What can the air quality API give you?

The air quality API provides 3 datasets, which can be accessed and streamed as current real-time hourly data, or downloaded as historical data:

  • Observational data: access air quality and meteorological observational data collected from the NSW air quality monitoring network. Observational data are updated every hour.
  • Station details: download monitoring station details including the site name, longitude, latitude and region name.
  • Parameter descriptions: get details about the air pollutants and meteorological parameters we monitor, including averaging periods, exceedances and air quality indexes.

How do I use the air quality API?

API User Guide

Download the Air Quality API User Guide (PDF 1.8MB) to guide you on setting up data streaming into your application.The user guide also provides a data dictionary, and demonstrated examples on using Microsoft Excel Power Query and the programming languages R and Python, though you are not limited to using these.

API Excel Power Query

You may use MS Excel Power Query to download observational data, station details and parameter descriptions. The Air Quality API User Guide outlines the steps involved for this example Excel Power Query (XLSX 1326B).

API data user interface (swagger)

You may use a  user-friendly online environment on swagger, to download the data in JSON format and explore the data. Details are in the Air Quality API User Guide (PDF 1.8MB)

Additional information

Contact the team

Data licence

The air quality API is openly accessible and does not require registration or a subscription key. Users must note though that any data accessed and the Air Quality API User Guide (PDF 1.8MB) is owned by DPIE and is protected by Crown Copyright, unless credited otherwise. These are licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0), subject to the exemptions contained in the licence. The legal code for the licence is available at Creative Commons.

See DPIE Copyright for more information.

Data disclaimer

Data provided for the recent days have undergone only preliminary quality assurance checks and may require modification during final stages of data validation. See details.

Other data portals