Quickstart - Locus

You need a Locus API key — a bearer token shaped lsk_<slug>_<random>. See Authentication.

Base URL used here: https://core.locusmedical.fr. Replace it with your deployment’s URL if it differs.

1. Ask a question

curl -X POST https://core.locusmedical.fr/v2/retrieve \
  -H "Authorization: Bearer $LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "antibioprophylaxie chirurgie colorectale"}'

import httpx

resp = httpx.post(
    "https://core.locusmedical.fr/v2/retrieve",
    headers={"Authorization": f"Bearer {LOCUS_API_KEY}"},
    json={"query": "antibioprophylaxie chirurgie colorectale"},
    timeout=120,
)
resp.raise_for_status()
data = resp.json()
print(data["answer"])          # Markdown, with its citations
print(data["trace_id"])        # send this back to /v2/feedback

const resp = await fetch("https://core.locusmedical.fr/v2/retrieve", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOCUS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "antibioprophylaxie chirurgie colorectale" }),
});
const { answer, trace_id } = await resp.json();

answer is Markdown. The same route can also render a readable document, picked with the Accept header:

curl -X POST https://core.locusmedical.fr/v2/retrieve \
  -H "Authorization: Bearer $LOCUS_API_KEY" \
  -H "Accept: text/markdown" \
  -H "Content-Type: application/json" \
  -d '{"query": "antibioprophylaxie chirurgie colorectale"}'

2. Stream progress into your UI

An answer is built in several heavy steps. Rather than leave the user watching a bar that invents its progress, call /v2/retrieve/stream: one JSON line per step that actually completed, then a done line carrying the full payload.

3. Try it in the playground

The API Reference tab shows every endpoint with an interactive playground. Click Authorization, paste your lsk_… key, and fire a request without leaving the docs.

Next steps

Authentication

Key format, hashing, quotas.

Capabilities

What each endpoint does and when to use it.