Assets

Search assets

Full-text search across asset metadata and content. Supports plain text queries and structured grammar syntax (field:value) with boolean operators.

Grammar syntax — combine field filters with AND, OR, NOT:

  • tool:midjourney AND tag:approved — Midjourney assets tagged "approved"
  • mime_type:image/png OR mime_type:image/webp — PNG or WebP images
  • created:>2025-01-01 AND width:>1920 — recent high-res assets
  • prompt:"cyberpunk city" NOT status:Trashed — prompt search excluding trash

Value syntax: quoted strings for exact match (title:"hero banner"), wildcards (filename:hero*), ranges for numeric/date fields (width:>1920, created:2025-01..2025-12).

See the SearchGrammarReference schema for the full list of ~50 grammar fields across core metadata, dates, dimensions, AI generation, ComfyUI, and lineage domains.

post/api/v1/assets/search

Request

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

Request body

querystring

Search query text

queryTextstring

Legacy alias for query

orderBy'newest' | 'oldest' | 'relevance' | 'similarity' | 'name-asc' | 'name-desc' | 'random' | 'generated-newest' | 'generated-oldest' | 'downloaded-newest' | 'downloaded-oldest'

Sort order for results. generated-/downloaded- sort on the tri-temporal provenance dates (browse path only; clamped to newest when query text is present).

mode'exact' | 'partial' | 'fuzzy' | 'fulltext' | 'boolean' | 'smart'

Search matching mode

fieldsstring[]

Fields to search within

queryVectornumber[]

Pre-computed embedding vector for semantic search

similarToAssetHstring

Find assets similar to this asset hash

embeddingConfigHstring

Embedding configuration hash for vector search

filtersobject

Key-value pairs for filtering (e.g., {"status": "Approved", "tags": ["logo"]})

limitinteger
offsetinteger
includeScoreboolean
randomSeednumber

Seed for consistent random ordering

Response

Search results returned

Changes

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