Developer Guide
Rate Limits
Understanding API rate limits and how to handle them.
Overview
Catalogix enforces rate limits to ensure fair usage and platform stability. All limits apply per API key.
| Limit | Value |
|---|---|
| Requests per minute | 10 |
| Products per request | 100 items |
Rate Limit Response
When you exceed the limit, the API returns:
HTTP
HTTP 429 Too Many RequestsJSON
{
"status": {
"code": -1,
"message": "Too many requests. Please slow down and retry after a moment."
}
}Best Practices
- Batch requests — use bulk endpoints to send up to 100 products in a single call instead of one call per item.
- Implement retry logic — on a
429response, wait briefly before retrying. Use exponential backoff (e.g. 1s → 2s → 4s). - Cache store metadata — avoid repeated calls to store settings or ontology lookups by caching responses locally.
- Use pagination — use
offsetandlimitparameters to page through large result sets rather than fetching everything at once.
Something missing or unclear? Write to support@streamoid.com.