Guide
Rate Limits
Per-tier daily request limits and how to handle 429 responses.
Per-tier limits
| Tier | Requests per day |
|---|---|
| Free | 100 |
| Startup | 1,000 |
| Growth | 10,000 |
| Enterprise | 100,000 |
Limits apply per API key, per UTC day. They reset at 00:00 UTC.
Response headers
Every response (including 429) includes:
X-RateLimit-Limit: <daily quota>
X-RateLimit-Remaining: <requests left today>
X-RateLimit-Reset: <ISO-8601 timestamp of next reset>Read these headers to pace your requests and avoid surprises.
Handling 429
When you hit the limit, the API responds with 429 RATE_LIMIT_EXCEEDED. The response body contains a reset_at ISO-8601 timestamp — wait until that time, not for a fixed Retry-After interval.
The simplest backoff strategy: sleep until X-RateLimit-Reset, then retry. Don't spin-retry — 429s don't decrement on the client side.