Skip to main content
POST
Structured clinical search

Authorizations

Authorization
string
header
required

Locus API key — paste the raw lsk_… value (no 'Bearer ' prefix).

Body

application/json
query
string
required

Free-text clinical query in French, matched against the clinical knowledge base.

Minimum string length: 1
Examples:

"antibioprophylaxie chirurgie colorectale"

"prise en charge HTA gravidique"

source_ids
integer[] | null

Optional allow-list of source ids to restrict retrieval to specific sources. Omit (the default) to search all sources.

Example:
limit
integer
default:10

Maximum number of structured document units to return.

Required range: 1 <= x <= 50
max_chunks_per_unit
integer
default:3

Maximum number of best-matching chunks to keep per document unit. Lower keeps the payload tight; raise to expose more excerpts.

Required range: 1 <= x <= 20

Response

Successful Response

query
string
required

Echo of the submitted query.

units
SearchUnit · object[]
required

Structured document units, ordered by relevance. Each is a citable source — never a free-form answer blob.

retrieved_pool
integer
required

Diagnostic: number of raw chunks swept from the knowledge base before grouping into units. This is the retrieval pool size, NOT bounded by limit (which caps returned units).