STAC Collection Discovery API¶

A collection-search-only STAC API that aggregates collection search results from multiple upstream STAC APIs. This API provides collection discovery functionality only - it does not support item search operations.

Features¶

Combines collection search results from multiple upstream STAC APIs
Supports standard STAC collection search parameters (bbox, datetime, limit, fields, sortby, filter, free text)
Token-based pagination across multiple APIs
Health check endpoint for monitoring upstream API availability and collection-search capability

Running it locally¶

Run the server with uvicorn¶

Set the required environment variable with comma-separated STAC API URLs:

export UPSTREAM_API_URLS=https://stac.eoapi.dev,https://stac.maap-project.org

Run the server:

uv run python -m uvicorn stac_fastapi.collection_discovery.app:app \
  --host 0.0.0.0 \
  --port 8000 \
  --reload

Run the server with Docker¶

Run the docker network (STAC Collection Discovery API + STAC Browser)

docker compose up

This will bring the API up at http://localhost:8000 and a STAC Browser instance at http://localhost:8080.