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

# Rate Limits

> Request limits by plan

Rate limits are enforced per API key based on your subscription plan.

## Limits by plan

| Plan | Requests       | Window     |
| ---- | -------------- | ---------- |
| Free | 100 requests   | 10 seconds |
| Pro  | 1,000 requests | 10 seconds |

## Rate limit headers

When you receive a `429` response, the following headers are included:

| Header                  | Description                      |
| ----------------------- | -------------------------------- |
| `X-RateLimit-Limit`     | Maximum requests in the window   |
| `X-RateLimit-Remaining` | Requests remaining in the window |
| `Retry-After`           | Seconds to wait before retrying  |

## Example rate-limited response

```http theme={null}
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
Retry-After: 1

{
  "error": "Rate limit exceeded"
}
```

## Usage tracking

Your monthly API usage is tracked per account. View your current usage in the [dashboard](https://companies.social/dashboard).