# Errors, Rate Limits & Credits

Requests are metered two ways - how fast you call, and how many credits you spend. Both are visible in your responses.

## Request rate

Requests are rate-limited per token, about **1 request per second**. Sending faster returns `429` with `rate limit exceeded`.

## Credits

Every search and segmentation request costs **1 credit** from your monthly quota:

- `requestsLeft` in every response shows your remaining balance (also in the `X-WebHose-Requests-Left` header).
- When the quota is exhausted, requests return `429` with `Too many requests: used X out of Y allowed in a month`.

## Error responses

| Status | When |
| --- | --- |
| `400` | Unknown `sort` or `order` value, or an invalid segmentation `field` |
| `401` | Missing or unknown token |
| `429` | Rate limit exceeded, monthly quota used up, account not activated, or trial ended |
| `500` | Internal error, including unbalanced quotes or parentheses in `q` |

> [!TIP]
> Need more credits? Contact **support@webz.io**.