> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streamoid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 theme={null}
HTTP 429 Too Many Requests
```

```json theme={null}
{
  "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 `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.