Quickstart

Fetch satellite wildfire data from our low-latency API.

1. Get a token

Create an API client under Settings → API clients at app.deepfire.co. See Authentication for the details.

export TOKEN=$(curl -s -X POST "https://api.deepfire.co/v1/token" \
  -H "Content-Type: application/json" \
  -d "{\"client_id\": \"$DEEPFIRE_CLIENT_ID\", \"client_secret\": \"$DEEPFIRE_CLIENT_SECRET\"}" \
  | jq -r .access_token)

2. Explore the service

# Landing page — links to conformance, collections, and the OpenAPI definition
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1?f=application/json"

# What can this server do? (conformance classes)
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/conformance?f=application/json"

# List collections
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections?f=application/json"

3. First features

# The first 10 hotspots as GeoJSON (`+` must be percent-encoded as %2B in a bare URL)
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:hotspots/items?f=application/geo%2Bjson&limit=10"

4. Active hotspots in a bounding box

Combine a spatial filter (bbox, WGS84 lon/lat) with an attribute filter (CQL2). Example: currently-active detections over California.

curl -sG -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:hotspots/items" \
  --data-urlencode "bbox=-125,32,-114,42" \
  --data-urlencode "filter-lang=cql2-text" \
  --data-urlencode "filter=active = true" \
  --data-urlencode "limit=1000" \
  --data-urlencode "f=application/geo+json"

5. One feature by ID

Feature IDs look like hotspots.<uuid> and come from items responses:

id=$(curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:hotspots/items?f=application/geo%2Bjson&limit=1" \
  | jq -r '.features[0].id')

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:hotspots/items/$id?f=application/geo%2Bjson"