EN APIs

Change language: DE

Accessing the API data

We have some API endpoints to access the sensor data using GET requests and no credentials. The endpoints are covered here.

Domains

There are two domains where the same data is served.

• https://api.luftdaten.info - This is optimized for receiving data. DON'T use this to request data.
• https://data.sensor.community - This is faster and more reliable for serving data, so should be used for reporting cases. Where it is not supported for a certain endpoint, the previous domain must be used.

Update frequency

For performance reasons, data is not immediately available.

An endpoint covering data in the last minute is updated every minute. While an endpoint covering data for the last 24 hours is updated every 5 minutes.

Endpoints

V1

• https://data.sensor.community/static/v1/data.json - all measurements of the last 5 minutes for all sensors.

• https://data.sensor.community/airrohr/v1/filter/{query} - all measurements of the last 5 minutes filtered by query

  • type={sensor type} : comma-separated list of sensor types, e.g. SDS011,BME280
  • area={lat,lon,distance} : all sensors within a max radius e.g. 52.5200,13.4050,10 (Berlin)
  • box={lat1,lon1,lat2,lon2} : all sensors in a 'box' with the given coordinates e.g. 52.1,13.0,53.5,13.5
  • country={country code} : comma-separated list of country codes. Example BE,DE,NL

• https://data.sensor.community/airrohr/v1/sensor/{apiID}/ - all measurements of the last 5 minutes for one sensor.

V2

• https://data.sensor.community/static/v2/data.json - average of all measurements per sensor of the last 5 minutes for all sensors.
• https://data.sensor.community/static/v2/data.1h.json - average of all measurements per sensor of the last hour.
• https://data.sensor.community/static/v2/data.24h.json - average of all measurements per sensor of the 24 hours.
• https://api.luftdaten.info/static/v2/data.dust.min.json - same as data.json but dust sensors only .
• https://api.luftdaten.info/static/v2/data.temp.min.json - same as data.json but temp./humidity/air pressure sensors only.