Rate Limits

Rate limits protect the API from excessive usage and ensure fair access for all consumers.

Current Limits

EndpointLimit
POST /api/v1/search/query60 requests / minute
Other endpointsVaries by endpoint

Limits are enforced per IP address.

Response Headers

Every response includes rate limit headers so you can track your usage:

X-RateLimit-Limit — Maximum requests allowed per window.

X-RateLimit-Remaining — Requests remaining in the current window.

X-RateLimit-Reset — Unix timestamp when the window resets.

Exceeding the Limit

When you exceed the rate limit, the API returns 429 Too Many Requests with a Retry-After header:

Best Practices

  • Respect Retry-After — wait the indicated time before retrying.
  • Use exponential backoff — on repeated 429s, double your wait time between retries.
  • Cache results — avoid redundant requests for the same query.
  • Monitor your usage — check X-RateLimit-Remaining to proactively throttle before hitting limits.