Getting started

Rate limits

Every scope has its own per-minute ceiling. When you hit the limit we return 429 with a Retry-After header in seconds.

Endpoint	LeadLeap	Hunter	Everyone else
Search leads `leads:read`	300 req/min	500 req/min (non-API)	undisclosed
Validate email `email:validate`	600 req/min	300 req/min	undisclosed
Enrich lead `leads:enrich`	120 req/min	n/a	undisclosed
All endpoints combined `global`	1200 req/min	15 req/sec	undisclosed
Limits published?	Yes — every one	Yes	No

Headers on every response

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1764009600
X-RateLimit-Scope: leads:read
X-RateLimit-Plan: beta

What happens when you exceed

HTTP 429 Too Many Requests
Retry-After: 37

{
  "data": null,
  "meta": { "request_id": "req_...", "timestamp": "..." },
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded for 'leads:read'. Retry in 37s.",
    "retry_after": 37
  }
}

Need a higher limit? Once self-serve billing lands, higher tiers auto-grant higher caps. During the developer preview, write to the founder and we'll bump your key if your use case is legit.