API REST de Mintlify Index

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 reúne contenido con fuentes citadas dentro de un presupuesto de tokens.
search devuelve resultados clasificados de documentación y la web.
contents recupera contenido para los ID de resultados de Mintlify o las URL de resultados seleccionados.

La API REST requiere una clave de API para tu organización. El servidor MCP de Index público no requiere una clave de API.

URL base

Envía las solicitudes a la API REST a:

https://leaves.mintlify.com/api/universal-search/v1

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

Autenticación

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

Authorization: Bearer mint_us_...

Las claves de API de Index comienzan por mint_us_.

Crear una clave de API de Index

Abre la página de claves de API 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.

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.

export MINTLIFY_INDEX_API_KEY="mint_us_..."

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

Crear contexto

Envía tu primera solicitud al endpoint context:

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.

Límites de uso

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.

Errores

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.

Referencia de la API

Administración

Agente

assistant

Búsqueda

Mintlify Index

Analytics

Exportación estática

API REST de Mintlify Index

URL base

Autenticación

Límites de uso

Errores

​URL base

​Autenticación

​Límites de uso

​Errores

URL base

Autenticación

Límites de uso

Errores