> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-96d76bd3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Rechercher dans la documentation

> 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.

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

* 10 000 requêtes par organisation Mintlify par heure


## OpenAPI

````yaml fr/discovery-openapi.json POST /v1/search/{domain}
openapi: 3.0.1
info:
  title: Mintlify Assistant API
  description: >-
    Une API pour intégrer les fonctionnalités de découverte de Mintlify à votre
    produit.
  version: 1.0.0
servers:
  - url: https://api.mintlify.com/discovery
security:
  - bearerAuth: []
paths:
  /v1/search/{domain}:
    post:
      summary: Rechercher dans la documentation
      description: >-
        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.
      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.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        L'en-tête Authorization attend un jeton Bearer. Utilisez une clé d'API
        assistant. Générez-en une depuis la [page des clés
        d'API](https://dashboard.mintlify.com/settings/organization/api-keys) de
        votre Dashboard. En production, faites transiter les requêtes par votre
        backend plutôt que d'intégrer la clé dans du code côté client.

````