Getting started

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.