Skip to main content

Rate Limits

Seaavey API enforces rate limits to ensure fair usage and service stability for all users.

Current Limits

Requests per minute 60
Requests per hour 500
Requests per day 5,000

Rate Limit Headers

Every response includes headers showing your current usage:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1715200000
X-RateLimit-Limit

Maximum requests allowed in the current window

X-RateLimit-Remaining

Requests remaining in the current window

X-RateLimit-Reset

Unix timestamp when the rate limit resets

Exceeding Limits

When you exceed the rate limit, you'll receive a 429 response:

{
  "status": 429,
  "success": false,
  "message": "Too many requests"
}

Best Practices

  • Cache responses when possible to reduce API calls
  • Implement exponential backoff on 429 responses
  • Monitor the X-RateLimit-Remaining header
  • Spread requests evenly instead of bursting
  • Use webhooks or polling intervals instead of rapid-fire requests

Endpoint-Specific Limits

Some endpoints have stricter limits due to upstream dependencies:

Tools (upscale, removebg) 10/min

Heavy processing endpoints

Downloader 30/min

Media extraction endpoints

Search 60/min

Standard rate