Bulk Generation

Bulk Generation erstellt mehrere Artikel in einem Rutsch aus einer Liste von Keywords — statt jeden Artikel einzeln anzulegen, trägst du bis zu 50 Keywords ein und jedes davon wird zu einem eigenen Artikel-Entwurf. Im Hintergrund läuft für jedes Keyword dieselbe Pipeline wie bei der Einzel-Artikel-Generierung: zuerst wird eine Gliederung (Storyline) erzeugt, danach Abschnitt für Abschnitt Text dazu geschrieben. Der Bulk selbst und jeder einzelne Artikel darin haben einen eigenen Status, den du live verfolgen kannst — schlägt ein Keyword fehl, laufen die übrigen trotzdem weiter.

Was es kann

• Bis zu 50 Keywords pro Bulk (keywords[], jeweils mind. 2 Zeichen) — jedes Keyword wird zu einem eigenen Artikel-Entwurf.
• Vollständig asynchron — läuft als Queue-Job im Hintergrund, du kannst die Seite verlassen, der Fortschritt wird aus der Datenbank nachgeladen.
• Zwei Status-Ebenen: der Bulk selbst (pending → processing → completed/failed) und jedes einzelne Item (pending → generating → completed/failed).
• Fehlertoleranz — ein fehlgeschlagenes Keyword blockiert die anderen nicht; der Bulk gilt als completed, sobald mindestens ein Artikel fertig wurde.
• Formular-Optionen (nur im UI, nicht über die REST-API): Wortanzahl, Stilprofil, Content-Ziel und Linkliste als Vorgaben für die Generierung.
• API-Optionen: Artikel-Typ (blog-post, guide, listicle) und Sprache (de, en, es, fr) direkt im Request.

Wann nutzen

• Du willst 10, 20 oder 30 Artikel zu verwandten Keywords produzieren, ohne jeden einzeln anzustoßen.
• Ein Site-Rollout oder eine neue Kategorie braucht auf einen Schlag mehrere Artikel-Entwürfe.
• Du hast eine fertige Keyword-Liste aus Keyword Explorer und willst sie direkt in Content verwandeln.
• Du brauchst keine vollautomatische Dauerlösung (dafür Automation), sondern einen einmaligen, kontrollierten Schub neuer Artikel.

Workflow

1. Bulk starten — POST /v1/bulk-generations mit {project_id, name, keywords: [...], type?, language?} → 202 mit {bulk_id, total_articles}. Rate-Limit: max. 10 Starts pro Minute.
2. Status abfragen — GET /v1/bulk-generations/{bulk} liefert den Bulk inklusive aller Items (Status, Keyword, Artikel-ID, verbrauchte Credits, Fehlermeldung).
3. Übersicht — GET /v1/bulk-generations?project_id=&status= listet alle Bulks des Teams, paginiert.
4. Fehler behandeln — Items mit status: failed liefern eine error_message; die übrigen Items im selben Bulk laufen unabhängig weiter.
5. Weiterverarbeiten — fertige Artikel (items[].article_id) landen als Entwurf im Projekt und können z. B. über Content Optimizer weiter geschärft werden.

API

Status-Werte Bulk: pending, processing, completed, failed. Status-Werte Item: pending, generating, completed, failed.

Beispiel:

POST /v1/bulk-generations
{
  "project_id": 42,
  "name": "Ratgeber-Serie August",
  "keywords": ["heizung entkalken", "boiler wartung", "durchlauferhitzer defekt"],
  "language": "de"
}

Credits & Limits

• 4 Credits pro Artikel (config/credits.php → bulk_generation_article), Gesamtpreis = Keyword-Anzahl × 4.
• Bei API-Start werden die Credits vollständig beim Anlegen des Bulks abgezogen; reicht das Guthaben nicht, antwortet der Endpoint mit 402 (insufficient_credits).
• Maximal 50 Keywords pro Bulk-Aufruf.
• Start ist auf 10 Anfragen pro Minute begrenzt.

Verwandte Module

• Keyword Explorer — die typische Quelle für die Keyword-Liste, die in den Bulk geht.
• Storylines — Bulk Generation nutzt intern dieselbe Gliederungs- und Abschnitts-Pipeline.
• Content Optimizer — der nächste Schritt, um fertige Bulk-Entwürfe zu schärfen.
• Automation — wenn du das nicht mehr manuell anstoßen willst, sondern dauerhaft automatisiert.