Rate Limits
Rate limits are applied to our API to ensure fair usage and prevent abuse. Different limits apply depending on the authentication method used and the plan selected by the user.
API KEY and Bearer Token Users
Rate limits for API KEY and bearer token users are determined by the sales plan chosen. The following limits apply:
- Free Plan: 10 calls per day.
- Standard Plan: 300 calls per day.
- Premium Plan: 15,000 calls per day.
- Business Plan: 50,000 calls per day.
- Enterprise Plan: Custom limits, agreed per contract.
The daily allowance is shared by the whole account: every user, every API key and every PromoSync store draw on the same count. Sub-accounts draw on their parent account’s allowance. The count resets at 00:00 UTC.
API Boosts
Need more calls on a busy day, for a catalog import, a price sync or a seasonal peak? API Boosts are prepaid packs of extra calls for the Standard, Premium and Business plans. You buy them from Account Settings in the dashboard and pay on Stripe’s secure checkout page. The calls usually start working within a couple of minutes of paying.
| Pack | Price | Per 1,000 calls |
|---|---|---|
| 5,000 calls | $39 | $7.80 |
| 25,000 calls | $99 | $3.96 |
| 100,000 calls | $249 | $2.49 |
How a Boost works:
- It is a pool of calls for your whole account. It is used only after the day’s plan allowance is gone; your daily limit itself does not change, and the next day starts with the plan allowance again.
- Packs are valid for 12 months from purchase. Unused calls expire; they are not refunded.
- You can hold up to two active packs at a time. The pack expiring first is used first.
- A Boost adds calls, not features. Your plan’s feature set and user limit stay the same.
- Free, Trial and Enterprise accounts cannot buy Boosts. Enterprise capacity is agreed per contract.
- Account Settings shows each pack with its remaining calls, purchase date and expiry date, and the combined balance.
When both the daily allowance and your packs are used up, calls get a 429 Too Many Requests response until 00:00 UTC, or until you add another pack.
Important Notes
- Rate Limit Headers: Each response from the API includes headers (
X-RateLimit-Limit,X-RateLimit-Remaining) that provide information about the current rate limit status for your request. - Exceeding Rate Limits: If you exceed the rate limits, a
429 Too Many Requestsstatus code will be returned. You must wait until the rate limit window resets to make additional calls, or add an API Boost pack if your plan allows it. - Upgrading Plans: If your needs exceed the rate limits of your current plan most days, consider upgrading to a higher plan through your user dashboard. The change will take effect immediately. If you only need more calls now and then, an API Boost is usually the cheaper option.
- Burst Behavior: Please note that rate limits are enforced per day. Any unused calls do not roll over to the next day.
Considerations for Implementation
- Caching: Consider caching results locally to minimize the number of calls and stay within the rate limits.
- Monitoring: Implement monitoring on your side to keep track of the number of calls made and prevent unexpected rate limit issues.
- Handle 429s gracefully: Pause and retry after 00:00 UTC instead of failing a whole job. If you run imports or price syncs, plan them around your daily allowance or buy a Boost before you start.
- Selecting the Right Plan: Choose the plan that best fits your needs, taking into consideration the rate limits and the nature of your application.
By adhering to these rate limits, you contribute to a fair and stable environment for all users of our API.