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

# Obtener contenido de resultados

> Recupera contenido de Mintlify Index mediante el ID o la URL de un resultado después de buscar.



## OpenAPI

````yaml es/index-openapi.json POST /v1/contents
openapi: 3.0.1
info:
  title: API de Mintlify Index
  description: >-
    Busca y recupera documentación técnica y contexto web para aplicaciones y
    agentes.
  version: 1.0.0
servers:
  - url: https://leaves.mintlify.com/api/universal-search
security:
  - bearerAuth: []
paths:
  /v1/contents:
    post:
      summary: Obtener contenido de resultados
      description: >-
        Recupera contenido para los ID de resultados de Mintlify o las URL de
        resultados devueltos por el endpoint de búsqueda. Una solicitud puede
        incluir hasta 20 elementos entre ambos campos.
      operationId: getIndexContents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContentsRequest'
            example:
              ids:
                - nextjs:/docs/app/getting-started/caching-and-revalidating
              query: revalidar datos almacenados en caché
              maxCharacters: 12000
      responses:
        '200':
          description: >-
            La recuperación de contenido se completó. Comprueba cada estado para
            determinar si el elemento se procesó correctamente.
          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: Almacenamiento en caché y revalidación
                    text: >-
                      # Almacenamiento en caché y revalidación


                      Usa las API de revalidación para actualizar los datos
                      almacenados en caché.
                    truncated: false
                    totalCharacters: 78
                    score: 0
                    source: mintlify
                    siteName: nextjs
                    breadcrumbs:
                      - Enrutador de aplicaciones
                      - Primeros pasos
                    publishedDate: null
                statuses:
                  - id: nextjs:/docs/app/getting-started/caching-and-revalidating
                    status: success
        '400':
          description: El cuerpo de la solicitud no es válido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: >-
                  Una solicitud puede hacer referencia como máximo a 20
                  elementos entre urls e 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: >-
        Proporciona al menos un ID de resultado de Mintlify o una URL de
        resultado. Puedes combinar ambos campos, con un máximo total de 20
        elementos.
      anyOf:
        - required:
            - urls
        - required:
            - ids
      properties:
        urls:
          type: array
          minItems: 1
          maxItems: 20
          items:
            type: string
            format: uri
          description: >-
            URL de resultados que se recuperarán. Usa este campo para resultados
            web.
        ids:
          type: array
          minItems: 1
          maxItems: 20
          items:
            type: string
            minLength: 1
          description: ID de resultados de Mintlify que se recuperarán.
        maxCharacters:
          type: integer
          minimum: 1
          description: >-
            Número máximo de caracteres de contenido que se devolverán por
            resultado.
        query:
          type: string
          minLength: 1
          description: >-
            Consulta que se usará para seleccionar las secciones más relevantes
            cuando el contenido supere `maxCharacters`.
    ContentsResponse:
      type: object
      additionalProperties: false
      required:
        - requestId
        - results
        - statuses
      properties:
        requestId:
          type: string
          description: Identificador único de la solicitud.
        results:
          type: array
          items:
            $ref: '#/components/schemas/SearchResult'
          description: Resultados recuperados correctamente.
        statuses:
          type: array
          items:
            $ref: '#/components/schemas/ContentStatus'
          description: Estado de recuperación de cada elemento solicitado.
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: string
          description: Mensaje de error.
    SearchResult:
      type: object
      additionalProperties: false
      required:
        - id
        - url
        - title
        - text
        - score
        - source
        - siteName
        - breadcrumbs
        - publishedDate
      properties:
        id:
          type: string
          description: >-
            Identificador del resultado. Pasa los ID de resultados de Mintlify
            en el campo `ids` de la solicitud de contenido. Para resultados web,
            pasa la URL del resultado en `urls`.
        url:
          type: string
          format: uri
          description: URL canónica de la fuente.
        title:
          type: string
          description: Título de la fuente.
        text:
          type: string
          description: >-
            Contenido coincidente cuando se solicita. De lo contrario, una
            cadena vacía.
        truncated:
          type: boolean
          description: >-
            Indica si el contenido devuelto es más corto que el contenido
            disponible.
        totalCharacters:
          type: integer
          minimum: 0
          description: >-
            Número de caracteres disponibles antes del truncamiento. Está
            presente cuando está disponible.
        score:
          type: number
          description: >-
            Puntuación de relevancia relativa. Las respuestas de contenido usan
            `0` porque recuperan elementos seleccionados en lugar de clasificar
            resultados.
        source:
          type: string
          enum:
            - mintlify
            - web
          description: Fuente de recuperación.
        siteName:
          type: string
          description: Sitio de documentación o hostname web.
        breadcrumbs:
          type: array
          items:
            type: string
          description: Jerarquía de documentación del resultado.
        publishedDate:
          type: string
          nullable: true
          description: >-
            Fecha de publicación cuando la fuente proporciona una; de lo
            contrario, `null`. Los resultados de `search` la normalizan a una
            marca de tiempo ISO 8601 completa. Los resultados de `contents`
            recuperados mediante `urls` transmiten la cadena de fecha original
            de la fuente sin normalizarla, que puede ser una marca de tiempo
            completa o una cadena que solo contenga la fecha.
    ContentStatus:
      oneOf:
        - type: object
          additionalProperties: false
          required:
            - id
            - status
          properties:
            id:
              type: string
              description: ID o URL solicitados.
            status:
              type: string
              enum:
                - success
              description: Estado de recuperación.
        - type: object
          additionalProperties: false
          required:
            - id
            - status
            - error
          properties:
            id:
              type: string
              description: ID o URL solicitados.
            status:
              type: string
              enum:
                - error
              description: Estado de recuperación.
            error:
              type: object
              additionalProperties: false
              required:
                - tag
                - httpStatusCode
              properties:
                tag:
                  type: string
                  description: Categoría de error legible por máquinas.
                httpStatusCode:
                  type: integer
                  nullable: true
                  description: Código de estado HTTP del upstream cuando está disponible.
  responses:
    Unauthorized:
      description: >-
        Falta la clave de API, no es válida o la organización no tiene acceso a
        la API REST de Index.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: No autorizado
    Forbidden:
      description: La IP de la solicitud no está permitida por la clave de API.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: La dirección IP no está permitida para esta clave de API
    RateLimited:
      description: La organización superó un límite de uso.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Límite de uso superado. Vuelve a intentarlo más tarde
    InternalError:
      description: Index no pudo completar la solicitud.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Clave de API de Mintlify Index
      description: Clave de API de Mintlify Index con el prefijo `mint_us_`.

````

## Related topics

- [Obtener contenido de la página](/docs/es/api/assistant/get-page-content.md)
- [Vista general de automatizaciones](/docs/es/automations/index.md)
- [Mosaicos](/docs/es/components/tiles.md)
