Spoo.me API implements rate limiting to ensure fair usage and maintain service quality for all users.

​
Current Rate Limits

The following rate limits apply to the URL shortening endpoints:

Per Minute

maximum 10 short URLs per IP

Per Hour

maximum 100 short URLs per IP

Per Day

maximum 500 short URLs per IP

​
Affected Endpoints

Rate limits apply to the following endpoints:

  • POST / - Shorten URLs
  • POST /emoji - Create emoji URLs

Statistics and export endpoints (/stats and /export) are not subject to the same rate limits.

​
Rate Limit Headers

When you make requests to rate-limited endpoints, the response will include headers indicating your current usage:

X-RateLimit-Limit: 10
X-RateLimit-Remaining: 4
X-RateLimit-Reset: 1640995200
Retry-After: 30

​
Handling Rate Limits

When you exceed the rate limit, you’ll receive a 429 Too Many Requests response:

{
  "error": "Rate limit exceeded",
  "message": "You have exceeded the rate limit. Please try again later.",
}

​
Best Practices

1

Implement Retry Logic

Build retry logic into your application to handle rate limit responses gracefully.

2

Monitor Usage

Keep track of your API usage to stay within limits.

3

Call API Client Side

If possible move the API call to the client side, instead of the server to use the client’s IP instead of the same server IP for every request

​
Need Higher Limits?

If you need higher rate limits for your application, please contact our support team at [email protected] with details about your use case.