Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

NASA CMR STAC API

Extension to WFS3 Core to support STAC metadata model and search API

NASA CMR STAC API is one of 9 APIs that NASA CMR publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include STAC. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 1 path, and defines 17 schemas. It is described by OpenAPI 2.0, at version 1.0.0.

Requests are made against the base URL https://cmr.earthdata.nasa.gov/search.

2 operations 1 paths 17 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0.0
Base URL
https://cmr.earthdata.nasa.gov/search
Resource Areas
1

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

STAC 2

Extension to WFS3 Core to support STAC metadata model and search API

GET
/{providerId}/search
Search STAC items with simple filtering.
getSearchSTAC 7 params → 200default
POST
/{providerId}/search
Search STAC items with full-featured filtering.
postSearchSTAC body → 200default

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are item (9 properties), link (6 properties), itemCollection (3 properties), exception (2 properties). Each schema is shown below with its type and property counts.

stac_extensions
array
exception
object
Information about the exception: an error code plus an optional description.
2 properties 1 required
datetimeFilter
object
An object representing a date+time based filter.
1 property
item
object
A GeoJSON Feature augmented with foreign members that contain values relevant to a STAC entity
9 properties 8 required
bboxFilter
object
Only return items that intersect the provided bounding box.
1 property
link
object
A generic link.
6 properties 2 required
bbox
array
Only features that have a geometry that intersects the bounding box are selected. The bounding box is provided as four or six numbers, depending on whether the…
intersectsFilter
object
Only returns items that intersect with the provided polygon.
1 property
itemCollection
object
A GeoJSON FeatureCollection augmented with foreign members that contain values relevant to a STAC entity
3 properties 2 required
itemProperties
object
provides the core metatdata fields plus extensions
1 property 1 required
itemAssets
object
datetime
string
Either a date-time or an interval, open or closed. Date and time expressions adhere to RFC 3339. Open intervals are expressed using double-dots. Examples: A da…
itemCollectionLinks
array
An array of links. Can be used for pagination, e.g. by providing a link with the next relation type.
stac_version
string
itemId
string
Provider identifier, a unique ID, potentially a link to a file.
itemType
string
The GeoJSON type
searchBody
object
The search criteria

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nasa-cmr-stac-api-openapi.yml Raw ↑

Other APIs NASA CMR publishes across the network.

CMR Ingest API
CMR Access Control API
CMR GraphQL API
CMR STAC API
CMR OpenSearch API
NASA CMR Capabilities API
NASA CMR Collections API
NASA CMR Data API