Detection APIs
New building detection
Detect newly-constructed buildings by comparing two periods of Sentinel-1 imagery.
POST /api/v1/detect/newbuilding
Detect buildings that were newly constructed between two time ranges. Requires two scenes (before/after), so only the polygon + date-range input pattern is supported.
| Supported satellite | Sentinel-1 (GRD) |
| Typical runtime | Depends on AOI size |
| Input pattern | polygon + date_start + date_end only |
| Polygon area limit | 30,000 km² |
Request
curl -X POST https://api.spcsft.com/api/v1/detect/newbuilding \
-H "Authorization: Bearer sk_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"satellite_id": "sentinel-1",
"polygon": "POLYGON((139.7 35.6, 139.8 35.6, 139.8 35.7, 139.7 35.7, 139.7 35.6))",
"date_start": "2024-01-01",
"date_end": "2026-03-01"
}'Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
satellite_id | string | Yes | Must be "sentinel-1". |
polygon | string (WKT) | Yes | AOI polygon in EPSG:4326. |
date_start | string (YYYY-MM-DD) | Yes | Earlier period start. |
date_end | string (YYYY-MM-DD) | Yes | Later period end. |
orbit_direction | "ascending" | "descending" | No | Filter scenes by orbit. |
SateAIs picks one scene from the earlier period and one from the later period, both using the same path/frame for comparability.
Constraints
| Constraint | Value |
|---|---|
| Polygon area | ≤ 30,000 km² — exceeding returns 400 VALIDATION_ERROR before credits are consumed |
| Input pattern | Only polygon + date_start + date_end (scene IDs are not accepted) |