# API REST de Mintlify Index (/es/api/search-index/introduction)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 888 · updated: 2026-09-23 -->
Related: [Crear contexto de implementación](/es/api/search-index/context.md), [Buscar conocimientos técnicos](/es/api/search-index/search.md), [Obtener contenido de resultados](/es/api/search-index/contents.md), [Obtener contenido de la página](/es/api/assistant/get-page-content.md)

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`](/es/api/search-index/context) reúne contenido con fuentes citadas dentro de un presupuesto de tokens.
* [`search`](/es/api/search-index/search) devuelve resultados clasificados de documentación y la web.
* [`contents`](/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](/es/search-index/mcp) público no requiere una clave de API.
</Info>

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

Envía las solicitudes a la API REST a:

```text
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 [#autenticación]
</div>

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

```http
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.
  </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
    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
    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 [#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 [#errores]
</div>

| Estado | Significado                                                  |
| ------ | ------------------------------------------------------------ |
| `400`  | El cuerpo de la solicitud no es válido.                      |
| `401`  | Falta la clave de API o no es válida.                        |
| `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.                        |