Skip to main content
POST
Search

Authorizations

X-API-Key
string
header
required

Your Lightdrift API key. Usage is metered per query.

Body

application/json
query
string
required

Natural-language description of what you need.

k
integer
default:10
Required range: x <= 100
ann_k
integer
default:100

Vector-lane candidate depth. Raise for vibe/aesthetic queries.

Required range: x <= 1000
bm25_k
integer
default:50

Keyword-lane candidate depth. Raise for precise subjects and names.

Required range: x <= 1000
filters
object

All filters are hard constraints applied before ranking.

client_session
string

Optional session id; link related queries for better results over time.

experiment
string

Response

Ranked results with rights.

query
string
count
integer
latency_ms
integer
results
object[]
applied_design
object | null

Present when parse_design was set: the filters inferred from the query text and the phrases that matched.