ImageryService

SearchImagery

SearchImagery searches satellite imagery scenes by bounding box, datetime range, and source, returning matching scenes and a total-results count.

get/api/imagery/v1/search-imagery

Request

  • Base URL: https://api.worldmonitor.app
  • URL: https://api.worldmonitor.app/api/imagery/v1/search-imagery
  • Auth: one of:
    • API key in header X-WorldMonitor-Key
    • API key in header X-Api-Key

Query parameters

bboxstring

Bounding box filter for imagery search, encoded as west,south,east,north.

datetimestring

ISO 8601 datetime or datetime range for matching imagery scenes.

sourcestring

Optional imagery source filter, such as satellite or provider name.

limitinteger

Maximum number of imagery scenes to return.

jmespathstring

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

OK

totalResultsinteger
cacheHitboolean

Changes

No recorded changes to this operation across all 1 revision of this API.