Rate Limits¶

API requests are rate-limited based on your subscription plan. Limits are enforced per API key, per toolkit.

How Limits Work¶

Rate limits are applied using a sliding window. When you exceed your limit, the API returns a 429 Too Many Requests response:

{
  "detail": "Rate limit exceeded. Please try again later."
}

Rate Limit Headers¶

Every response includes headers to help you track your usage:

Typical Limits by Plan¶

Handling Rate Limits¶

Best practices for dealing with rate limits in production:

import httpx
import time

def call_api(url, payload, api_key, max_retries=3):
    """Call an API endpoint with exponential backoff on rate limits."""
    for attempt in range(max_retries):
        r = httpx.post(
            url,
            headers={"X-API-Key": api_key},
            json=payload,
        )
        if r.status_code == 429:
            wait = 2 ** attempt
            time.sleep(wait)
            continue
        r.raise_for_status()
        return r.json()
    raise Exception("Rate limit exceeded after retries")