Skip to main content
POST
Search by reference image

Authorizations

X-License-Key
string
header
required

Jumper Pro license key passed via header

Body

application/json
image_path
string
required

Absolute path to the reference image

cache_dir
string
required
query
string

Optional text query to combine with the image

exclude
string[]

Softly push down results that match these visual concepts. Requires query text.

media_paths
string[]
max_results
integer
default:50
search_all
boolean
default:false
metadata_filter_request
object

Metadata filters to apply to a search. If scope is omitted, Jumper derives it from the endpoint's search_all and media_paths values.

Response

200 - application/json

Search results ordered by visual similarity

matches
object[]
Last modified on July 14, 2026