Rate Limits

Rate Limits

XCROP uses a credit-based system to ensure fair usage and platform stability. Credits are consumed per API call based on the endpoint and result count. Monthly plan credits reset every 30 days, counted from your payment date; monthly plans last 30 days and do not auto-renew, and renewing early adds 30 days to your current expiry. Basic and Pro can also be bought yearly at 20% off ($47.04/yr and $95.04/yr): a yearly plan lasts 365 days and grants the whole year of credits at once (8.4M or 24M). Free Starter credits reset on the 1st of each calendar month. Per-minute rate limits apply based on your plan tier.

Plan Comparison

Rate Limit Headers

API responses include headers indicating your current rate limit status:

X-RateLimit-Limit: 60           # Per-minute request limit for your plan
X-RateLimit-Remaining: 58       # Per-minute requests remaining
X-Response-Time: 312ms          # Request latency
X-MaxResults-Allowed: 1000      # Max results per request (list endpoints)
X-Cache: MISS                   # Responses are never cached; every call fetches fresh data

429: Rate Limit Exceeded

{
  "error": "Rate limit exceeded — too many requests per minute",
  "code": "RATE_LIMIT_EXCEEDED"
}