Rate Limits

To ensure fair usage and system stability, our API implements rate limiting. Different subscription plans have different rate limits.

Plan allowances

Your monthly allowance comes from your plan. It is one pooled allowance for every product, and every metered call counts once against it.

Free: 30,000 requests a month, about 1,000 a day on average, with no daily cap.

Paid plans: Starter 150,000, Pro 500,000 and Business 2,000,000 requests a month. Enterprise is unlimited.

Demo endpoint: The keyless demo endpoint allows about 100 requests a day per IP address and needs no signup.

GET /v1/demo/{ip}

Rate Limit Headers

All API responses include headers that provide information about your current rate limit status:

X-RateLimit-Limit: Maximum number of requests allowed in the current time window

X-RateLimit-Remaining: Number of requests remaining in the current time window

X-RateLimit-Reset: Time when the rate limit window resets (Unix timestamp)

Rate Limit Exceeded

If you exceed your rate limit, the API will return a 429 Too Many Requests response with the following body:

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "retryAfter": 60
}

Best Practices

Implement backoff: When you receive a rate limit error, implement exponential backoff before retrying.

Cache responses: Cache API responses when possible to reduce the number of requests.