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

# Rate Limits

> Webacy API rate limits and monthly quotas by Demo, Production, and Enterprise tier, including requests per second and burst capacity guidelines.

## Rate Limit Tiers

<Note>
  **Need higher limits?** Production and enterprise tiers offer significantly increased rate limits. Contact us at [info@webacy.com](mailto:info@webacy.com) to upgrade your plan.
</Note>

| Tier       | Requests/sec | Burst Capacity | Monthly Quota |
| ---------- | ------------ | -------------- | ------------- |
| Demo       | 2            | 5 requests     | 2,000         |
| Production | 10           | 20 requests    | 100,000       |
| Enterprise | Custom       | Custom         | Unlimited     |

### Demo Tier

For demo API keys, the following restrictions apply:

| Limit Type          | Value          |
| ------------------- | -------------- |
| Requests per second | 2              |
| Burst capacity      | 5 requests     |
| Monthly quota       | 2,000 requests |

### Production Tier

Production API keys provide increased limits suitable for live applications:

| Limit Type          | Value            |
| ------------------- | ---------------- |
| Requests per second | 10               |
| Burst capacity      | 20 requests      |
| Monthly quota       | 100,000 requests |

### Enterprise Tier

Enterprise customers receive fully customizable limits:

* **Requests per second**: Up to 100+ (custom)
* **Monthly quota**: Unlimited
* **Dedicated support**: Priority response times
* **SLA**: 99.9% uptime guarantee

## Rate Limit Headers

The API returns rate limit information in response headers:

| Header                  | Description                          |
| ----------------------- | ------------------------------------ |
| `X-RateLimit-Limit`     | Maximum requests allowed             |
| `X-RateLimit-Remaining` | Requests remaining in current window |
| `X-RateLimit-Reset`     | Unix timestamp when the limit resets |

## Handling Rate Limits

When you exceed the rate limit, the API returns a `429 Too Many Requests` response:

```json theme={null}
{
  "message": "Rate limit exceeded"
}
```

### Best Practices

<Tip>
  Implement exponential backoff when you receive a 429 response.
</Tip>

* **Cache responses** - Avoid redundant API calls for the same data
* **Batch requests** - Use batch endpoints where available
* **Monitor usage** - Use the [API Usage](/api-reference/api-usage/get-current-api-usage) endpoint to track consumption
* **Implement queuing** - Queue requests during high-traffic periods

## Increasing Your Limits

When your integration is production-ready and you need higher limits:

1. **Developer Portal** - Upgrade at [developers.webacy.co](https://developers.webacy.co/)
2. **Account Manager** - Contact your account manager for enterprise plans
3. **Support** - Email [info@webacy.com](mailto:info@webacy.com)

## Enterprise Plans

Enterprise customers receive:

* Higher requests per second limits
* Increased monthly quotas
* Priority support
* Custom rate limit configurations