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

# Rate Limits

> Request rate, daily search cap, and what happens when you hit them.

Each API key can make 15 requests per second. Searches also count against a daily cap.

## Request rate

Every MCP message and every REST call counts toward the 15 requests per second limit. This includes tool calls, health checks, and search — not only searches.

When you exceed 15 per second, the response is HTTP 429 with:

* A `Retry-After` header (seconds)
* Error code `rate_limited`
* `retry_after_seconds` in the body

```json theme={null}
{
  "error": {
    "code": "rate_limited",
    "message": "Too many searches from this address. Retry after the hint.",
    "retry_after_seconds": 1
  }
}
```

The same shape is returned on both MCP and REST.

## Daily search cap

`search_catalog` counts against a per-key daily allowance. The cap resets at UTC midnight.

When the cap is hit, the response includes:

| Field (MCP) | Field (REST) | Meaning |
| - | - | - |
| `used_today` | `usedToday` | Searches used today |
| `daily_cap` | `dailyCap` | The key's daily limit |

```json theme={null}
{
  "error": {
    "code": "daily_limit_reached",
    "message": "Today's search allowance is used. Retry after the hint.",
    "retry_after_seconds": 3600,
    "used_today": 100,
    "daily_cap": 100
  }
}
```

### What counts as a search

Only successful `search_catalog` calls consume the allowance. These do not count:

* Failed searches with `invalid_key`, `unauthorized`, `invalid_arguments`, `rate_limited`, or `daily_limit_reached`
* All non-search tools: `get_product`, `create_cart`, `update_cart`, `create_checkout`, `complete_checkout`, and every other tool

### What doesn't count

Cart, checkout, sign-in, and order operations never consume the search cap. Only `search_catalog` does.

## Increasing limits

Need a higher request rate or search cap? Reply to your welcome email.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.