query field. Pureframe AI searches visual content and speech simultaneously by default — no need to know in advance whether the moment you want is something someone said or something that appeared on screen.
collection_id is required for text-only queries — unlike image search, there’s no whole-library text search today.
How matching works
A text query is embedded with the same visual encoder used to index frames, so it can matchframe segments by conceptual similarity even when no words overlap with anything spoken. In parallel, the raw query runs against transcript text via full-text search, matching transcript segments on shared vocabulary. See Combined Queries for how the two are merged.
Natural language queries
For longer or more conversational queries —"find the best tracking shots of someone running on a rooftop" — set natural_language=true. An LLM decomposition step parses the query into a structured visual/transcript split before it hits the underlying search, rather than embedding the raw sentence as-is.