How to call our APIs
Rate Limits
Bubblehouse has lifted all practical API rate limits.
We continue having undocumented safety rate limits to safeguard our platform, but those allow at least hundreds of requests per second.
Some requests like UpdateCustomersN, UpdateOrdersN allow sending batches of updates to us, and might take a while to process. For those:
We serialize such calls, so only one call can be in flight at a time, which will naturally limit the rate you can send those. (This has never been a problem in practice for anyone.)
We recommend limiting your batch size to 100-500 items.
The total request body size has a limit of 10 MB.
Safety API limits
Bubblehouse has safety limits set up to ensure the stability of our platform.
Normally, the safety limits are very high. We may lower them during exceptional events like DDoS attacks.
If you hit the limits, we’ll start returning HTTP 429 Too Many Requests errors.
Recommended strategy for you is to retry all 5xx and 429 errors with exponential backoff.