Search a Studio

Deep Search finds events in a Studio from a plain-language query, using the same search experience as the app. You need a Studio ID and an API key that can access it. Create a Studio if you do not have one yet.

import os
from nomadic import NomadicAI

client = NomadicAI(api_key=os.environ["NOMADIC_API_KEY"])
studio = client.studio.get("STUDIO_ID")

results = client.studio.search(
    studio.id,
    "a forklift passing close to a pedestrian",
    top_k=25,
)

for event in results:
    print(event.video_id, event.start_time, event.description)

Iteration returns the ranked matches in this response. top_k defaults to 50 and can be at most 1,000; search results do not paginate beyond it. Check results["truncated"] to see whether more candidates were found. Use results.first(10) when you only need a sample.

Refine by taxonomy

Add an exact taxonomy condition to the same search. This sends a new request; the original results stays available. The condition is applied before Deep Search reranks the matching events.

refined = results.filter(filters={"hands_used": "both"})

for event in refined:
    print(event.video_id, event.start_time)

See Filter a Studio to discover available fields and values, combine AND/OR conditions, and iterate through all exact matches.

Watch the matches

In a notebook, display the matching videos and click an event to play from its timestamp when available:

results.visualize()

In a script, save the viewer and open the file in a browser:

results.visualize(display=False, output_path="studio-matches.html")

Playback is optional. visualize() requests short-lived video URLs only when you call it, and shows the first 10 matching videos by default. Pass max_videos=5 to show fewer. Saved viewers need fresh URLs after 15 minutes; run visualize() again to refresh them. Video playback requires access to the source videos.

Overview

Getting Started

Dataset Studio

Deployment

Advanced

Legal

Search a Studio

Refine by taxonomy

Watch the matches

​Refine by taxonomy

​Watch the matches

Refine by taxonomy

Watch the matches