# Sensor Community Air Quality API

> Live readings from Sensor.Community citizen air sensors: PM2.5, PM10, temperature and humidity

- Vendor: `sensorcommunityairqualityapi` · version 1.0 · category Science · tags air quality api, pm2.5 api, pollution api, citizen science api, particulate matter api, sensor data api, luftdaten api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/sensorcommunityairqualityapi
- This document: https://apiclay.com/docs/sensorcommunityairqualityapi.md
- OpenAPI 3.1: https://apiclay.com/api/sensorcommunityairqualityapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `sensorcommunityairqualityapi`
- Updated: 2026-11-18

## About

## Sensor Community Air Quality API

The latest measurements from the Sensor.Community (formerly luftdaten.info) network of tens of thousands of citizen-run sensors: particulate matter (PM10, PM2.5), temperature, humidity and pressure, with each sensor's location, filtered by an area around a point or by country.

Data comes from **sensor.community** (https://sensor.community). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/area?area=52.52,13.40,2` (lat,lon,radius km) or `/country?country=LU`.

### Routes

#### GET `/area` - Sensors in an area
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| area | path | string | yes | `lat,lon,radius_km`, e.g. `52.52,13.40,2`. |

Returns: array of readings with `timestamp`, `location` (`latitude`, `longitude`, `country`, `indoor`), `sensor.sensor_type.name`, `sensordatavalues[]` (`value_type` `P1`=PM10, `P2`=PM2.5, `temperature`, `humidity`, `value`).

#### GET `/country` - Sensors in a country
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| country | path | string | yes | ISO code, e.g. `LU`, `DE`. Large countries can pass the response size cap. |

Returns: same shape as `/area`.

### Caveats

- Readings are the last 5 minutes from volunteer sensors and are not calibrated reference measurements. Data is open (ODbL).
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by sensor.community.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /area — Sensors in an area
- Gateway: `GET https://api.apiclay.com/v1/api/sensorcommunityairqualityapi/area`
- Public query params: `area` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /country — Sensors in a country
- Gateway: `GET https://api.apiclay.com/v1/api/sensorcommunityairqualityapi/country`
- Public query params: `country` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/sensorcommunityairqualityapi/area?area=<area>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
