Skip to content

developmentseed/stac-fastapi-collection-discovery

Repository files navigation

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.

About

A collection search-only STAC API for searching collections across multiple STAC APIs

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •