Rate Limiting

API requests are subject to two types of rate limiting:

Per-Minute Rate Limit

• 100 requests per 60-second window (fixed window)

• Applies to API key requests only (OAuth developer apps are not rate-limited per-minute)

• Response headers on every request:

  • X-RateLimit-Limit: Maximum requests allowed (100)

  • X-RateLimit-Remaining: Requests remaining in current window

  • X-RateLimit-Reset: Unix timestamp when the window resets

Monthly Request Quota

Monthly limits are based on your Spiffy subscription plan:

Plan	Monthly Limit
Pro	10,000
Scale	50,000
High Volume	200,000

• Response headers on every request:

  • X-Monthly-RateLimit-Limit: Your monthly quota

  • X-Monthly-RateLimit-Remaining: Requests remaining this month

  • X-Monthly-RateLimit-Reset: Unix timestamp for the first of next month (UTC)

• An email warning is sent when usage reaches 80% of the monthly limit.

When either limit is exceeded, the API returns 429 Too Many Requests:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests"
  }
}