Skip to main content
POST
/
search
/
text
Search by text query
curl --request POST \
  --url http://localhost:6699/api/v1/search/text \
  --header 'Content-Type: application/json' \
  --header 'X-License-Key: <api-key>' \
  --data '
{
  "query": "man pointing a finger",
  "cache_dir": "/Users/me/JumperAnalysis",
  "media_paths": [
    "/Videos/interview.mp4"
  ],
  "max_results": 10
}
'
{
  "matches": [
    {
      "frame_index": 123,
      "timestamp": "<string>",
      "similarity": 123,
      "hash_str": "<string>",
      "video_path": "<string>"
    }
  ]
}

Authorizations

X-License-Key
string
header
required

Jumper Pro license key passed via header

Body

application/json
query
string
required

Natural-language search query

Example:

"man pointing a finger"

cache_dir
string
required
media_paths
string[]

Restrict search to these files (ignored if search_all is true)

max_results
integer
default:50
text_weight
number
default:1

Weight of text similarity (advanced)

search_all
boolean
default:false

Search across all loaded media instead of just media_paths

people_filter
object[]

Only return matches containing these people

Response

200 - application/json

Search results ordered by relevance

matches
object[]
Last modified on February 18, 2026