API Documentation
Omnicat exposes multiple APIs over the same base URL. Select an API below to browse its endpoints, try live requests, and copy ready-to-run code snippets.
/stac/v1. Qubed adds hierarchical catalogue browsing:
any collection can be drilled into key-by-key (e.g. class → stream → type → …)
using the /catalog/… sub-tree, making it trivial to navigate massive
multidimensional datasets without enumerating all items upfront.
Collection
Each unique dataset dimension value maps to a STAC Collection with extent, summaries and links.
Hierarchical Catalog
Qubed extension — browse one MARS key at a time via /catalog/key=val/…. The next_key field drives drill-down.
Item Search
Cross-collection full-text search via GET /search or POST /search with arbitrary MARS key filters.
Item
A single datacube leaf — all MARS key=value metadata exposed as GeoJSON Feature properties.
STAC Browser
Radiant Earth's open-source visual STAC explorer — opens this catalogue directly.
Built-in STAC Browser
Integrated hierarchical browser with live key drill-down, item detail and code snippets.
Raw API
Explore raw JSON responses in the browser or pipe to jq.
pystac-client
Official Python client — search, iterate collections and download items programmatically.
/ogc/v1. Each dataset is exposed as a
record catalog browsable via a hierarchical key-by-key drill-down using the
/browse/… sub-tree. Records support free-text search via the q
parameter and MARS key filtering on collection item listings.
Catalog (Collection)
Each dataset maps to an OGC record catalog with extent, themes and MARS dimension summaries.
Record
A single datacube leaf exposed as an OGC Feature with MARS properties, themes, and contact info.
Free-text Search
Cross-catalog search with the q parameter — matches across all record property values.
Browse Tree
Qubed extension — hierarchical drill-down via /browse/key=val/… with next_key navigation.
/api/v2. It serves the raw
Qubed data structure — a compact arena-JSON representation of a
multidimensional index — and allows arbitrary selections by MARS key-value query
parameters. This is the lowest-level API; all higher-level APIs (STAC, OGC Records,
the catalogue browser) are built on top of it.
Qube
A compact arena-JSON tree encoding all MARS dimension key/value combinations in the catalogue.
Select
Filter the Qube to a subset by passing MARS key-value query params. Returns a pruned arena-JSON Qube.