Assets

Enhanced search with grammar

Search using structured grammar queries with automatic query routing. The enhanced endpoint analyzes the query and routes it to the optimal search strategy:

  • Grammar (tool:midjourney AND tag:hero) — structured field:value filters, routed to SQL
  • Semantic (a dreamy landscape at sunset) — natural language, routed to vector similarity
  • Hybrid (cyberpunk tool:midjourney) — combines semantic + grammar filters
  • Simple (hero banner) — basic text matching

This endpoint is recommended for most use cases — it handles query classification automatically. Use /assets/search for explicit control or /assets/search-semantic for pure vector search.

See the SearchGrammarReference schema for all available grammar fields.

post/api/v1/assets/search-enhanced

Request

  • Base URL: https://numonic.ai
  • URL: https://numonic.ai/api/v1/assets/search-enhanced
  • Auth: API key in header x-api-key

Request body

querystring
mode'exact' | 'partial' | 'fuzzy' | 'fulltext' | 'boolean' | 'smart'
fieldsstring[]
limitinteger
offsetinteger
queryTextstring

Response

Search results returned

Changes

No recorded changes to this operation across all 1 revision of this API.