Errors and Limits

Error shape

Errors are returned as JSON:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message"
  }
}

Common HTTP statuses

• 400 invalid input or malformed parameters
• 401 missing or invalid API key
• 404 unknown route or resource not found
• 405 method not allowed (keys are read-only, only GET exists)
• 429 rate limit exceeded
• 500 internal server error

Rate limiting

• 20 requests per 60 seconds and 1,000 requests per 24 hours.
• Deep pagination costs more: requests with offset >= 500 count as 2 requests, offset >= 2000 as 4.
• 429 responses include Retry-After.

Integration guidance

• Retry on 429 and 5xx with backoff and jitter.
• Cache responses where your use case allows.
• Deep offsets burn through your quota fast; don’t paginate further than you need.