STAC Find¶
Six small find/scan primitives over the EDITO STAC API
(https://api.dive.edito.eu/data). Each is one authenticated call (catalog
finding walks the catalog tree and so makes one call per catalog visited);
results are returned close to upstream, wrapped in EPT response models. All
require Authorization: Bearer <access_token>.
These are EPT's own find primitives, deliberately not named "search": STAC
API reserves GET|POST /search for conformant Item Search, and these scans
are not conformant to it. Item finding does use the official
GET /search endpoint under the hood.
Endpoints¶
| Endpoint | Scans | Free-text filter |
|---|---|---|
GET /v1/stac/items |
STAC Item Search (GET /search) with bbox, datetime, collections, ids, limit |
q narrows on item id/title/description |
GET /v1/stac/items/scientific |
Item Search filtered/fallback-scanned for STAC Scientific metadata (sci:doi, sci:citation) |
doi and/or citation (at least one required), collections, limit (default 100) |
GET /v1/stac/collections |
GET /collections, following next pages |
q over id/title/description/keywords |
GET /v1/stac/catalogs |
The catalog tree from the projects root (/catalogs/projects), following rel="child" links recursively (breadth-first with concurrent level fetches, href-deduplicated, depth-capped) |
q over link title/href |
GET /v1/stac/items/assets |
Item find; returns a FeatureCollection of items with a matching asset key/href/title, each item keeping only its matched assets | q (required) |
GET /v1/stac/items/properties |
Item find; keeps items whose properties match every match pair, e.g. match=platform=Sentinel-1,processing-level=L2A |
match (required, case-insensitive values) |
Examples¶
curl -H "Authorization: Bearer ${ACCESS_TOKEN}" \
"${EPT_API_URL}/v1/stac/items?bbox=2.5,51,4,53&datetime=2024-01-01T00:00:00Z/2024-12-31T23:59:59Z&limit=10"
curl -H "Authorization: Bearer ${ACCESS_TOKEN}" \
"${EPT_API_URL}/v1/stac/collections?q=bathymetry"
curl -H "Authorization: Bearer ${ACCESS_TOKEN}" \
"${EPT_API_URL}/v1/stac/items/assets?q=thumbnail&limit=50"
curl -H "Authorization: Bearer ${ACCESS_TOKEN}" \
"${EPT_API_URL}/v1/stac/items/properties?match=platform=Sentinel-1&collections=coll-a"
Notes¶
bboxisminx,miny,maxx,maxy(or 6 values with altitude); invalid shapes are rejected with422.- Upstream failures surface as the standard Problem Details responses for the EDITO STAC API (502 unavailable / upstream error response).
- The primitives behind these routes (
find_item,find_collection,find_catalog,find_asset,find_propertiesinept/features/stac_find/service.py) are reusable directly by other features.EditoStacApiClient.get_json()backs theGET /searchcall and is available to any feature.