> For the complete documentation index, see [llms.txt](https://docs.tyrads.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tyrads.com/publishers-integrations/publisher-api/rate-limiting.md).

# Rate Limiting

To ensure fair use and maintain stability, our API enforces a strict rate limit on all requests made using a valid **API Key**.

***

#### ⏱ Limit Details

| Parameter              | Value                   |
| ---------------------- | ----------------------- |
| Request Limit          | **1 request**           |
| Time Window            | **Every 1 minute**      |
| Status on Limit Exceed | `429 Too Many Requests` |

You must wait 5 minutes between requests. If another request is made before the window resets, it will be rejected.

***

#### 🔁 Response When Rate Limit Is Exceeded

When you exceed the allowed rate, the API will return a **429** error along with guidance on when you can retry:

**Example Response:**

```json
{
  "message": "Rate limit exceeded. Please try again in 278 seconds."
}
```

**Response Headers:**

| Header                  | Description                                    |
| ----------------------- | ---------------------------------------------- |
| `Retry-After`           | Number of seconds to wait before retrying      |
| `X-RateLimit-Limit`     | Total allowed requests per window (`1`)        |
| `X-RateLimit-Remaining` | Remaining requests in the current window (`0`) |
| `X-RateLimit-Reset`     | UNIX timestamp when the limit resets           |

***