Search - Nomadic

search()

Run semantic search across all analysed events inside a folder. You can use open-ended natural language queries.

results = client.search(
    query="red pickup truck overtaking",
    folder_name="my_fleet_uploads",
    scope="org",                 # optional, defaults to "user"
)

print(results["summary"])
for thought in results["thoughts"]:
    print("•", thought)

Required Parameters:

Parameter	Type	Description
`query`	`str`	Natural-language search query
`folder_name`	`str`	Human-friendly folder name to search within

Optional Parameters:

Parameter	Type	Default	Description
`scope`	`'user' \| 'org' \| 'sample'`	`'user'`	Scope hint for folder resolution. Use `'org'` for organization folders and `'sample'` for demo/sample folders.

Returns: Dict with:

summary: string overview of the findings
thoughts: list of reasoning steps (chain-of-thought) shown in the UI
matches: list of {video_id, analysis_id, event_index, similarity, reason}
session_id: identifier for the associated search session (useful for re-fetching or sharing)

​search()

search()