Mintlify Index REST API

使用 Mintlify Index REST API 为应用和代理检索技术知识。该 API 支持三种检索模式：

• context 在 token 预算内组装带有来源引用的内容。
• search 返回排名后的文档和 Web 结果。
• contents 获取所选 Mintlify 结果 ID 或结果 URL 对应的内容。

向以下地址发送 REST API 请求：

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

在此基础 URL 后追加端点路径，例如 /context、/search 或 /contents。

在 Authorization 请求头中使用 Index API key 对每个请求进行认证：

Authorization: Bearer mint_us_...

Index API key 以 mint_us_ 开头。

export MINTLIFY_INDEX_API_KEY="mint_us_..."

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
  }'

REST API 限制按 Mintlify 组织计算。一个组织中的所有 API key 共享同一限制：

超过任一限制的请求会返回 429 Too Many Requests。重试前请使用指数退避。