v1

latestOpenAPI 3.0.02026-08-0455133277.1 KB

Search satellite images

Search for satellite images using various filters and parameters. This endpoint uses cursor-based pagination with next_token for efficient navigation through large result sets and consistent behaviour across external providers (Planetary, Element). Use the next_token from the response to fetch subsequent pages of results.

post/v0/search

Request body

start_datestring required

end_datestring required

limitinteger

Example request

{
  "start_date": "2023-04-18T11:56:49.865Z",
  "end_date": "2023-05-03T11:56:49.865Z",
  "satellites": [
    {
      "collection_id": "sentinel-2-l2a",
      "satellite_id": "0002a3a3-00a2-4b55-842b-44d8202c6d60"
    }
  ],
  "filters": [
    {
      "id": "eo:cloud_cover",
      "max": 100
    }
  ],
  "geometry": {
    "type": "Polygon"
  },
  "limit": 10
}

Response

itemsobject

Example response

{
  "pagination": {
    "limit": 10,
    "total": 100
  }
}