Search items in a specific collection
GET/v1/:contract_id/collections/:collection_id/search
Search for STAC items within a specific collection using query parameters. The collection is determined by the URL path parameter.
Filtering
Searches accept a CQL2 filter expression. The following properties are filterable on every collection:
| Property | Type |
|---|---|
datetime | timestamp |
eo:cloud_cover | number |
gsd | number |
platform | string |
satvu:filter | string |
view:azimuth | number |
view:off_nadir | number |
view:sun_azimuth | number |
view:sun_elevation | number |
Some collections accept additional filter properties when the search is scoped to them:
- acquisition: global properties only
- primary:
processing:software,proj:bbox,proj:epsg,proj:geometry,proj:shape,proj:transform,satvu:atmospheric_model,satvu:atmospheric_model_downwelling,satvu:atmospheric_model_transmission,satvu:atmospheric_model_upwelling,satvu:radiometric_calibration - surface-brightness-temperature:
processing:software,proj:bbox,proj:epsg,proj:geometry,proj:shape,proj:transform,satvu:multiframe_stacking
A collection-specific property can only be used when every collection in the search scope defines it. A cross-collection search that includes a collection without that property therefore cannot filter on it.
The global filterable properties are also discoverable at runtime via the /queryables endpoint.
Request
Responses
- 200
- 429
OK
Too Many Requests - Rate limit exceeded