v0.3 · What’s new

Many catalogs.
One search.

Find satellite imagery across providers with one query. Combine the results, save the metadata you need, and explore it again with fewer API requests.

pip install superstac
SEARCH ACROSS CATALOGS+
YOUR QUERYsearch()
Earth SearchElement 84
Planetary ComputerMicrosoft
Your catalogCompatible STAC API
Combined STAC results

Find imagery. Keep the metadata you need.

One search workflow for Python notebooks, Rust applications, and the command line.

Keep exploring the same study area.

Exploring the same region over multiple sessions? Save its catalog metadata to GeoParquet, then refine your searches locally. Scope ingestion by collection, area, and time so you only collect what you need.

  • Follow ingestion progress, set a storage limit, and resume interrupted work.
  • Search the saved coverage locally; let automatic mode fall back to live catalogs when needed.
  • Add recent dates and clean up old files as your project grows.

Inventories store metadata. Imagery previews and downloads still use the provider’s assets.

Try the GeoParquet notebook
Save once. Search again.

Explore different queries within your saved coverage.

How fast is local search?

Our benchmark measures how skipping irrelevant data speeds up a selective search over 100,000 synthetic items. See the results and run it yourself.

Explore the benchmark

Guides

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

Reference

Configuration Python API Troubleshooting

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