Rate limits
Every plan has a per-minute and per-day cap. Limits are enforced per API key.
Default limits
| Plan | Req / min | Req / day | Concurrent |
|---|---|---|---|
| Test | 30 | 500 | 2 |
| Starter | 60 | 5,000 | 4 |
| Growth | 300 | 50,000 | 10 |
| Scale | 1,200 | 500,000 | 25 |
Response headers
Every response includes the remaining quota so you can back off before hitting the limit:
httphttp
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 274
X-RateLimit-Reset: 1717689600Handling 429
When you exceed a limit the API returns HTTP 429 with a Retry-After header (seconds). Sleep for that duration, then retry with jitter to avoid thundering-herd behaviour.
jsonjson
{
"error": "rate limit exceeded — retry in 12s",
"request_id": "..."
}Credits vs rate limits
Rate limits control how often you can call the API. Credits control how much data you can pull. Each endpoint page documents its credit cost.