search: STAC Search (GET)

API: nasa.gov:nasa-earthdata-api
Endpoint: /{providerId}/search
Response format: application/json
Auth: none
Method: GET

Description

Search for STAC items using GET method. Supports spatial, temporal, and collection filters.

Parameters (6)

bbox (string, query, optional)

Bounding box for spatial search

collections (string, query, optional)

Collection IDs to search (comma-separated)

datetime (string, query, optional)

Temporal filter in ISO 8601 format

ids (string, query, optional)

Specific item IDs to retrieve

limit (integer, query, optional, default: 10)

Maximum number of items to return

Constraints: {'maximum': 10000}

providerId (string, path, required)

Provider ID or 'ALL' to search all providers

Examples (1)

STAC Search (GET) openapi-spec
curl 'https://cmr.earthdata.nasa.gov/{providerId}/search?bbox=-110%2C39.5%2C-105%2C40.5&datetime=2020-01-01T00%3A00%3A00Z%2F2020-12-31T23%3A59%3A59Z'
import requests

resp = requests.get(
    "https://cmr.earthdata.nasa.gov/{providerId}/search",
    params={
        'bbox': '-110,39.5,-105,40.5',
        'datetime': '2020-01-01T00:00:00Z/2020-12-31T23:59:59Z',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("nasa-earthdata")
result = api.fetch("{providerId}/search", bbox="-110,39.5,-105,40.5", datetime="2020-01-01T00:00:00Z/2020-12-31T23:59:59Z")

for item in result:
    print(item)
const resp = await fetch("https://cmr.earthdata.nasa.gov/{providerId}/search?bbox=-110%2C39.5%2C-105%2C40.5&datetime=2020-01-01T00%3A00%3A00Z%2F2020-12-31T23%3A59%3A59Z");
const data = await resp.json();

No probe data for this endpoint yet.