Many catalogs.
One search.

Search across STAC catalogs through one interface, with Python, Rust, or the command line.

Quickstart Installation

pip install superstac

SEARCH ACROSS CATALOGS+

YOUR QUERYsearch()

Earth SearchElement 84

Planetary ComputerMicrosoft

Your catalogCompatible STAC API

Combined STAC results

Guides

Python

Search from scripts and notebooks with the sync or async client.

Rust

Add the search engine to a Rust application.

Command line

List collections, search catalogs, and export results as JSON.

Search example

Register the catalogs you want to search, then query a collection. SuperSTAC sends the request to the relevant catalogs and combines their results.

Filter by location and date.
Normalize collection and asset names, and remove duplicate item IDs.
Check which catalogs responded and which failed.

Full example and configuration

from superstac import Client

client = Client(catalogs=[
    {"id": "earth-search", "url": "https://earth-search.aws.element84.com/v1"},
    {"id": "microsoft", "url": "https://planetarycomputer.microsoft.com/api/stac/v1"},
])
try:
    result = client.search(collections=["sentinel-2-l2a"], limit=5)
    for item in result.items():
        print(item["id"])
finally:
    client.shutdown()

Why SuperSTAC?

The pipeline problem that led to SuperSTAC, and the thinking behind it.

Read the story on Spatialnode

SuperSTAC is in alpha. APIs and configuration may change. Current limitations →