Back to API overview
Imagery

Search imagery

GET/v1/imagery/search Bearer API key

Find available imagery over a region within a date range and cloud-cover threshold.

Query the catalog for scenes that intersect a region between two dates. Filter by maximum cloud cover and sensor type to narrow results. Returns lightweight scene descriptors you can pass into an analysis job.

Path & query parameters

region_idrequiredstring

The region to search within.

startrequireddate

Start of the acquisition window (ISO 8601).

endrequireddate

End of the acquisition window (ISO 8601).

max_cloudoptionalnumber

Maximum acceptable cloud cover, 0–100. Defaults to 20.

Response fields

scenesoptionalScene[]

Array of matching scene descriptors.

scenes[].idoptionalstring

Scene identifier for use in analysis jobs.

scenes[].captured_atoptionaltimestamp

Acquisition time of the scene.

scenes[].cloud_coveroptionalnumber

Cloud cover percentage for the scene.

curl -G https://api.satellitex.ai/v1/imagery/search \
  -H "Authorization: Bearer sk_live_..." \
  --data-urlencode "region_id=reg_central_valley" \
  --data-urlencode "start=2026-06-01" \
  --data-urlencode "end=2026-07-01" \
  --data-urlencode "max_cloud=10"

Illustrative API — keys and identifiers are for demonstration.

Related endpoints

Ready to build with this?

Request access and we'll help you scope your first mission and provision API keys.

Request API access