> For the complete documentation index, see [llms.txt](https://learn.spexi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.spexi.com/api-reference/image-api.md).

# 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](/api-reference/image-api/search-images.md) - search by location and camera parameters, with pagination
* [Search Multi-View Images](/api-reference/image-api/search-multi-view-images.md) - get up to 5 curated images of a location from diverse angles in one call
* [Download Image File](#downloading-images) - 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

{% hint style="info" %}
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.
{% endhint %}

### 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.