search - Locus

search interroge la base de connaissance clinique et renvoie des unités documentaires structurées — jamais un bloc de texte libre. C’est la fondation de retrieval sur laquelle reposent les autres capacités. Endpoint : POST /v1/search · Outil MCP : search

Quand l’utiliser

Vous voulez les sources brutes d’une requête, pour les afficher ou les citer.
Vous construisez votre propre synthèse et n’avez besoin que du retrieval.

Pour une réponse rédigée plutôt que des sources, utilisez answer.

Requête

Champ	Type	Notes
`query`	string	Requête clinique en texte libre (français).
`source_ids`	int[]	Optionnel. Restreindre à des sources précises.
`limit`	int	Nombre max d’unités documentaires (défaut 10).
`max_chunks_per_unit`	int	Meilleurs extraits gardés par unité (défaut 3).

Réponse

Chaque unité est un document source avec ses meilleurs extraits :

{
  "query": "antibioprophylaxie chirurgie colorectale",
  "units": [
    {
      "document_id": 14853,
      "document_title": "Antibioprophylaxie en chirurgie",
      "reco_id": 900,
      "reco_title": "Chirurgie colorectale",
      "source_id": 3,
      "source_name": "SFAR",
      "year": "2023",
      "deep_link": "https://.../14853.pdf",
      "score": 0.91,
      "chunks": [
        { "chunk_index": 0, "content": "Céfazoline en dose unique...", "score": 0.91 }
      ]
    }
  ],
  "retrieved_pool": 100
}

limit plafonne le nombre d’unités documentaires, pas d’extraits. retrieved_pool est le compteur diagnostique d’extraits balayés avant regroupement — il n’est pas borné par limit.

Essayez en direct dans l’onglet API Reference.