Search satellite images

📚 View developer guide to learn more

Authorizations

Authorization

string

header

required

Body

application/json

Search Query Parameters

satellite

object

required

Show child attributes

satellite.collection_id

string

required

Example:

"sentinel-2-l2a"

satellite.satellite_id

string

required

Example:

"0002a3a3-00a2-4b55-842b-44d8202c6d60"

start_date

string

Example:

"2023-04-18T11:56:49.865Z"

end_date

string

Example:

"2023-05-03T11:56:49.865Z"

filters

object[]

Show child attributes

filters.id

string

required

eo:cloud_cover

Example:

"eo:cloud_cover"

filters.min

integer

required

Example:

0

filters.max

integer

required

100

Example:

100

geometry

object

Show child attributes

geometry.coordinates

any

geometry.type

string

Example:

"Polygon"

skip

integer

Required range: x >= 0

Example:

0

limit

integer

Required range: x >= 1

Example:

10

Response

items

object

Show child attributes

items.{key}

object

Show child attributes

items.{key}.id

string

required

The unique identifier of the item

Example:

"20201211_223832_CS25"

items.{key}.type

string

The type of the item

Example:

"Feature"

items.{key}.collection

string

The collection the item belongs to

Example:

"simple-collection_2"

items.{key}.stac_version

string

The version of the STAC specification

Example:

"1.0.0"

items.{key}.stac_extensions

string[]

The extensions used in the item

Example:

[
  "https://stac-extensions.github.io/eo/v1.0.0/schema.json",
  "https://stac-extensions.github.io/projection/v1.0.0/schema.json",
  "https://stac-extensions.github.io/view/v1.0.0/schema.json"
]

items.{key}.bbox

string[]

The bounding box of the item

Example:

[
  "172.91173669923782",
  "1.3438851951615003",
  "172.95469614953714",
  "1.3690476620161975"
]

items.{key}.geometry

object

The geometry of the item

Show child attributes

items.{key}.geometry.type

enum<string>

The type of the geometry

Available options:

Point,

MultiPoint,

LineString,

MultiLineString,

Polygon,

MultiPolygon,

GeometryCollection

Example:

"Polygon"

items.{key}.geometry.coordinates

any

items.{key}.properties

object

Show child attributes

items.{key}.properties.altitude

number

The altitude of the sensor in meters

Example:

700

items.{key}.properties.constellation

string

The constellation name

Example:

"TD1"

items.{key}.properties.created

string

The date and time the item was created

Example:

"2022-01-01T10:00:00Z"

items.{key}.properties.datetime

string

Example:

"2022-06-15T12:00:00Z"

items.{key}.properties.description

string

A description of the item

Example:

"Example description of the dataset"

items.{key}.properties.eo:cloud_cover

number

The percentage of the image covered by clouds

Example:

23.5

items.{key}.properties.gsd

number

The ground sample distance in meters

Example:

30

items.{key}.properties.instruments

string[]

The instruments used

Example:

["VNIR"]

items.{key}.properties.license

string

The license of the item

Example:

"CC-BY-4.0"

items.{key}.properties.platform

string

The platform name

Example:

"TD1"

items.{key}.properties.proj:code

string

The EPSG code of the projection

Example:

"EPSG:4326"

items.{key}.properties.proj:shape

integer[]

The shape of the projection

Example:

[10980, 10980]

items.{key}.properties.proj:transform

number[]

the affine transform coefficients

Example:

[0, 10, 500000, 0, -10, 1000000]

items.{key}.properties.rd:anomalous_pixels

number

The percentage of anomalous pixels

Example:

0.01

items.{key}.properties.rd:earth_sun_distance

number

The distance between the Earth and the Sun

Example:

1

items.{key}.properties.rd:product_level

string

The product level

Example:

"L2A"

items.{key}.properties.rd:sat_id

string

The satellite ID

Example:

"SAT-123"

items.{key}.properties.rd:type

string

The type of radiometric data

Example:

"Reflectance"

items.{key}.properties.sci:doi

string

The DOI of the scientific publication

Example:

"10.1234/sci_doi"

items.{key}.properties.startdatetime

string

Example:

"2022-01-01T00:00:00Z"

items.{key}.properties.title

string

The title of the item

Example:

"Example Title"

items.{key}.properties.updated

string

The date and time the item was last updated

Example:

"2022-06-01T10:00:00Z"

items.{key}.properties.view:off_nadir

number

The angle between the sensor and the vertical

Example:

5

items.{key}.properties.view:scene_center_lat

number

The latitude of the center of the scene

Example:

12.3456

items.{key}.properties.view:scene_center_lon

number

The longitude of the center of the scene

Example:

-76.5432

items.{key}.properties.view:sun_azimuth

number

The angle between the sun and the north

Example:

135

items.{key}.properties.view:sun_elevation

number

The angle between the sun and the horizon

Example:

45

items.{key}.assets

object

Example

{
	"B091": {
		"href": "<path_to_asset>",
     "type": "image/tiff",
     "roles": ["data"],
     "title": "B091",
     "eo:bands": [
			{
				"fwhm": 0,
             "name": "B091",
             "solar_irradiance": 1984.75,
             "center_wavelength": 490,
             "common_name": "red",
         }
		],
     "raster:bands": [
         {
             "scale": 0.00002,
             "nodata": 0,
         	"offset": 0,
         	"spatial_resolution": 30
       	}
		]
	},
	"B013": {
		"href": "<path_to_asset>",
    	"type": "image/png",
    	"roles": ["data"],
    	"title": "B013",
    	"eo:bands": [
    		{
				"fwhm": 0,
            	"name": "B013",
            	"common_name": "blue",
            	"solar_irradiance": 1965.25,
            	"center_wavelength": 493
        	}
    	],
    	"raster:bands": [
     	{
            	"scale": 0.00002,
            	"nodata": 0,
            	"offset": 0,
            	"spatial_resolution": 30
        	}
    	]
  }
}                                                                                                                                                                                                              // The properties of the item

Show child attributes

items.{key}.assets.{key}

object

Show child attributes

items.{key}.assets.{key}.eo:bands

object[]

Example

[
	{
		"fwhm": 0,
		"name": "B013",
		"common_name": "blue",
		"solar_irradiance": 1965.25,
		"center_wavelength": 493
	}
]

Show child attributes

items.{key}.assets.{key}.eo:bands.center_wavelength

number

The center wavelength of the band in micrometers

Example:

0.443

items.{key}.assets.{key}.eo:bands.common_name

string

The common name of the band (e.g., "coastal", "blue", "green")

Example:

"coastal"

items.{key}.assets.{key}.eo:bands.fwhm

number

The full width at half maximum (FWHM) of the band in micrometers

Example:

0.027

items.{key}.assets.{key}.eo:bands.name

string

The unique name of the band

Example:

"B01"

items.{key}.assets.{key}.eo:bands.solar_irradiance

number

The solar irradiance at the top of the atmosphere for the band in W/m²/μm

Example:

1901

items.{key}.assets.{key}.href

string

The HREF of the asset

Example:

"https://example.com/asset.tif"

items.{key}.assets.{key}.raster:bands

object[]

Example

[
	{
		"scale": 0.00002,
		"nodata": 0,
		"offset": 0,
		"spatial_resolution": 30
	}
]

Show child attributes

items.{key}.assets.{key}.raster:bands.nodata

number

The nodata value of the band

Example:

-9999

items.{key}.assets.{key}.raster:bands.offset

number

The offset of the band

Example:

0

items.{key}.assets.{key}.raster:bands.scale

number

The scale of the band

Example:

1

items.{key}.assets.{key}.raster:bands.spatial_resolution

number

The spatial resolution of the band in meters

Example:

10

items.{key}.assets.{key}.roles

string[]

The roles of the asset (e.g., "data", "metadata")

Example:

["data", "metadata"]

items.{key}.assets.{key}.title

string

A human-readable title for the asset

Example:

"Example Asset Title"

items.{key}.assets.{key}.type

string

The MIME type of the asset

Example:

"image/tiff"

items.{key}.links

object[]

The links of the item

Show child attributes

items.{key}.links.href

string

required

The URL or reference the link points to

Example:

"https://example.com"

items.{key}.links.rel

string

required

The relationship of the link (e.g., "self", "parent", "child")

Example:

"self"

items.{key}.links.title

string

A human-readable title for the link

Example:

"Example Link Title"

items.{key}.links.type

string

The MIME type of the linked resource (e.g., "application/json")

Example:

"application/json"

pagination

object

Show child attributes

pagination.limit

integer

Example:

10

pagination.skip

integer

Example:

0

pagination.total

integer

Example:

100

external

Project

AOI

Search

Indices

Visualizations

Blocks

Insights

Assets

Downloads

Workflows

Jobs

Tasks

Bandset

Order

Archives

Report

Stores

Catalog

Search satellite images

Authorizations

Body

Response