---
title: "Recherche dans le catalogue, en mots-clés ou en langage naturel"
method: GET
path: "/v1/search"
tags: ["B2B (v1)"]
---

# Recherche dans le catalogue, en mots-clés ou en langage naturel

`GET /v1/search`

## Request

- Base URL: `https://api.vitef.com`
- URL: `https://api.vitef.com/v1/search`
- Auth: HTTP bearer

Recherche hybride : mots-clés et alias (instantané) fusionnés avec une recherche sémantique (« mon propriétaire garde ma caution » → dépôt de garantie). Le sémantique n’intervient que si la requête le justifie (aucun résultat par mots-clés, ou 3 mots et plus) ; en cas d’indisponibilité, la réponse reste lexicale (`mode: lexical`).

## Query parameters

- `q` string, required
- `limit` integer
- `mode` 'hybrid' | 'lexical': `lexical` : mots-clés seuls (sans appel au moteur sémantique).

## Response `200`

Résultats

- SearchResults
  - `results` object[], required
    - `title` string, required
    - `sub` string, required
    - `icon` string, required
    - `kind` string, required: Lettre, Calcul, IA, Devis, Page…
    - `path` string, required
    - `url` string, required
  - `mode` 'hybrid' | 'lexical', required: Moteur effectivement utilisé : `hybrid` (mots-clés + sémantique) ou `lexical` (mots-clés seuls, y compris en repli).

## Other responses

- `400`: Requête invalide
- `401`: Authentification requise ou invalide
- `403`: Accès refusé (`insufficient_scope`, `account_suspended`, `live_not_enabled`)
- `429`: Trop de requêtes
- `500`: Erreur interne

---

[API](https://skmtc.dev/vitef/apis/api-vitef.md) · [All operations](https://skmtc.dev/vitef/apis/api-vitef/llms.txt) · [OpenAPI document](https://skmtc.dev/vitef/apis/api-vitef/revisions/7bc459d9ef90?raw)