> ## Documentation Index
> Fetch the complete documentation index at: https://docs.locusmedical.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# search

> Retrieval structuré et citable depuis la base de connaissance clinique.

`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](/fr/capabilities/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 :

```json theme={null}
{
  "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
}
```

<Note>
  `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`.
</Note>

Essayez en direct dans l'onglet **API Reference**.