Skip to main content
POST
Search brands

Authorizations

X-API-Key
string
header
required

API key issued by the Taste Engine. Create one in the dashboard at https://engine.tastelabs.com/app/api-keys.

Body

application/json
query
string
required

Natural-language description of the aesthetic you are looking for.

Required string length: 2 - 400
Example:

"dark brutalist developer tools"

depth
enum<string>
default:fast

Search depth. fast returns in seconds. deep consumes more credits and can take up to ~3 minutes, for when result quality matters more than latency.

Available options:
fast,
deep
top_k
integer
default:6

Maximum number of results to return.

Required range: 1 <= x <= 30
filters
object | null

Hard constraints on the results, not a ranking hint: every returned card satisfies them, and the list is never padded with out-of-filter lookalikes. Values are matched verbatim against the corpus vocabulary, so an unknown value returns no matches rather than an error.

Response

Ranked results for the query.

search_id
string

Identifier of this search, as recorded in your search history.

depth
enum<string>
default:fast

Search depth. fast returns in seconds. deep consumes more credits and can take up to ~3 minutes, for when result quality matters more than latency.

Available options:
fast,
deep
results
object[]

Ranked results, best match first.

query_tags
object | null

The engine's soft reading of the query, for display only. Never a constraint: results are not guaranteed to satisfy these. Only the request's filters narrow retrieval.