Operations

Rate Limits

Fair use limits, how to read your usage, and what happens when you reach a ceiling.

Limits

Standard subscriptions include 120 requests per minute and 500,000 rows per day, capped at 10,000 rows per response. Trial and test keys get 30 requests per minute and 50,000 rows per day, capped at 1,000 rows per response.

Limit	Standard	Trial / Test Keys
Requests per minute	`120`	`30`
Rows per day	`500,000`	`50,000`
Max rows per response	`10,000`	`1,000`

The per-minute request window is counted per key, but the daily row quota is counted per account across every key you hold. Issuing more keys does not raise the ceiling.

Usage Headers

Every response carries your current quota, so you never have to guess. Read these headers to pace your requests:

response headershttp

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1785634800

You can also check your account usage for the same numbers plus your daily row totals by dataset.

When You Reach a Limit

Past the limit, the API returns 429 Too Many Requests with a Retry-After header (error code rate_limited for the per-minute window, quota_exceeded for the daily row quota). Back off for that many seconds, then retry. A short exponential backoff keeps well behaved clients healthy under load.

Consistently near the ceiling? Higher volume plans are available by arrangement. Start on the pricing page or talk to sales.