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

# API REST de Mintlify Index

> Usa la API REST de Mintlify Index para buscar en la documentación y la web, reunir contexto con fuentes citadas y recuperar el contenido de páginas para aplicaciones y agentes.

Usa la API REST de Mintlify Index para recuperar conocimientos técnicos para aplicaciones y agentes. La API admite tres patrones de recuperación:

* [`context`](/docs/es/api/search-index/context) reúne contenido con fuentes citadas dentro de un presupuesto de tokens.
* [`search`](/docs/es/api/search-index/search) devuelve resultados clasificados de documentación y la web.
* [`contents`](/docs/es/api/search-index/contents) recupera contenido para los ID de resultados de Mintlify o las URL de resultados seleccionados.

<Info>
  La API REST requiere una clave de API para tu organización. El [servidor MCP de Index](/docs/es/search-index/mcp) público no requiere una clave de API.
</Info>

<div id="base-url">
  ## URL base
</div>

Envía las solicitudes a la API REST a:

```text theme={null}
https://leaves.mintlify.com/api/universal-search/v1
```

Añade una ruta de endpoint a esta URL base, por ejemplo `/context`, `/search` o `/contents`.

<div id="authentication">
  ## Autenticación
</div>

Autentica cada solicitud con una clave de API de Index en el encabezado `Authorization`:

```http theme={null}
Authorization: Bearer mint_us_...
```

Las claves de API de Index comienzan por `mint_us_`.

<Steps>
  <Step title="Crear una clave de API de Index">
    Abre la [página de claves de API](https://app.mintlify.com/settings/organization/api-keys) en tu dashboard y crea una clave de API de Index.

    Si este tipo de clave no está disponible, tu organización no tiene acceso a la API REST de Index.
  </Step>

  <Step title="Guardar la clave de forma segura">
    Guarda la clave en una variable de entorno del lado del servidor. Mintlify solo muestra la clave completa cuando la creas por primera vez. Guárdala de forma segura.

    ```bash theme={null}
    export MINTLIFY_INDEX_API_KEY="mint_us_..."
    ```

    <Warning>
      No expongas una clave de API de Index en código del lado del cliente ni la confirmes en el control de versiones.
    </Warning>
  </Step>

  <Step title="Crear contexto">
    Envía tu primera solicitud al endpoint `context`:

    ```bash theme={null}
    curl -X POST "https://leaves.mintlify.com/api/universal-search/v1/context" \
      -H "Authorization: Bearer $MINTLIFY_INDEX_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "query": "How should I configure caching in Next.js 16?",
        "product": "Next.js",
        "format": "txt",
        "tokenBudget": 3000
      }'
    ```

    Una respuesta correcta incluye el contexto reunido con las URL de las fuentes, el número de resultados utilizados y el recuento de tokens de salida.
  </Step>
</Steps>

<div id="rate-limits">
  ## Límites de uso
</div>

Los límites de la API REST se aplican por organización de Mintlify. Todas las claves de API de una organización comparten el mismo límite:

| Ventana     |            Límite |
| ----------- | ----------------: |
| Por segundo |    10 solicitudes |
| Por día     | 1.000 solicitudes |

Las solicitudes que superan cualquiera de los límites devuelven `429 Too Many Requests`. Usa un backoff exponencial antes de volver a intentarlo.

<div id="errors">
  ## Errores
</div>

| Estado | Significado                                                                                   |
| ------ | --------------------------------------------------------------------------------------------- |
| `400`  | El cuerpo de la solicitud no es válido.                                                       |
| `401`  | Falta la clave de API, no es válida o la organización no tiene acceso a la API REST de Index. |
| `403`  | La IP de la solicitud no está permitida por la clave de API.                                  |
| `429`  | La organización superó un límite de uso.                                                      |
| `500`  | Index no pudo completar la solicitud.                                                         |


## Related topics

- [Introducción a la API REST de Mintlify](/docs/es/api/introduction.md)
- [Conecta Mintlify Index a tu agente de programación](/docs/es/search-index/connect.md)
- [Servidor MCP de Mintlify Index](/docs/es/search-index/mcp.md)