API Rate Limits
To ensure fair usage and maintain the quality of our service, the Trycolors API implements rate limiting. These limits vary depending on the endpoint and your subscription plan.
Current Rate Limits
We offer two tiers of rate limits: Free/Hobby and Business.
Hobby and PRO (individual) Plans
| API Endpoint | Rate Limit (requests/second) | Daily Limit (requests/day) |
|---|---|---|
| Mix Colors | 2 | 50 |
| Unmix Color | 1 | 10 |
| Similar Paints | 1 | 10 |
Business Plan (Tier 1)
| API Endpoint | Rate Limit (requests/second) | Daily Limit (requests/day) |
|---|---|---|
| Mix Colors | 10 | 2,000 |
| Unmix Color | 5 | 1,000 |
| Similar Paints | 5 | 1,000 |
Business plan limits can be increased upon request. Contact our support team if you need higher limits.
Understanding Rate Limits
- Rate Limit (requests/second): This is the maximum number of requests you can make to an endpoint per second.
- Daily Limit (requests/day): This is the total number of requests you can make to an endpoint in a 24-hour period.
Handling Rate Limit Errors
If you exceed the rate limit, the API will return a 429 (Too Many Requests) status code. When this occurs, you should:
- Pause your requests for a short period.
- Implement exponential backoff in your application to automatically handle rate limiting.
Best Practices
To make the most of your rate limits:
- Cache responses when possible to reduce unnecessary API calls.
- Implement retry logic with exponential backoff for failed requests.
- Spread out your API calls evenly over time rather than sending them in bursts.
- Monitor your usage to ensure you're staying within your plan's limits.
Upgrading Your Plan
If you find that you're consistently hitting your rate limits, consider upgrading to a Business plan for higher limits. If you're already on a Business plan and need even higher limits, please contact our support team to discuss custom solutions.
Remember, efficient use of the API not only helps you stay within rate limits but also improves the performance of your application.
For any questions about rate limits or to request a limit increase, please contact our support team (opens in a new tab).