> ## Documentation Index > Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Rechercher des connaissances techniques > Recherchez dans Mintlify Index des résultats classés issus de la documentation technique et du web. ## OpenAPI ````yaml fr/index-openapi.json POST /v1/search openapi: 3.0.1 info: title: API Mintlify Index description: >- Recherchez et récupérez de la documentation technique et du contexte web pour vos applications et agents. version: 1.0.0 servers: - url: https://leaves.mintlify.com/api/universal-search security: - bearerAuth: [] paths: /v1/search: post: summary: Rechercher des connaissances techniques description: >- Renvoie des résultats classés issus de la documentation gérée par les éditeurs ou du web. Utilisez les identifiants de résultats Mintlify ou l’URL de n’importe quel résultat avec le point de terminaison contents lorsque vous avez besoin de davantage de contenu. operationId: searchIndex requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SearchRequest' example: query: Mise en cache et revalidation dans Next.js 16 numResults: 5 text: maxCharacters: 4000 includeDomains: - nextjs.org responses: '200': description: Recherche terminée avec succès. content: application/json: schema: $ref: '#/components/schemas/SearchResponse' example: requestId: 3d8ed0aa-c21c-4a18-b995-207aa6315ea8 results: - id: nextjs:/docs/app/getting-started/caching-and-revalidating url: >- https://nextjs.org/docs/app/getting-started/caching-and-revalidating title: Mise en cache et revalidation text: >- La mise en cache est une technique qui consiste à stocker le résultat de la récupération de données et d’autres calculs. truncated: false totalCharacters: 92 score: 0.91 source: mintlify siteName: nextjs breadcrumbs: - Routeur App - Premiers pas publishedDate: null '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: schemas: SearchRequest: type: object additionalProperties: false required: - query - numResults properties: query: type: string minLength: 1 description: Requête de recherche. numResults: type: integer minimum: 1 maximum: 20 description: Nombre maximal de résultats à renvoyer. text: default: false description: >- Contrôle le contenu des résultats. Définissez `true` pour inclure le contenu correspondant, `false` pour l’omettre, ou fournissez `maxCharacters` pour inclure du contenu tronqué. En l’absence de valeur, le paramètre vaut `false`. oneOf: - type: boolean - type: object additionalProperties: false required: - maxCharacters properties: maxCharacters: type: integer minimum: 1 description: >- Nombre maximal de caractères de contenu à inclure par résultat. includeDomains: type: array minItems: 1 items: type: string minLength: 1 description: Domaines à inclure dans les résultats de recherche. excludeDomains: type: array minItems: 1 items: type: string minLength: 1 description: Domaines à exclure des résultats de recherche. SearchResponse: type: object additionalProperties: false required: - requestId - results properties: requestId: type: string description: Identifiant unique de la requête. results: type: array items: $ref: '#/components/schemas/SearchResult' description: Résultats de recherche classés. SearchResult: type: object additionalProperties: false required: - id - url - title - text - score - source - siteName - breadcrumbs - publishedDate properties: id: type: string description: >- Identifiant du résultat. Transmettez les identifiants des résultats Mintlify dans le champ `ids` de la requête contents. Pour les résultats web, transmettez l’URL du résultat dans `urls`. url: type: string format: uri description: URL canonique de la source. title: type: string description: Titre de la source. text: type: string description: Contenu correspondant lorsqu’il est demandé. Sinon, une chaîne vide. truncated: type: boolean description: >- Indique si le contenu renvoyé est plus court que le contenu disponible. totalCharacters: type: integer minimum: 0 description: >- Nombre de caractères disponibles avant troncature. Présent lorsqu’il est disponible. score: type: number description: >- Score de pertinence relatif. Les réponses contents utilisent `0`, car elles récupèrent des éléments sélectionnés au lieu de classer les résultats. source: type: string enum: - mintlify - web description: Source de récupération. siteName: type: string description: Site de documentation ou nom d’hôte web. breadcrumbs: type: array items: type: string description: Hiérarchie documentaire du résultat. publishedDate: type: string nullable: true description: "Date de publication lorsque la source en fournit une, sinon `null`. Les résultats `search` la normalisent en horodatage ISO 8601 complet. Les résultats `contents` récupérés via `urls` transmettent la chaîne de date originale de la source sans normalisation\_; il peut s’agir d’un horodatage complet ou d’une date seule." Error: type: object additionalProperties: false required: - error properties: error: type: string description: Message d’erreur. responses: BadRequest: description: Le corps de la requête n’est pas valide. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Corps de requête invalide Unauthorized: description: >- La clé d’API est absente ou invalide, ou l’organisation n’a pas accès à l’API REST Index. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Non autorisé Forbidden: description: L’adresse IP de la requête n’est pas autorisée par la clé d’API. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: L’adresse IP n’est pas autorisée pour cette clé d’API RateLimited: description: L’organisation a dépassé une limite de débit. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Limite de débit dépassée. Veuillez réessayer plus tard InternalError: description: Index n’a pas pu terminer la requête. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Clé d’API Mintlify Index description: Clé d’API Mintlify Index avec le préfixe `mint_us_`. ```` ## Related topics - [Guides](/docs/fr/guides/index.md) - [Prompt](/docs/fr/components/prompt.md) - [Infobulles](/docs/fr/components/tooltips.md)