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

# Obtenir le contenu des résultats

> Récupérez le contenu de Mintlify Index à partir d’un identifiant ou d’une URL de résultat après une recherche.



## OpenAPI

````yaml fr/index-openapi.json POST /v1/contents
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/contents:
    post:
      summary: Obtenir le contenu des résultats
      description: >-
        Récupère le contenu correspondant aux identifiants de résultats Mintlify
        ou aux URL de résultats renvoyés par le point de terminaison search. Une
        requête peut inclure jusqu’à 20 éléments répartis entre les deux champs.
      operationId: getIndexContents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContentsRequest'
            example:
              ids:
                - nextjs:/docs/app/getting-started/caching-and-revalidating
              query: revalider les données mises en cache
              maxCharacters: 12000
      responses:
        '200':
          description: >-
            Récupération du contenu terminée. Vérifiez chaque statut pour
            déterminer si l’élément correspondant a réussi.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentsResponse'
              example:
                requestId: 6bf694e4-76cb-4d31-a222-c94b2d9b198a
                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: >-
                      # Mise en cache et revalidation


                      Utilisez les API de revalidation pour actualiser les
                      données mises en cache.
                    truncated: false
                    totalCharacters: 78
                    score: 0
                    source: mintlify
                    siteName: nextjs
                    breadcrumbs:
                      - Routeur App
                      - Premiers pas
                    publishedDate: null
                statuses:
                  - id: nextjs:/docs/app/getting-started/caching-and-revalidating
                    status: success
        '400':
          description: Le corps de la requête n’est pas valide.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: >-
                  Une requête peut référencer au maximum 20 éléments entre urls
                  et ids
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    ContentsRequest:
      type: object
      additionalProperties: false
      description: >-
        Fournissez au moins un identifiant de résultat Mintlify ou une URL de
        résultat. Vous pouvez combiner les deux champs, dans la limite de 20
        éléments au total.
      anyOf:
        - required:
            - urls
        - required:
            - ids
      properties:
        urls:
          type: array
          minItems: 1
          maxItems: 20
          items:
            type: string
            format: uri
          description: >-
            URL de résultats à récupérer. Utilisez ce champ pour les résultats
            web.
        ids:
          type: array
          minItems: 1
          maxItems: 20
          items:
            type: string
            minLength: 1
          description: Identifiants de résultats Mintlify à récupérer.
        maxCharacters:
          type: integer
          minimum: 1
          description: Nombre maximal de caractères de contenu à renvoyer par résultat.
        query:
          type: string
          minLength: 1
          description: >-
            Requête utilisée pour sélectionner les sections les plus pertinentes
            lorsque le contenu dépasse `maxCharacters`.
    ContentsResponse:
      type: object
      additionalProperties: false
      required:
        - requestId
        - results
        - statuses
      properties:
        requestId:
          type: string
          description: Identifiant unique de la requête.
        results:
          type: array
          items:
            $ref: '#/components/schemas/SearchResult'
          description: Résultats récupérés avec succès.
        statuses:
          type: array
          items:
            $ref: '#/components/schemas/ContentStatus'
          description: Statut de récupération de chaque élément demandé.
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: string
          description: Message d’erreur.
    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."
    ContentStatus:
      oneOf:
        - type: object
          additionalProperties: false
          required:
            - id
            - status
          properties:
            id:
              type: string
              description: Identifiant ou URL demandé.
            status:
              type: string
              enum:
                - success
              description: Statut de récupération.
        - type: object
          additionalProperties: false
          required:
            - id
            - status
            - error
          properties:
            id:
              type: string
              description: Identifiant ou URL demandé.
            status:
              type: string
              enum:
                - error
              description: Statut de récupération.
            error:
              type: object
              additionalProperties: false
              required:
                - tag
                - httpStatusCode
              properties:
                tag:
                  type: string
                  description: Catégorie d’erreur lisible par machine.
                httpStatusCode:
                  type: integer
                  nullable: true
                  description: Code de statut HTTP amont lorsqu’il est disponible.
  responses:
    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

- [Obtenir le contenu de la page](/docs/fr/api/assistant/get-page-content.md)
- [Vue d'ensemble des automatisations](/docs/fr/automations/index.md)
- [Analytique](/docs/fr/optimize/analytics.md)
