post
https://api.canopy.umbra.space/archive/search
Search for Archive STAC items with full-featured filtering. Implements the STAC API Item Search Specification and STAC API Filter Extension.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Examples
For more context and examples, see the Search the Archive Catalog API
Example of how to search for items by task id via curl using CQL2:
curl --request POST \
--url https://api.canopy.umbra.space/archive/search \
--header 'Authorization: Bearer <token>' \
--header 'accept: application/geo+json' \
--header 'content-type: application/json' \
--data '
{
"limit": 1,
"filter-lang": "cql2-json",
"filter": {
"op": "=",
"args": [
"ecfe0bed-28d9-4ac6-a835-64d89e47e7c9",
{
"property": "umbra:task_id"
}
]
}
}
'And by collect id (can include multiple collect ids if desired):
curl --request POST \
--url https://api.canopy.umbra.space/archive/search \
--header 'Authorization: Bearer <token>' \
--header 'accept: application/geo+json' \
--header 'content-type: application/json' \
--data '
{
"limit": 1,
"filter-lang": "cql2-json",
"filter": {
"op": "a_overlaps",
"args": [
["b14a01ad-7c44-43e3-9efc-91167798b00d"],
{
"property": "umbra:collect_ids"
}
]
}
}
'To look up many items by archive id:
curl --request POST \
--url https://api.canopy.umbra.space/archive/search \
--header 'Authorization: Bearer <token>' \
--header 'accept: application/geo+json' \
--header 'content-type: application/json' \
--data '
{
"limit": 1000,
"filter-lang": "cql2-json",
"filter": {
"op": "in",
"args": [
{
"property": "id"
},
[
"09a3fbdb-0619-4774-a9a6-ce0168034294",
"30741721-be00-478b-97fc-40245926d551",
"61aec560-9a5f-4445-bb1b-8c96536144db",
"87e17704-7690-4a3d-972b-791111f11839",
"5cb981fc-40b4-4397-b4f3-1f4159d13245",
...
]
]
}
}
'Links
For additional documentation of this STAC endpoint: https://github.com/radiantearth/stac-api-spec/tree/release/v1.0.0/item-search
For examples on how to query using CQL2: