Limits
Detecting throttling
A throttled request returns HTTP429 with body:
retry_after is in seconds. Wait that long, then retry.
Guides
Rate Limits
How requests are throttled and how to back off.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
How requests are throttled and how to back off.
| Limit | Value |
|---|---|
| Requests / minute / key | 100 |
| Batch size | 10 ids per /disks/batch call |
| Search query length | First 1000 characters are embedded |
| Search result count | Up to 25 sections |
| List page size | Up to 100 disks |
429 with body:
{
"error": "rate_limit_exceeded",
"retry_after": 42
}
retry_after is in seconds. Wait that long, then retry.
async function fetchWithBackoff(url, opts, attempt = 0) {
const r = await fetch(url, opts)
if (r.status !== 429) return r
const { retry_after = 60 } = await r.json().catch(() => ({}))
if (attempt >= 3) throw new Error('rate_limited')
const wait = (retry_after + Math.random() * 5) * 1000
await new Promise(res => setTimeout(res, wait))
return fetchWithBackoff(url, opts, attempt + 1)
}