---
title: "Search satellite images"
method: POST
path: "/v0/search"
tags: ["Search"]
---

# Search satellite images

`POST /v0/search`

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.

## Request body

- LensV2Query
  - `start_date` string, required
  - `end_date` string, required
  - `satellites` LensSatelliteInfo[], required
    - `collection_id` string, required
    - `satellite_id` string, required
  - `filters` LensFilter[]
    - `id` string, required — eo:cloud_cover
    - `min` integer, required — 0
    - `max` integer, required — 100
  - `geometry` LensGeometry, required
    - `coordinates` unknown
    - `type` string
  - `limit` integer

## Response `200`

OK

- LensV2Response
  - `items` object
  - `pagination` object
    - `limit` integer
    - `skip` integer
    - `total` integer

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/versions/b501e2ca5a9d/schema)