Rate Limits

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

When you exceed the limit, the API returns:

HTTP 429 Too Many Requests

{
  "status": {
    "code": -1,
    "message": "Too many requests. Please slow down and retry after a moment."
  }
}

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 429 response, 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 offset and limit parameters to page through large result sets rather than fetching everything at once.