Skip to main content
POST
Search by video frame

Authorizations

X-License-Key
string
header
required

Jumper Pro license key passed via header

Body

application/json
media_path
string
required

Video to extract the reference frame from

time_seconds
number
required

Timestamp in seconds for the reference frame

cache_dir
string
required
query
string

Optional text query to combine with the frame

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