# openEO EO Data Discovery API **Canonical:** https://apis.io/apis/openeo/openeo-eo-data-discovery-api/ **Provider:** openEO — https://apis.io/providers/openeo/ **Documentation:** https://api.openeo.org/ openEO EO Data Discovery API is one of 11 APIs that [openEO](https://apis.io/providers/openeo/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 16 JSON Schema definitions. Tagged areas include EO Data Discovery. The published artifact set on APIs.io includes an OpenAPI specification and 16 JSON Schemas. These endpoints allow to list the collections that are available at the back-end and can be used as data cubes for data processing. ## STAC For data discovery of Earth Observation Collections at the back-ends, openEO strives for compatibility with the specifications [SpatioTemporal Asset Catalog (STAC)](https://stacspec.org/) and [OGC API - Features - Part 1: Core](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html) as far as possible. Implementing the data discovery endpoints of openEO also produces valid STAC API 1.x and OGC API - Features 1.x responses, including ([partial](#provide-data-for-download)) compatibility with their APIs. The data discovery endpoints `GET /collections` and `GET /collections/{collection_id}` are compatible with OGC API - Features and STAC. Both specifications define additional endpoints that need to be implemented to be fully compatible. The additional endpoints can easily be integrated into an openEO API implementation. A rough list of actions for compatibility is available below, but please refer to their specifications to find out the full details. **Important:** [STAC specification](https://github.com/radiantearth/stac-spec) and [STAC API](https://github.com/radiantearth/stac-api-spec) are different specifications and have different version numbers. The openEO API allows for the - STAC versions 1.x.x (RECOMMENDED) and 0.9.x (DEPRECATED), and - STAC API versions 1.x.x (RECOMMENDED) and 0.9.x (DEPRECATED). ### Content Extensions STAC has several [extensions](https://stac-extensions.github.io) that can be used to better describe your data. Clients and server are not required to implement all of them, so be aware that some clients may not be able to read all your metadata. Some commonly used extensions that are relevant for datasets exposed through the openEO API are: - [Classification extension](https://github.com/stac-extensions/classification) - [Data Cube extension](https://github.com/stac-extensions/datacube) (part of the openEO API) - [EO (Electro-Optical) extension](https://github.com/stac-extensions/eo) - [Processing extension](https://github.com/stac-extensions/processing) - [Projection extension](https://github.com/stac-extensions/projection) - [Raster extension](https://github.com/stac-extensions/raster) - [SAR extension](https://github.com/stac-extensions/sar) - [Satellite extension](https://github.com/stac-extensions/sat) - [Scientific Citation extension](https://github.com/stac-extensions/scientific) ### Provide data for download If you'd like to provide your data for download in addition to offering the cloud processing service, you can implement the full STAC API. Therefore, you can implement the endpoints `GET /collections/{collection_id}/items` and `GET /collections/{collection_id}/items/{feature_id}` to support retrieval of individual items. To benefit from the STAC ecosystem and allow searching for items you can also implement `POST /search` and `GET /search`. Further information can be found in the [STAC API repository](https://github.com/radiantearth/stac-api-spec). ### API Extensions STAC API has several [extensions](https://stac-api-extensions.github.io) that can be implemented on top of the openEO API to enrich the API functionality, e.g. for searching. ## Operations (3) | Method | Path | Summary | |---|---|---| | GET | `/collections` | Basic metadata for all datasets | | GET | `/collections/{collection_id}` | Full metadata for a specific dataset | | GET | `/collections/{collection_id}/queryables` | Metadata filters for a specific dataset | ## Machine-readable artifacts (17) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/openapi/openeo-eo-data-discovery-api-openapi.yml - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-collection-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-batch-job-result-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-batch-job-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-json-schema-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-process-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-resource-parameter-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-workspace-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-create-workspace-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-register-workspace-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-workspace-description-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-workspace-id-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-workspace-title-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-order-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-order-parameters-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-order-id-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openeo/refs/heads/main/json-schema/openeo-processing-create-parameters-schema.json ## Other openEO APIs (10) - [openEO Account Management API](https://apis.io/apis/openeo/openeo-account-management-api/) - [openEO Batch Jobs API](https://apis.io/apis/openeo/openeo-batch-jobs-api/) - [openEO Capabilities API](https://apis.io/apis/openeo/openeo-capabilities-api/) - [openEO Data Processing API](https://apis.io/apis/openeo/openeo-data-processing-api/) - [openEO File Storage API](https://apis.io/apis/openeo/openeo-file-storage-api/) - [openEO Orders API](https://apis.io/apis/openeo/openeo-orders-api/) - [openEO Process Discovery API](https://apis.io/apis/openeo/openeo-process-discovery-api/) - [openEO Secondary Services API](https://apis.io/apis/openeo/openeo-secondary-services-api/) - [openEO User-Defined Processes API](https://apis.io/apis/openeo/openeo-user-defined-processes-api/) - [openEO Workspaces API](https://apis.io/apis/openeo/openeo-workspaces-api/) ## Tags EO Data Discovery --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/openeo/openeo-eo-data-discovery-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/openeo/.