Globale Limits

Brevo begrenzt API-Anfragen pro Endpunkt. Jedes Limit ist eine Anzahl von Anfragen pro Sekunde (RPS), pro Stunde (RPH) oder beides. Die folgenden Werte stammen von der Rate-Limits-Seite von Brevo, geprüft am 7. Oktober 2026. Prüfen Sie diese Seite, bevor Sie einen großen Job dimensionieren.

Ratenbegrenzungsstufen

Limits nach Stufe

Wenn ein Endpunkt sowohl ein RPS- als auch ein RPH-Limit hat, bleiben Sie unter beiden.

Rate-Limit-Header

Endpunkte mit Ratenbegrenzung liefern diese Header:

HTTP/1.1 200 OK
x-sib-ratelimit-limit: 1000
x-sib-ratelimit-remaining: 750
x-sib-ratelimit-reset: 1

Header-Beschreibungen

• x-sib-ratelimit-limit: im aktuellen Zeitfenster erlaubte Anfragen
• x-sib-ratelimit-remaining: im aktuellen Zeitfenster verbleibende Anfragen
• x-sib-ratelimit-reset: Zeit bis zum Zurücksetzen des Zeitfensters, meist in Sekunden

Brevo dokumentiert diese Header auf seiner Seite zu Rate-Limit-Headern.

Nutzung überwachen

Aktuelle Nutzung prüfen

const checkRateLimit = async () => {
  const response = await fetch('https://api.brevo.com/v3/account', {
    headers: { 'api-key': process.env.BREVO_API_KEY }
  });

  console.log({
    limit: response.headers.get('x-sib-ratelimit-limit'),
    remaining: response.headers.get('x-sib-ratelimit-remaining'),
    resetInSeconds: Number(response.headers.get('x-sib-ratelimit-reset'))
  });
};

Ratenbegrenzungen behandeln

Exponentielles Backoff

const makeRequestWithBackoff = async (url, options, maxRetries = 3) => {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status !== 429) return response;

    const resetSeconds = Number(response.headers.get('x-sib-ratelimit-reset') || 1);
    const delay = Math.max(resetSeconds * 1000, 1000 * Math.pow(2, i));

    console.log(`Rate limited. Waiting ${delay}ms before retry ${i + 1}`);
    await new Promise(resolve => setTimeout(resolve, delay));
  }
  throw new Error('Rate limit retries exhausted');
};

Wenn Sie ständig an Limits stoßen

1. Anfragen gleichmäßig verteilen: Ein Limit von 1.000 RPS erlaubt bis zu 60.000 Anfragen pro Minute nur dann, wenn sie gleichmäßig verteilt sind.
2. Bündeln und zwischenspeichern: Nutzen Sie Bulk-Endpunkte und vermeiden Sie es, Daten erneut zu lesen, die Sie bereits haben.
3. Webhooks für Statistiken nutzen: Empfangen Sie Events, statt Statistik-Endpunkte per Polling abzufragen.
4. Eine höhere Stufe erwägen: Die Advanced- und die Extended-Stufe gehören zu den Tarifen Professional und Enterprise.