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

Authorisations

AuthorizationString

Request Body

start_datestringrequired

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

end_datestringrequired

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

satellitesobject[]required

Show child attributes

filtersobject[]

Show child attributes

geometryobjectrequired

Show child attributes

limitinteger

Example: 10

Response

application/json

itemsobject

paginationobject

Show child attributes

Search satellite imagescURL
Python
Go
TypeScript
1curl -X POST 'https://api.pixxel.space/v0/search' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"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",
    "min": 0,
    "max": 100
  }
],
"geometry": null,
"limit": 10
22}'

Response:

{
  "items": {},
  "pagination": {
    "limit": 10,
    "skip": 0,
    "total": 100
  }
}