Reference

Rate limits & usage

Every response carries your remaining budget in headers, and each extraction reports what it cost.

Credits are difficulty-tier aware, so an open target costs less per record than a defended one. When you hit a limit you get 429 with a Retry-After.

X-RateLimit-Remaining: 4870
X-RateLimit-Reset: 1756500000
Retry-After: 12

Idempotency

Send an Idempotency-Key header on POST /v1/extractions so a retried request is never charged or run twice.

Idempotency-Key: a1b2c3d4-5e6f-7890