# Rate Limits & Errors

> [!WARNING]
> The Web Content API is **deprecated**. Use the [News, Blogs & Forums APIs](news-blogs-forums-overview) instead - same content, one endpoint per content type, and where new features land.

## Result size

- Up to `100` posts per response (`size`, default `100`).
- Use [Pagination](web-content-pagination) to retrieve more.

## Request rate

Requests are rate-limited per token to about **1 request per second** by default. Sending faster returns:

```
429 rate limit exceeded
```

Pace your calls (roughly one per second) and follow [Pagination](web-content-pagination) to collect large result sets.

## Credits

Each call consumes credits. A query over recent data costs 1 credit; querying further back costs more - see [Time Range & News History](web-content-time-range). `requestsLeft` in every response shows how many credits remain.

## Monthly quota

Each plan includes a monthly credit allowance. When it is used up:

```
429 Too many requests: used X out of Y allowed in a month
```

## Query limits

- Proximity (`~N`) operators are capped at **10** per query.
- Leading wildcards are removed; quotes and parentheses must be balanced. See [Query Syntax](web-content-query-syntax).

## Error responses

| Status | Meaning |
| --- | --- |
| `400` | Invalid query, invalid `sort` / `order` value, or more than 10 proximity (`~N`) operators. |
| `401` | Missing or unknown token. |
| `402` | Not enough API calls available. |
| `403` | No permission for a requested premium source type. |
| `429` | Rate limit exceeded (too fast) or monthly quota reached. |
| `500` | Internal error - retry, then contact support. |

> [!TIP]
> Need higher limits or access to premium sources? Contact **support@webz.io**.