# Rechercher dans la documentation (/fr/api/assistant/search)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1015 · updated: 2026-07-30 -->
Related: [Créer un message de l'Assistant](/fr/api/assistant/create-assistant-message-v2.md), [Obtenir le contenu de la page](/fr/api/assistant/get-page-content.md)

<div id="rate-limits">
  ## Limites de débit [#limites-de-débit]
</div>

* 10 000 requêtes par organisation Mintlify par heure

`POST /v1/search/{domain}`

Effectuez des recherches sémantiques et par mots-clés dans votre documentation, avec un filtrage et une pagination configurables.

Authentifiez-vous avec une clé d'API assistant. Les requêtes de recherche ne consomment pas de crédits.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "domain",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "L’identifiant de domaine extrait de votre URL `domain.mintlify.site`. Il se trouve à la fin de l’URL de votre Dashboard. Par exemple, dans `dashboard.mintlify.com/organization/domain`, l’identifiant de domaine est `domain`."
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "query"
          ],
          "properties": {
            "query": {
              "type": "string",
              "description": "La requête de recherche à exécuter sur le contenu de votre documentation."
            },
            "pageSize": {
              "type": "integer",
              "default": 10,
              "minimum": 1,
              "maximum": 50,
              "description": "Nombre de résultats de recherche à retourner. Doit être compris entre 1 et 50. La valeur par défaut est 10 si aucune valeur n’est spécifiée."
            },
            "scoreThreshold": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "Score de pertinence minimal pour les résultats. Seuls les résultats ayant un score supérieur ou égal à ce seuil sont renvoyés. Doit être compris entre 0 et 1."
            },
            "filter": {
              "type": "object",
              "description": "Paramètres de filtrage optionnels permettant de restreindre les résultats de recherche.",
              "properties": {
                "version": {
                  "type": "string",
                  "description": "Filtrer les résultats par version de la documentation."
                },
                "language": {
                  "type": "string",
                  "description": "Filtrer les résultats par langue du contenu."
                },
                "tag": {
                  "type": "string",
                  "description": "Filtrer les résultats par tag."
                },
                "groups": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Groupes de documentation optionnels auxquels l’appelant est autorisé à accéder. Lorsque le déploiement utilise `auth` ou `userAuth`, les résultats sont limités aux pages que les groupes spécifiés peuvent consulter. Si ce champ est omis ou vide sur un déploiement protégé, les résultats se limitent aux pages publiques."
                }
              }
            }
          }
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Résultats de recherche",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "content": {
                  "type": "string",
                  "description": "Le contenu correspondant issu de votre documentation."
                },
                "path": {
                  "type": "string",
                  "description": "Le chemin d’accès ou l’URL du document source."
                },
                "metadata": {
                  "type": "object",
                  "description": "Metadata supplémentaires relatives au résultat de recherche."
                }
              }
            }
          }
        }
      }
    }
  }
}
```