Rate Limits

Limits by tier

The free tier window resets every minute. The Pro daily limit resets at 00:00 UTC.

Rate limit headers

Every API response includes headers so you can track your usage:

Enterprise keys do not include X-RateLimit-* headers (no limit to track).

Handling 429 responses

When you hit the limit, the API returns HTTP 429 with a JSON error body:

{
  "error": "Rate limit exceeded. Max 100 requests per minute."
}

For free tier (per-minute): wait until the next minute boundary (X-RateLimit-Reset).

For Pro tier (per-day): limit resets at 00:00 UTC, or upgrade to Enterprise for unlimited access.

Retry logic

async function fetchWithRetry(url: string, key?: string) {
  const headers = key ? { Authorization: `Bearer ${key}` } : {};
  const res = await fetch(url, { headers });

  if (res.status === 429) {
    const reset = res.headers.get('X-RateLimit-Reset');
    const wait = reset
      ? Math.max(0, new Date(reset).getTime() - Date.now())
      : 60_000;
    await new Promise(r => setTimeout(r, wait + 100));
    return fetch(url, { headers });
  }

  return res;
}

Tips for staying under limits

• Cache responses on your side. Tool scores update once daily — caching for 1 hour loses nothing.
• Use the batch endpoint (POST /api/v2/batch) to fetch up to 50 tools in one request instead of 50 separate calls. Pro only.
• Use limit and offset for pagination rather than fetching everything at once.
• If you're building an integration that will exceed 10,000 req/day, contact us about Enterprise pricing.