Rate limits

Three per-key tiers: free 60, pro 300, enterprise 6000 requests / minute. Sliding-window enforcement. Your tier is on the X-RateLimit-Tier header of every response and on /whoami.

Tier table

Response headers

Every response carries:

• X-RateLimit-Limit: your tier's per-minute ceiling (60 / 300 / 6000).
• X-RateLimit-Remaining: calls left in the current 60-second window.
• X-RateLimit-Tier: free, pro, or enterprise.

On 429 responses, additionally:

• Retry-After: seconds to wait before retrying.

Check your limit any time

Your current limit and remaining quota ride on the response headers of every authenticated call. Use -i (or -D -) on any cheap endpoint and read the X-RateLimit-* headers:

curl -i -H "Authorization: Bearer $BRUBRU_API_KEY" \
  "https://brubru.beresol.eu/api/v2/proprietary/guides?limit=1"

# HTTP/1.1 200 OK
# X-RateLimit-Tier: enterprise
# X-RateLimit-Limit: 6000
# X-RateLimit-Remaining: 5998

When you hit the limit

You get a 429 rate_limited response. The right behaviour is:

1. Read Retry-After.
2. Sleep that many seconds.
3. Retry the same request.

import time, httpx

def call_with_backoff(url, headers):
    for attempt in range(5):
        r = httpx.get(url, headers=headers)
        if r.status_code != 429:
            return r
        wait = int(r.headers.get("Retry-After", 60))
        time.sleep(wait)
    r.raise_for_status()

Good citizenship

• Cache aggressively. Our data refreshes daily for most endpoints. Don't poll faster than you need.
• Batch filters. Ask for limit=100 once instead of 10 calls with limit=10.
• Use If-None-Match when we expose ETags (June 2026 roadmap).
• Monitor Newman runs. In CI, set newman run --delay-request 1000 to pace calls.

Need higher limits?

Email hello@beresol.eu with your use case. pro upgrades are usually approved within 24h for production integrations. enterprise is a custom contract for partner integrations: bundling resale rights, SLA, and the 6,000 req/min ceiling.

Next

Head to Endpoints for the full reference of all 82 routes across 36 folders.