Detection APIs
Disappeared building detection
Detect buildings that have disappeared between two periods of Sentinel-1 imagery — useful for post-disaster damage estimation.
POST /api/v1/detect/disappearbuilding
Detect buildings that were present in an earlier scene but missing in a later scene. Designed for post-disaster damage assessment (earthquake, flood, fire, etc.). 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/disappearbuilding \
-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": "2024-12-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 | Pre-event period start. |
date_end | string (YYYY-MM-DD) | Yes | Post-event 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. The model ensemble compares the pair and emits polygons of disappeared structures.
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) |