API Rate Limits
Vivoldi maintains API rate limits based on your plan to ensure an optimal environment for all users.
Exceeding these limits will trigger an HTTP 429 (Too Many Requests) error. If you receive this response, please wait a moment before trying again.
API Rate Limits by Plan
The table below outlines the API request limits per minute and per hour for each subscription plan.
Available request volumes may vary depending on your service scale and traffic patterns, and rate limiting policies are applied to ensure stable and reliable API performance.
| Plan | Max per Minute | Max per Hour | Stats API / min | Stats API (Concurrent) |
|---|---|---|---|---|
| Free | 30 | 600 | 5% of base limit | — |
| Personal | 180 | 10,000 | 5% of base limit | 1 |
| Premium | 300 | 15,000 | 5% of base limit | 1 |
| Business | 480 | 25,000 | 5% of base limit | 2 |
| Business Plus | 768 | 40,000 | 5% of base limit | 2 |
| Enterprise | 1,200 | 60,000 | 5% of base limit | Contract-based (default: 3) |
How to Handle API Rate Limit Exceeded Errors
If the API rate limit is exceeded, the server returns an HTTP 429 (Too Many Requests) response.
To ensure stable and reliable service operation, we recommend implementing your request handling logic using the strategies below.
1. Implement Retry Logic (Retry with Backoff)
When a 429 response is received, wait for a short period before retrying the request.
Instead of repeatedly sending requests at short intervals, using an Exponential Backoff strategy is strongly recommended.
2. Optimize Request Frequency
If the same data is requested repeatedly, unnecessary API calls can be reduced by using caching mechanisms.
For high-volume operations, batch processing is generally more efficient than sending individual requests one by one.
3. Prepare for High-Volume API Usage
If your environment frequently approaches the API rate limit, consider upgrading to a higher plan or using Business Plus and Enterprise plans that support more flexible request limits.
Business Plus & Enterprise Flexible Limits
Business Plus and Enterprise plans use a flexible API scaling model where request limits automatically expand based on monthly link creation volume instead of relying on fixed limits.
This approach is ideal for marketing platforms, eCommerce services, and enterprise systems managing large volumes of links, providing the flexibility needed to handle high-traffic environments efficiently.
- Base Standard: 10,000 links per month
- To ensure service stability, the maximum scaling is capped at 3.5x the base limit.
Example (Enterprise Plan)
- 10,000 links/mo → 1,200 req/min / 60,000 req/hr
- 30,000 links/mo → 2,000 req/min / 100,000 req/hr
※ Webhook limits are 80% of the standard API limit.
※ Actual limits may vary based on contract terms. If you require higher capacity, please contact us.