Rate limits
The API is rate-limited per key and per source IP. Limits are generous for normal use, including bulk imports run at a steady pace.
Limits#
- 120 requests / minute per API key.
- 600 requests / minute per source IP.
Exceeding either returns 429 rate_limited with a suggested wait in the response body:
{
"code": "rate_limited",
"message": "Rate limit exceeded",
"details": { "retryAfterMs": 60000 }
}Handling 429s#
Back off and retry after details.retryAfterMs. For large imports, run requests sequentially (or with small concurrency) and use idempotency keys so a retry never double-creates a record.