Airfree
Back to Developers

APIs

Earth Observation API

1 min read

Stream and analyse satellite imagery, analysis-ready data, and change-detection results programmatically over a STAC-catalogued archive.

The Earth Observation API provides programmatic access to the platform’s satellite imagery archive and derived products. Imagery is catalogued as SpatioTemporal Asset Catalog (STAC) items, so it is discoverable, filterable, and directly consumable by standard tools.

Search the catalogue

Use STAC search to find scenes by area, time window, and cloud cover. Results link to the underlying cloud-optimised GeoTIFF assets.

curl -X POST https://airfree.au/api/v1/eo/search \
  -H "Authorization: Bearer $AIRFREE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bbox": [138.4, -35.1, 138.8, -34.7],
    "datetime": "2026-01-01/2026-06-30",
    "query": { "eo:cloud_cover": { "lt": 10 } }
  }'

Analysis-ready data

Scenes are delivered as analysis-ready data: radiometrically and atmospherically corrected, tiled as cloud-optimised GeoTIFFs, so clients can stream only the pixels they need over HTTP range requests.

  • Sentinel-2 and Landsat analysis-ready surface reflectance.
  • Cloud-optimised GeoTIFF assets for partial reads.
  • STAC 1.0 metadata for reproducible, tool-agnostic access.

Derived products

Beyond raw imagery, the API serves derived layers — spectral indices and automated change-detection results between acquisitions — that power the change alerts surfaced in Airfree Maps.

Third-party imagery keys are not required. All imagery and derived products are served from the platform’s own archive through the edge.