Image API

The Image API provides direct access to Spexi's drone imagery library, allowing you to search, filter, and download full resolution images available to your account.

Endpoints

• Search Images - search by location and camera parameters, with pagination

• Search Multi-View Images - get up to 5 curated images of a location from diverse angles in one call

• Download Image File - download a single image by id, with optional zoom and crop

Spatial Filtering

Every search endpoint requires at least one way to describe where you're looking: a point (p), a bounding box (bbox), or a polygon (polygon).

Search Images supports full filtering on top of this, including camera angle, altitude, capture date, and capture type, combined with AND logic, plus focused filtering (see below).

Search Multi-View Images only adds capture date (captured_at) filtering. Instead of manual filtering, it automatically curates up to 5 images (nadir plus each cardinal direction, when available) for the location.

Focused Filtering (Search Images only)

By default, Search Images results are filtered and ranked so the most relevant, well-framed images surface first; this is what focused controls. It works in three steps:

1. Spatial filtering - start with all images whose footprint contains your point or area of interest

2. Edge filtering - remove images where that point or area sits too close to the frame's edge

3. Focus scoring - rank the remainder by how prominently the point or area is featured, returning only images above a quality threshold

Set focused=false to skip this and get all spatially intersecting images regardless of framing. This is useful for systematic processing or full coverage extraction.

Downloading Images

Every image feature's links array includes two download options:

• rel: "original" - full resolution image as captured

• rel: "zoomed" - automatically cropped and zoomed to your area of interest

Download URLs require the same x-api-key authentication as the search requests. Images are delivered as high-resolution JPEGs with EXIF and XMP metadata embedded.