Skip to content

Overview

Free unified API for Sentinel and Landsat pixels: STAC search, rendering, tiles, statistics and time series.

One API over Sentinel-2, Landsat 4-9, HLS, Copernicus DEM and later Sentinel-1 RTC and Level-1 archives, read from the free public COGs in us-west-2. Bands are named by STAC common name, cloud masks share one bitfield, and harmonization and units are explicit. See plan/api/API design.md for the rules behind every route. Each operation carries x-phase (the build phase it ships in) and x-units (the formula that meters it, or 0).

Developer documentation

Free key from the dashboard, sent as X-API-Key. Works only after the account email is verified.

Security scheme type: apiKey

Header parameter name: X-API-Key

Client-credentials tokens for Sentinel Hub style clients. The client secret is the API key.

Security scheme type: oauth2

Flow type: clientCredentials

Token URL: https://api.satellitedata.net/oauth/token

Scopes:

  • data - Search, render, tiles, statistics, time series, MCP and openEO.
  • account - Read usage and the account, and manage keys.

One-hour Cognito access token from website sign-in, used by the dashboard and the explorer so no page holds an API key. Units are charged to the signed-in account.

Security scheme type: http

Bearer format: JWT

HTTP Basic client authentication on /oauth/token: client id and API key secret (RFC 6749 section 2.3.1).

Security scheme type: http

One-hour guest token from POST /oauth/token with grant_type urn:satellitedata:params:oauth:grant-type:guest. Worth 100 units, accepted only on tiles and previews. The website requests it for signed-out visitors; at most 3 per IP per day.

Security scheme type: http

Bearer format: JWT