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

# Buscar conocimientos técnicos

> Busca en Mintlify Index documentación técnica y resultados web clasificados.



## OpenAPI

````yaml es/index-openapi.json POST /v1/search
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/search:
    post:
      summary: Buscar conocimientos técnicos
      description: >-
        Devuelve resultados clasificados de documentación mantenida por sus
        editores o de la web. Usa los ID de resultados de Mintlify o cualquier
        URL de resultado con el endpoint de contenido cuando necesites más
        contenido.
      operationId: searchIndex
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
            example:
              query: Almacenamiento en caché y revalidación en Next.js 16
              numResults: 5
              text:
                maxCharacters: 4000
              includeDomains:
                - nextjs.org
      responses:
        '200':
          description: La búsqueda se completó correctamente.
          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: Almacenamiento en caché y revalidación
                    text: >-
                      El almacenamiento en caché es una técnica para guardar el
                      resultado de la obtención de datos y otros cálculos.
                    truncated: false
                    totalCharacters: 92
                    score: 0.91
                    source: mintlify
                    siteName: nextjs
                    breadcrumbs:
                      - Enrutador de aplicaciones
                      - Primeros pasos
                    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: Consulta de búsqueda.
        numResults:
          type: integer
          minimum: 1
          maximum: 20
          description: Número máximo de resultados que se devolverán.
        text:
          default: false
          description: >-
            Controla el contenido de los resultados. Establécelo en `true` para
            incluir contenido coincidente, en `false` para omitirlo o
            proporciona `maxCharacters` para incluir contenido truncado. Si se
            omite, el valor predeterminado es `false`.
          oneOf:
            - type: boolean
            - type: object
              additionalProperties: false
              required:
                - maxCharacters
              properties:
                maxCharacters:
                  type: integer
                  minimum: 1
                  description: >-
                    Número máximo de caracteres de contenido que se incluirán
                    por resultado.
        includeDomains:
          type: array
          minItems: 1
          items:
            type: string
            minLength: 1
          description: Dominios que se incluirán en los resultados de búsqueda.
        excludeDomains:
          type: array
          minItems: 1
          items:
            type: string
            minLength: 1
          description: Dominios que se excluirán de los resultados de búsqueda.
    SearchResponse:
      type: object
      additionalProperties: false
      required:
        - requestId
        - results
      properties:
        requestId:
          type: string
          description: Identificador único de la solicitud.
        results:
          type: array
          items:
            $ref: '#/components/schemas/SearchResult'
          description: Resultados de búsqueda clasificados.
    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.
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: string
          description: Mensaje de error.
  responses:
    BadRequest:
      description: El cuerpo de la solicitud no es válido.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Cuerpo de solicitud no válido
    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

- [Tooltips](/docs/es/components/tooltips.md)
- [Guías](/docs/es/guides/index.md)
- [Crear una base de conocimientos](/docs/es/guides/knowledge-base.md)
